Airtime Purchase

https://auth.zamupay.com

POST

/v1/airtime-purchase

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

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{}

Modified at 2026-01-29 06:19:26

Find Charges By TransactionTypeId

Find Airtime Purchases By OriginatorConversationId

Airtime Purchase

Data Definition#

Description#

Request

Responses

Data Definition

Description