# GetElectric Partner API Sell electricity, airtime, data and cable TV from your own application. Every page below is also the markdown source of the rendered page at the same address without .md. ## Documentation: Get started - [Introduction](https://staging.getelectric.ng/developers/introduction.md): What the Partner API does and what you need to use it. - [Quickstart](https://staging.getelectric.ng/developers/quickstart.md): Sell your first unit of electricity in the sandbox, in about five minutes. - [Getting access](https://staging.getelectric.ng/developers/getting-access.md): What has to be true before a live key works. - [Authentication](https://staging.getelectric.ng/developers/authentication.md): One bearer header, and how live and test keys differ. - [Live and test modes](https://staging.getelectric.ng/developers/modes.md): Your key decides the mode. Staging is not a sandbox. ## Documentation: Core concepts - [The response envelope](https://staging.getelectric.ng/developers/responses.md): The five fields every response carries, and the one failure that still has a body. - [Errors](https://staging.getelectric.ng/developers/errors.md): Every status, the three different 403s, and why there are no error codes. - [What you can sell](https://staging.getelectric.ng/developers/products.md): Four services, two pricing shapes, and where provider and plan ids come from. - [Placing an order](https://staging.getelectric.ng/developers/orders.md): The one endpoint that spends money, for all four services. - [The reference, and retrying safely](https://staging.getelectric.ng/developers/idempotency.md): Your reference is what stands between a timeout and a double charge. - [Order states](https://staging.getelectric.ng/developers/order-lifecycle.md): Five states, three of them final, and what to do with each. - [Timestamps](https://staging.getelectric.ng/developers/timestamps.md): Two formats, both real. Do not parse them with a fixed pattern. ## Documentation: Webhooks - [Webhooks](https://staging.getelectric.ng/developers/webhooks.md): The single order.settled event, what it carries and what it does not. - [Verifying a signature](https://staging.getelectric.ng/developers/webhooks/signatures.md): Working verification code in Node, PHP and Python. - [Delivery and retries](https://staging.getelectric.ng/developers/webhooks/retries.md): Eight attempts over about 21 hours, and why 4xx does not stop them. ## Documentation: Sandbox - [Sandbox](https://staging.getelectric.ng/developers/sandbox.md): A test key, play money, and six numbers that behave predictably. - [Reserved meters](https://staging.getelectric.ng/developers/sandbox/meters.md): Six electricity meters, one outcome each, including the failures. - [Reserved targets](https://staging.getelectric.ng/developers/sandbox/targets.md): Six numbers for airtime, data and cable TV. - [Going live](https://staging.getelectric.ng/developers/going-live.md): The checklist, and what to do with your first real order. ## Documentation: Operations - [Concurrency limits](https://staging.getelectric.ng/developers/limits.md): There is no rate limit. There is a cap on requests in flight. - [Commission](https://staging.getelectric.ng/developers/commission.md): What you earn, where to see it, and what the API does not tell you. - [Postman collection](https://staging.getelectric.ng/developers/postman.md): Every endpoint ready to send, optionally with a fresh test key. - [Support](https://staging.getelectric.ng/developers/support.md): What to send so we can answer on the first reply. ## API reference: Reference - [API reference](https://staging.getelectric.ng/developers/api/overview.md): Nine endpoints, one header, one envelope. ## API reference: Account - [Get account](https://staging.getelectric.ng/developers/api/reseller-me.md): Who the key belongs to, and the only place its mode is stated. ## API reference: Verification - [Verify a meter](https://staging.getelectric.ng/developers/api/verify-meter.md): Check an electricity meter and read the access code an order needs. - [Verify a target](https://staging.getelectric.ng/developers/api/verify-target.md): Check a cable TV smartcard and read its customer and package. ## API reference: Orders - [Place an order](https://staging.getelectric.ng/developers/api/place-order.md): Buy electricity, airtime, data or cable TV. The only call that spends money. - [List orders](https://staging.getelectric.ng/developers/api/list-orders.md): Your recent orders in this mode, newest first. - [Get an order](https://staging.getelectric.ng/developers/api/get-order.md): One order by your own reference. How you poll, and how you recover. ## API reference: Catalogue - [List services](https://staging.getelectric.ng/developers/api/catalogue-services.md): What you can sell, and which pricing shape each one takes. - [List providers](https://staging.getelectric.ng/developers/api/catalogue-providers.md): Who sells a service. The source of provider_id. - [List plans](https://staging.getelectric.ng/developers/api/catalogue-plans.md): The bundles and packages a provider sells. The source of plan_id. ## API reference: Webhooks - [order.settled](https://staging.getelectric.ng/developers/api/webhook-order-settled.md): The one event we send you, and how it is signed.