Virtual Top-Up (VTU)

Overview

This method enables recipients to receive airtime real-time.

Sample Request

POST / topup

curl `${baseurl}/topup`
-H "Content-type: application/json"
-X POST
-d '{
    "action":"VT",
    "terminalId":"7000000001",
    "transaction": {
        "pin": "kghxqwveJ3eSQJip/cmaMQ==",
        "amount": 100,
        "description": "Virtual Topup",
        "provider":"ETISALAT",
        "lineType":"VTU",
        "destination": "08012345678",
        "reference": "0384892920",
        "senderName": "Sender’s Name;Sender’s Account Number;Recipient’s Name",
    }
}'

Sample Response

POST / topup

{
  "direction": "response",
  "reference": "09FG230309155847454PNZ3W1",
  "amount": 100,
  "totalFailed": 0,
  "totalSuccess": 0,
  "error": "0",
  "message": "Successfully Processed",
  "otherReference": "08123232323",
  "action": "VT"
}