Vend

POST

https://p4p-core-bill-payments-service.dev.payinvert.com/api/v2.1/b2b/b2b/airtime/vend

POST

/api/v2.1/b2b/b2b/airtime/vend

$ curl -X POST https://p4p-core-bill-payments-service.dev.payinvert.com/api/v2.1/b2b/b2b/airtime/vend \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "amount": 100,
>   "receiver": "8888888888888",
>   "provider": "MTNs",
>   "clientTransactionReference": "75F6CD621EB911F1A35EF6C3EF632280"
> }'

1 {
2   "success": true,
3   "message": "Transaction successful",
4   "errors": null,
5   "statusCode": 200,
6   "correlationId": "d28e6586-9fcc-4401-a601-c9054cd0848d",
7   "data": {
8     "status": "SUCCESS",
9     "amount": 100,
10     "receiver": "08011111111",
11     "transactionId": "ELE-0000000000000349",
12     "clientTransactionReference": "ELE-0000000000000349",
13     "transactionDate": "2026-05-19T15:06:02.2798259",
14     "provider": "MTN",
15     "commission": {
16       "commissionAmount": 1.5,
17       "commissionPercentage": "1.50",
18       "commissionCap": 1500,
19       "isCustomRate": false
20     }
21   }
22 }

Purchases airtime for a specified phone number and returns the transaction result.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a map from strings to any.

Response

This endpoint returns a map from strings to any.

Errors

200

Airtime Vend Success

Success

400

Airtime Vend Validation Error

417

Airtime Vend Failure