Send OTP

X-API-Key

POST/airtime-to-cash/otp/send

Send a one-time password to the customer's MTN line. Use the same phone on verify and convert.

Language

curl -X POST "https://api.vendpower.ng/api/v1/airtime-to-cash/otp/send" \
  -H "X-API-Key: YOUR_X_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "biller_code": "MTN",
    "phone": "08031234567"
  }'

Authentication

Send your approved API key on every request. Keep it on your server only.

Header	Value	Required
X-API-Key	YOUR_X_API_KEY	Yes
Content-Type	application/json	Yes
Accept	application/json	Recommended

Authentication failures (401 / 403 / 429) are listed in Authentication.

Parameters

Body parameters

Name	Type	Required	Description
biller_code	string	Yes	From billers — currently `MTN`
phone	string	Yes	Nigerian MSISDN, e.g. `08031234567` (11 digits). Must match the network for airtime and data.

Responses

200 OK — OTP sent

{
  "success": true,
  "message": "OTP sent.",
  "data": {
    "phone": "2348031234567",
    "otp_sent": true
  }
}