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
| Service | service | Priced by | Verify first |
|---|---|---|---|
| Electricity | electricity | amount | yes, always |
| Airtime | airtime | amount | no |
| Data | data | plan, or amount | no |
| Cable TV | cable_tv | plan, or amount | yes |
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
- A partner account, with KYB approved. Test keys work without approval; live keys do not.
- An API key, issued on the API keys page. The secret is shown once, at the moment you create it, and never again.
- A webhook URL and signing secret, on the Webhooks page, for each mode you use.
Environments
| Environment | Base URL |
|---|---|
| Production | https://api.getelectric.ng/api/v2 |
| Staging | https://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.