Skip to main content
POST
Buy Data Card

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

Network plan_id (from List Networks)

plan_type
string
required

The card plan_id for the chosen denomination

card_name
string
required

Card/denomination label

quantity
integer
required

Number of pins to generate (1–100)

Required range: 1 <= x <= 100
pin
string

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

request-id
string

Unique idempotency key

Response

200 - application/json

Success

network
string
request-id
string
transid
string

Transaction reference

amount
number

Total charged

quantity
integer
status
string
message
string
card_name
string
oldbal
number
newbal
number
system
string
serial
string

Comma-separated serial numbers, one per pin

pin
string

Comma-separated card pins

load_pin
string

How to load the pin (USSD/instructions)

check_balance
string

How to check balance (USSD)