Skip to main content
POST
/
purchaseElectricity
Purchase Electricity
curl --request POST \
  --url https://api.bleeprs.com/api/purchaseElectricity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1500,
  "meter": "12345678910",
  "phone": "08000000000",
  "disco": "ikeja-electric"
}
'
{
  "gatewayStatus": "00",
  "gatewayMessage": "Successfully Processed",
  "requestReference": "bpr_req_a1b2c3d4e5f6",
  "data": {
    "status": "SUCCESS",
    "token": "1234 5678 9101 1121 3141",
    "units": "24.5 kWh",
    "reference": "b8c3a1b2-1024-4f5c-89de-d93a7c6b98e1"
  }
}

Overview

Purchase an electricity token for a validated meter. The token will be generated instantly and can be used to recharge the meter.

Notes

  • Minimum Amount: The minimum purchase amount for electricity is typically ₦2,000.
  • Maximum Amount: The maximum purchase amount is ₦200,000 per transaction.
  • If the response returns gatewayStatus: "01" (Pending), wait 2 minutes and 1 second before calling the Requery API.

Authorizations

Authorization
string
header
required

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

Body

application/json
amount
number
required

Amount of electricity to purchase (in Naira)

Example:

1500

meter
string
required

The validated electricity meter number

Example:

"12345678910"

phone
string
required

The customer phone number

Example:

"08000000000"

disco
string
required

The Distribution Company (DisCo) slug

Example:

"ikeja-electric"

Response

200 - application/json

Successfully Processed

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Successfully Processed"

requestReference
string
Example:

"bpr_req_a1b2c3d4e5f6"

data
object