This is a POST request that is responsible for airtime purchases.

Sample request

{
{
  "originatorConversationId": "{{$guid}}",
  "callbackURL": "https://en1ezbmu2vsd.x.pipedream.net",
  "recipients": [
    {
      "currencyCode": "KES",
      "phoneNumber": "254700000000",
      "amount": 99,
      "name": "Jojo Siwa"
    }
  ]
}

Sample response

{
{
    "message": {
        "systemConversationId": "01000000-0105-0a00-6bc1-08de9bedbeee",
        "originatorConversationId": "01000000-0105-0a00-6bc1-08de9bedbee",
        "remarks": "Airtime Purchase Accepted",
        "timestamp": "2026-04-16T19:24:15.3381289Z",
        "appDomainName": "TEST"
    }
}

Data Definition

Field name	Data type	Options
recipientName	string	mandatory
recipientPhoneNumber	string	mandatory
recipientccy	string	mandatory
amount	integer	mandatory
callBackUrl	string	mandatory

Description

CurrencyCode: country code

PhoneNumber: phone number used in the airtime purchase

Amount: Airtime bought

Name: name of the person who purchased the airtime

OriginatorConversationId: this is the unique transaction identifier generated by Zamupay

CallbackURL: This is where you will receive the callback

curl --location 'https://auth.zamupay.com/v1/airtime-purchase' \ --header 'Content-Type: application/json' \ --data '{ "originatorConversationId": "string", "callbackURL": "http://example.com", "recipients": [ { "currencyCode": "string", "phoneNumber": "string", "amount": 0, "name": "string" } ] }'

Airtime Purchase

Sample request

Sample response

Data Definition

Description

Request

Responses

Airtime Purchase

Sample request#

Sample response#

Data Definition#

Description#

Request

Responses

Sample request

Sample response

Data Definition

Description