Buy electricity

Use this endpoint to purchase electricity.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

📘

How do you find disco codes

Electricity distribution companies are represented as codes. You can find this code when you run the List dicos endpoint

In the example below, we're looking for the disco code for IKEDC. Using the List discos endpoint we identified it as "Ikeja_Electric_Bill_Payment", See the response example below.

{
      "id": "dd8ebf39-853e-4bae-96ed-338f4c1fd08d",
      "createdAt": "2023-09-07T00:00:00.718Z",
      "updatedAt": "2023-09-07T00:00:00.718Z",
      "code": "Ikeja_Electric_Bill_Payment",
      "description": "Ikeja Electric Bill Payment",
      "minimum_value": "500",
      "maximum_value": "500000",
      "is_available": "Yes"
    },

❗️

The electricity amount should not go below ₦500

Body Params
string
required

The meter number

string
required

The code that represents the electricity distribution company. See information box to learn how to disco codes.

float
required

The amount (how much money) of electricity units to be purchased. Note this cannot be below 500

string
required
Defaults to prepaid

Indicate if its a pre-paid or post-paid meter. The values are represented as prepaid or postpaid. Note that Fintava only supports pre-paid for now.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json