Vend Transaction | Pay4Power

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

{
  "correlationId": "44a7877f-baa1-4d6a-a713-7937bfde60e8",
  "data": {
    "amount": 100,
    "clientTransactionReference": "42FB39FB1EB811F1A35EF6C3EF632280",
    "commission": {
      "commissionAmount": 1.5,
      "commissionCap": 1500,
      "commissionPercentage": "1.50",
      "isCustomRate": false
    },
    "customerAddress": "Turbo Energy, Lagos State",
    "customerName": "Avoseh Emmanuel",
    "kct1": "1234567890123",
    "kct2": "1234567890123",
    "meterCategory": "MD",
    "meterType": "PREPAID",
    "outstandingDebt": "0",
    "provider": "Abuja Electricity Distribution Company",
    "receiver": "1111111111111",
    "status": "SUCCESS",
    "tariffDescription": "R2 - Residential",
    "token": "5170-7536-2887-4725",
    "transactionDate": "2026-03-13T09:40:56.9594278",
    "transactionId": "ELE-0000000000000242",
    "units": "4.69 kWh"
  },
  "errors": null,
  "message": "Transaction successful",
  "statusCode": 200,
  "success": true
}

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