Confirm Airtime Purchase

POST

http://localhost:8080/api/v3/transactions/buy-airtime/confirm

POST

/api/v3/transactions/buy-airtime/confirm

curl -X POST http://localhost:8080/api/v3/transactions/buy-airtime/confirm \
     -H "Authorization: Bearer {{accessToken}}" \
     -H "Idempotency-Key: idem-{{$guid}}" \
     -H "X-Device-Id: {{deviceId}}" \
     -H "X-Request-Id: {{requestId}}" \
     -H "X-Signature: {{signature}}" \
     -H "X-Timestamp: {{timestamp}}" \
     -H "Content-Type: application/json" \
     -d '{
  "transactionId": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f81"
}'

{
  "code": 200,
  "message": "Airtime purchase confirmed.",
  "data": {
    "transactionId": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f81",
    "walletId": "b1e7f6a0-9d2b-4a5b-9c3d-1a2b3c4d5e6f",
    "amount": 100,
    "fee": 0,
    "category": "AIRTIME",
    "destination": "712***678",
    "status": "PENDING",
    "reference": "UTL9PB2W6D",
    "timestamp": "2026-10-07 13:00:00"
  }
}

Submits the purchase to Choice and sends the customer an OTP. Status becomes PENDING (awaiting OTP). Next step: Confirm Airtime Purchase OTP.

Headers

Request

This endpoint expects an object.

transactionIdstringOptional

Response

200 OK

codeintegerOptional

messagestringOptional

dataobjectOptional

Errors

400

Bad Request Error