Add more data to an existing eSIM
packageType: 'TOPUP' and the esimId of the eSIM you want to refill.
Get your eSIMs
GET /api/esim/my-esims to find the eSIM you want to top up. Note down its id and packageCode.Fetch top-up packages
GET /api/esim/packages?type=TOPUP®ionCode={regionCode}&packageCode={packageCode} to see available top-up options.Get exchange rate (optional)
GET /api/settings/exchange-rate to show the NGN equivalent price to your users.Purchase the top-up
POST /api/esim/buy with packageType: 'TOPUP', the top-up packageCode, and the esimId.WALLET - Pay with wallet balance (instant)CARD - Pay with credit/debit cardBANK_TRANSFER - Pay via bank transferTOPUP for top-up purchases.GET /api/esim/my-esims.SUCCESS (wallet payment) or PENDING (card/bank transfer)status is SUCCESS)GET /api/esim/packages?type=TOPUP returns an empty array, the eSIM does not support data refills. The user would need to purchase a new eSIM instead.