Skip to main content
POST
Buy eSIM
Purchases an eSIM plan and debits your wallet at price_ngn.

Provisioning & status

eSIMs provision asynchronously, so read data.plan_status:

Installing the eSIM

Give the customer the qr_code image to scan, or the ac (an LPA:1$... activation string) to install manually.
Send a unique request-id to make retries safe — the same id returns the original purchase instead of charging again.

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
plan_id
integer
required

eSIM plan ID from List eSIM Plans

pin
string

4-digit transaction PIN (WEBSITE only, when enabled)

request-id
string

Optional unique idempotency key

Response

200 - application/json

Success

status
string
message
string
data
object