# Routegate

> One API that routes airtime, data and every other service to the best available channel with smart routing, automatic failover, a ledger-safe wallet and reliable webhooks. Base URL https://api.useroutegate.com. Authenticate with a bearer API key (`rg_test_` in test mode, `rg_live_` in live). Amounts are integers in kobo. Every money call takes an `Idempotency-Key` header.

Every page below is markdown. The OpenAPI spec is the source of truth for request and response shapes.

## Get started

- [Routegate documentation](https://useroutegate.com/docs.md): One API for airtime and data, routed to the channel most likely to deliver, settled in a ledger you can audit.
- [Quickstart](https://useroutegate.com/docs/quickstart.md): A key, a vend, a webhook. Five minutes, no approval call.

## Concepts

- [Idempotency](https://useroutegate.com/docs/concepts/idempotency.md): The header that stops a retry becoming a double debit.

## API reference

- [POST Payment callback](https://useroutegate.com/docs/api/callbacks/paymentCallback.md): POST /callbacks/payments/{gateway}
- [POST Provider callback](https://useroutegate.com/docs/api/callbacks/providerCallback.md): POST /callbacks/providers/{provider}
- [POST Vend airtime](https://useroutegate.com/docs/api/public/vendAirtime.md): POST /api/v1/airtime
- [POST Vend cable](https://useroutegate.com/docs/api/public/vendCable.md): POST /api/v1/bills/cable
- [POST Vend electricity](https://useroutegate.com/docs/api/public/vendElectricity.md): POST /api/v1/bills/electricity
- [POST Verify bill](https://useroutegate.com/docs/api/public/verifyBill.md): POST /api/v1/bills/verify
- [GET List networks](https://useroutegate.com/docs/api/public/listNetworks.md): GET /api/v1/catalog/networks
- [GET List products](https://useroutegate.com/docs/api/public/listProducts.md): GET /api/v1/catalog/products
- [GET List services](https://useroutegate.com/docs/api/public/listServices.md): GET /api/v1/catalog/services
- [POST Vend data](https://useroutegate.com/docs/api/public/vendData.md): POST /api/v1/data
- [GET Get public pricing plans](https://useroutegate.com/docs/api/public/getPublicPricingPlans.md): GET /api/v1/pricing/plans
- [GET List public transactions](https://useroutegate.com/docs/api/public/listPublicTransactions.md): GET /api/v1/transactions
- [GET Get transaction by reference](https://useroutegate.com/docs/api/public/getTransactionByReference.md): GET /api/v1/transactions/{reference}
- [POST Vend](https://useroutegate.com/docs/api/public/vend.md): POST /api/v1/vend
- [GET Get wallet balance](https://useroutegate.com/docs/api/public/getWalletBalance.md): GET /api/v1/wallet/balance

## Optional

- [OpenAPI spec](https://useroutegate.com/openapi.yaml): every operation, exact shapes
- [Everything as one file](https://useroutegate.com/llms-full.txt): every page above, concatenated