Vend

POST

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

POST

/api/v2.1/b2b/b2b/data/vend

$ curl -X POST https://p4p-core-bill-payments-service.dev.payinvert.com/api/v2.1/b2b/b2b/data/vend \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "package": "mtn-10mb-100",
>   "receiver": "08011111111",
>   "clientTransactionReference": "75F6CD621EB911F1A35EF6C3EF63228"
> }'

200Vend

1 {
2   "success": true,
3   "message": "Mock data vend successful",
4   "errors": null,
5   "statusCode": 200,
6   "correlationId": "04c45167-ee1e-4ebf-a3a5-7795267fd2e5",
7   "data": {
8     "status": "SUCCESS",
9     "amount": 100,
10     "package": "N100 100MB - 24 hrs",
11     "receiver": "08011111111",
12     "transactionId": "DAT-0000000000000422",
13     "clientTransactionReference": "75F6CD621EB911F1A35EF6C3EF63228",
14     "transactionDate": "2026-06-15T09:49:08.1851703",
15     "provider": "MTN",
16     "commission": {
17       "commissionAmount": 0,
18       "commissionPercentage": "0.00",
19       "commissionCap": 1500,
20       "isCustomRate": false
21     }
22   }
23 }

Completes a data bundle purchase and returns the final transaction status and fulfillment details.

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.