Skip to main content
POST
Top up eSIM
Adds another data plan to an eSIM the customer already owns — no new QR code needed.
  • esim_id is the id of an existing eSIM from My eSIMs.
  • plan_id is any plan from List eSIM Plans whose topup_supported is true.
  • The wallet is debited at the plan’s price_ngn; a failed top-up is auto-refunded.

Authorizations

Authorization
string
header
required

Send your API key as Token <your_api_key>.

Use your live key for real transactions, or your sandbox key (sk_test_…) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add "sandbox_status": "fail" to any sandbox request to simulate a failure.

Body

application/json
esim_id
integer
required

ID of your existing eSIM (from My eSIMs)

plan_id
integer
required

Top-up plan ID from List eSIM Plans

request-id
string

Optional unique idempotency key

Response

200 - application/json

Success

status
string
message
string
data
object