Skip to main content
POST
Move airtime from a user's line to your SIM

Authorizations

X-API-Key
string
header
required

Body

application/json
session_id
string
required
amount
integer
required

Whole naira. Minimum 50.

Example:

1000

pin
string
required

The user's 4-digit MTN airtime-transfer PIN. Never stored.

Example:

"1234"

reference
string
required

Your unique reference. Repeating it never sends twice.

Maximum string length: 64
Example:

"order-2026-0001"

Response

Airtime received (status is success).

success
boolean
transfer_id
string
Example:

"ACT_5d0c8b1e"

reference
string
Example:

"order-2026-0001"

session_id
string
amount
integer
Example:

1000

status
enum<string>
Available options:
success,
failed,
pending,
unknown
mtn_transaction_id
string | null
message
string | null

MTN's own reply for this transfer.

created_at
string