This method initiates a purchase request for airtime units to the provided customer.
Access to this endpoint requires setup changes on your account. Contact the technical team for this configuration to be completed.
The table below provides information about the properties expected in the payload to be sent to this request:
| Property | DataType (maxSize) | Required | Description |
|---|---|---|---|
| Order | Object | Yes | Information about the operation to be performed |
| Order.customerFullName | String(180) | No | Full Name for customer |
| Order.customerPhoneNumber | String(180) | No | Phone Number of the customer |
| Order.transactionReference | String(20) | Yes | Reference transaction ID from source request to be used in reconciliations |
| Order.customerEmailAddress | String(180) | No | Email address of the customer |
| Order.currency | String(3) | Yes | Char 3 ISO currency code |
| Order.amount | Decimal(8,2) | Yes | Amount involved in the transaction |
| Destination | Object | Yes | Information about the beneficiary |
| Destination.msisdn | String | Yes | Phone number in international format (+243XXXX…) |
| Destination.provider | String | Yes | The Provider to be used to process the payment (MPESA,AIRTEL,ORANGE,AFRIMONEY) |
{
"order": {
"customerFullName": "string",
"customerPhoneNumber": "string",
"customerEmailAddress": "string",
"transactionReference": "string",
"amount": 10,
"currency": "USD”
},
"destination": {
"msisdn": "string",
"provider": "string"
}
}{
"transactionId": "string",
"originatingTransactionId": "string”,
“statusCode”:”200”,
“statusDescription”:”SUCCESS”,
}