Vend Transaction

POST

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

POST

/api/v2.1/b2b/b2b/power/vend

$ curl -X POST https://p4p-core-bill-payments-service.dev.payinvert.com/api/v2.1/b2b/b2b/power/vend \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "verificationReference": "A812BEF6581511F196222200317DA8F1",
>   "clientTransactionReference": "123456789211214"
> }'

1 {
2   "success": true,
3   "message": "Transaction successful",
4   "errors": null,
5   "statusCode": 200,
6   "correlationId": "44a7877f-baa1-4d6a-a713-7937bfde60e8",
7   "data": {
8     "status": "SUCCESS",
9     "amount": 100,
10     "token": "5170-7536-2887-4725",
11     "units": "4.69 kWh",
12     "meterCategory": "MD",
13     "kct1": "1234567890123",
14     "kct2": "1234567890123",
15     "receiver": "1111111111111",
16     "meterType": "PREPAID",
17     "transactionId": "ELE-0000000000000242",
18     "clientTransactionReference": "42FB39FB1EB811F1A35EF6C3EF632280",
19     "transactionDate": "2026-03-13T09:40:56.9594278",
20     "customerName": "Avoseh Emmanuel",
21     "customerAddress": "Turbo Energy, Lagos State",
22     "tariffDescription": "R2 - Residential",
23     "provider": "Abuja Electricity Distribution Company",
24     "outstandingDebt": "0",
25     "commission": {
26       "commissionAmount": 1.5,
27       "commissionPercentage": "1.50",
28       "commissionCap": 1500,
29       "isCustomRate": false
30     }
31   }
32 }

Completes an electricity purchase and returns the vending result, including the generated token or transaction outcome.

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

202

Electricity Vendtransaction Transaction IN Progress

417

Electricity Vendtransaction Transaction Failed