Verify OTP

X-API-Key

POST/airtime-to-cash/otp/verify

Verify the OTP and receive a short-lived session_id. Use it for balance and convert. Response includes airtime balance and convert rate.

Language

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

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	Same as send OTP
phone	string	Yes	Same MSISDN
otp	string	Yes	SMS OTP code

Responses

200 OK — Verified

{
  "success": true,
  "message": "OTP verified.",
  "data": {
    "session_id": "a2c_sess_abc123",
    "phone": "08031234567",
    "msisdn": "2348031234567",
    "airtime_balance": 2500.5,
    "airtime_value": "₦2,500.50",
    "convert_percent": 85,
    "expires_in": 900
  }
}