API Referenceesim

Topup Esim

View as Markdown

Top up an existing eSIM with a top-up package using the reseller wallet. List eligible packages with GET /esim/package/{slug}/topup first. The account discount_percent from GET /reseller/balance is taken off the package price. To safely retry, reuse the same transaction_id with the same eSIM and slug.

Authentication

x-api-keystring

API key generated from the dashboard (Settings → API Keys). Each key is limited to 8 requests per 1-second window.

Path parameters

idstringRequired

Request

This endpoint expects an object.
transaction_idstringRequired1-100 characters

Reseller-assigned transaction ID

slugstringRequired1-50 characters

Slug of the top-up package to apply

Response

Successful response
transaction_idstring1-100 characters

Reseller-assigned transaction ID

esim_idstring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error