GetElectric Partner API

Sell electricity, airtime, data and cable TV from your own application.

You call us server to server with an API key. We charge your partner balance, buy from the provider, and tell you what happened. Your customer never leaves your product.

What you can sell

ServiceservicePriced byVerify first
Electricityelectricityamountyes, always
Airtimeairtimeamountno
Datadataplan, or amountno
Cable TVcable_tvplan, or amountyes

Three things that shape every integration

Your reference is the idempotency key. Every order carries a reference you choose. We claim it before anything is charged, so sending the same one twice cannot vend twice: the second call returns the first order. A timed-out request is safe to retry with the same reference, and that is the only safe way to retry one.

An order is not finished when the call returns. A successful POST /reseller/orders answers 202, and the order is usually still processing. You either poll it or wait for the order.settled webhook.

A key is live or test, and the key string does not say which. Only Get account tells you. A test key spends play money against reserved numbers and can never reach a real meter.

What you need

  1. A partner account, with KYB approved. Test keys work without approval; live keys do not.
  2. An API key, issued on the API keys page. The secret is shown once, at the moment you create it, and never again.
  3. A webhook URL and signing secret, on the Webhooks page, for each mode you use.

Environments

EnvironmentBase URL
Productionhttps://api.getelectric.ng/api/v2
Staginghttps://stagingapi.getelectric.ng/api/v2

Live and test are not different hosts. Both run on the base URL your account was given, and which one you are in is decided by the key you send.

Warning

Staging is not a sandbox. It carries live provider credentials, so a live key there spends real money against a real meter. Use a test key for anything you are still building.

Next

Quickstart gets a token out of the sandbox in about five minutes.