Check an electricity payment

GET

/v1/electricity/b2b/{reference}

The current status of an electricity payment, with the token once it is SUCCESS. While it is PROCESSING this checks with the provider.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/electricity/b2b/' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "success": true,
    "message": "Request successful",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "reference": "DB-ELEC-20250923-MFX2K9QZ-5E6F7A8B",
        "type": "ELECTRICITY",
        "status": "PROCESSING",
        "amount": 4950,
        "recipient": "45067891234",
        "network": "IKEJA",
        "planId": null,
        "description": "Ikeja Electric (IE) prepaid ₦5,000",
        "tokenOrPin": null,
        "balanceBefore": 10000,
        "balanceAfter": 9520,
        "failureReason": null,
        "createdAt": "2026-09-26T12:00:00.000Z"
    }
}

Modified at 2026-10-05 17:27:33

Pay for electricity

List distribution companies