Support SUPPORT
New to T-Mobile? Switching is easy Set up your device Using the app All get started topics Ways to pay your bill All about your bill Line permissions Your T-Mobile ID Your PIN/Passcode All account resources topics T-Mobile network In-flight texting and Wi-Fi Wi-Fi Calling International roaming Mobile Without Borders All network & roaming topics Find the right plan Netflix on Us HotSpot plans Voicemail Use Mobile HotSpot All plans support topics Tutorials Troubleshooting Unlock your device Protect your device SIM card & eSIM All device assistance topics Get T-Mobile for Business Billing and payments Manage your account Orders and shopping Account Hub registration All business support topics

The T-Mobile Prepaid eSIM app lets you activate new T-Mobile prepaid service on an iPhone or Android with eSIM. For other devices, check the compatibility to bring your device to T-Mobile Prepaid

Looking for Prepaid plans and devices? Visit the T-Mobile Prepaid website.

About the app

The Prepaid eSIM app was built for travelers coming to the U.S., existing T-Mobile customers who want a secondary pre-paid line, and anyone who wants to take the Un-carrier out for a test drive to try out America’s fastest 5G network.*

  • The app can only activate a T-Mobile prepaid line.
  • For postpaid accounts, check out T-Mobile eSIM.
  • Only available for iPhone or Android devices with eSIM.
  • The app requires:
    • You have a data connection, through either Wi-Fi or Cellular.
    • You either purchased the device from T-Mobile, or else you must first SIM unlock it. (Contact the original provider if you need help.)
  • There are no fees to activate a device with an eSIM.
  • You must be located in the US when activating service.
  • To activate your eSIM on another wireless provider or manage eSIM settings, check out our Tutorials.

 

Activate T-Mobile service

  1. Download the T-Mobile Prepaid eSIM app:
  2. Open the app and choose what type of plans to explore:
    • See travel plans shows limited duration plans designed for travelers
    • Explore other plans shows plans other than travel
  3. Enter the following information, then choose Next:
    • Email addresss
    • 6-15 digit PIN
    • Your U.S. ZIP code
  4. If prompted, allow the app access to your location while you’re using the app.
  5. Review your order to make sure everything looks correct.
  6. Enter your Credit Card informaiton, including CVV and billing ZIP code, then select Place order.
  7. Wait while we set up your T-Mobile service.
  8. Follow the prompts on your device to complete your eSIM download, including giving it a name and choosing a primary line.
  9. If you want to use a phone number from another provider or from another line, contact us to get this started.

Re-download eSIM

Sometimes, you may need to replace the eSIM you received through the app.

  • You accidentally deleted your eSIM.
  • You upgraded your phone and want to transfer your eSIM line of service to your new phone.
  • You lost connection when downloading your eSIM, and it didn't get installed properly on your device.

If you’re switching from one iPhone to another, you can transfer your phone number during Quick Start or through device settings. Otherwise, you'll need to call us at 1-877-778-2106. Make sure you have:

  • Your Prepaid eSIM phone number or your OrderID. Your OrderID will display if you encounter an error in the app.
  • Your account PIN code, which you set up to complete your order in the T-Mobile Prepaid eSIM App.

Errors and support

Here are some error messages you may receive using the app and tips to solve them.

 

Something went wrong – Check your internet connection

 
  • This means the app lost its connection to the internet when trying to set up service.
  • Make sure you have good Wi-Fi or Cellular signal, then try again.
  • If possible, try again using a different Wi-Fi network.
 

Looks like your device isn’t compatible

 
  • This means your device doesn't have an eSIM or is locked to the service provider you purchased it from.
  • If you have an iPhone, make sure it's the Apple iPhone Xs or newer.
  • If you have a Samsung, make sure it supports eSIM.
  • Contact the service provider who sold you the device to request an unlock.
 

This email address is already in use. Try a different email

 
  • This means the email address you're trying to use is already set up with an existing T-Mobile account.
  • Try again with a different email address to create a new account.
 

Error 504: Oops, something went wrong

 
  • This means that the app had an issue loading the next screen.
  • Make sure you have a strong Wi-Fi or Cellular data connection, then try again.
  • If it's still not working, contact us for help.
 

Error 505: There was an issue completing your order

 
  • This means there was an issue processing your payment.
  • You can try again with a different payment method.
  • If you’re currently outside of the United States, try again when you arrive.
  • If it's still not working, contact us for help.

Full terms

 

Was this helpful?