How to Top Up a eSIM Plan with eSIM Access API?

Users with an installed, active eSIM plan can receive a data top up to extend both the validity and data allowance. Users can top up and eSIM a maximum of 9 times.

Top-Up Rules Summary

Top-ups are available for all plans (except for exceptions) unless a specific top-up plan has not been configured.

• Fixed Plans: Top-ups add both additional data and validity days.
• Unlimited Plans: Top-ups extend validity days only (data does not stack, and daily high-speed limits remain unchanged).
• Exceptions: Canada 75GB 30Days & Thailand 50GB 10Days (billing starts after purchase and non-refundable, non-stackable)

For example – if you have a 1GB 7 Day European eSIM plan, you would be able to add another 1GB 7 day extension. This top up would add on to the existing plan, making it 2GB for 14 days. ( 1GB + 1GB = 2GB total. 7 Days + 7 Days = 14 Days total )

Top ups add together validity and data to give a new, updated total validity and data total after each top up.

Day Pass, Non-Reloadable and select other plans do not offer top up and are not reloadable. Check the “Reloadable” column in the price list to see if a plan is reloadable or not. These are set in the API as “supportTopUpType”: 1

1. Top-Up Endpoint Summary: The top-up endpoint adds a new plan to an existing eSIM using its ICCID or esimTranNo.
2. Key Specifications: Plan Identifier: Always use slug instead of packageCode (slug remains constant, whereas packageCode may change). Unlimited plan extensions require packageCode + periodNum.
3. Allowed States: Top-ups are permitted only when the eSIM status is New (issued/uninstalled) or Active (in use). Top-ups are blocked once expired.
4. Pre-Installation Top-Ups: Packages can be added to a New eSIM before handing it over to the customer.
5. Refund Policy: Refunding an uninstalled (New) eSIM automatically refunds all attached top-ups.

How to Top Up #

In order to top up a plan from the console, find the plan you wish to recharge.

Click on the plan’s title and view the “Action” tab in the pop up.

Click on the Top Up button. Shown will be the top up plans available to the eSIM profile. Available plans will be similar to the original plan and based on the eSIM ID (ICCID).

Click on the Action icon and you will confirm the top up amount and the amount will be deducted from your balance.

Make a top up with the Make.com eSIM application #

To top up with the Make module, find the “Top up a Profile” action. Then you will add ICCID, Package Code and your own TransactionID. You can run the module Top Up – https://www.make.com/en/integrations/esim

Make a top up with the API via Postman #

To make a top up via API, you can see this example and these steps using Postman.

1. Using the ICCID or esimtranno, check the available top up packages
2. Save the package code OR slug of the top up package you want
3. Visit api/v1/open/esim/topup and enter the ICCID or esimtranno and packageCode or Slug to make a top up request
4. If success, you will see the new remaining duration and data volume

Here is an example of these steps:

Here is an example using Slug, rather than packageCode:

Make a top up for Unlimited FUP / Daypass plans: #

Boost Unlimited FUP Plan Sales with Top-Up Feature