# mySubwallet

> mySubwallet developer API — buy data, airtime, cable, electricity, bulk SMS, exam pins and more, funded from your wallet.

## Docs

- [Authentication](https://docs.mysubwallet.ng/authentication.md): Generate your access token and authenticate API requests.
- [Plans & Catalogs](https://docs.mysubwallet.ng/guides/catalogs.md): Fetch the plan IDs, network IDs and codes the purchase endpoints expect.
- [Errors & Status](https://docs.mysubwallet.ng/guides/errors.md): How the API reports success and failure.
- [Services](https://docs.mysubwallet.ng/guides/services.md): Every service you can sell through the mySubwallet API.
- [Webhooks](https://docs.mysubwallet.ng/guides/webhooks.md): Receive real-time transaction status updates.
- [Introduction](https://docs.mysubwallet.ng/index.md): Integrate mySubwallet to sell data, airtime, cable, electricity, exam pins and bulk SMS programmatically.
- [Quickstart](https://docs.mysubwallet.ng/quickstart.md): Make your first successful purchase in minutes.
- [Buy Airtime](https://docs.mysubwallet.ng/reference/airtime.md): Send airtime to a phone number.
- [Airtime to Cash](https://docs.mysubwallet.ng/reference/airtime-to-cash.md): Convert airtime to wallet cash. Requires Tier 2+. Send airtime to the returned receiver number; your wallet is credited after confirmation.
- [Send Bulk SMS](https://docs.mysubwallet.ng/reference/bulksms.md): Send an SMS from an approved sender name.
- [Cable Subscription](https://docs.mysubwallet.ng/reference/cable.md): Renew or change a cable TV subscription.
- [List Cable Plans](https://docs.mysubwallet.ng/reference/cable-plans.md): Cable plans and prices for POST /api/cable.
- [Buy Data](https://docs.mysubwallet.ng/reference/data.md): Purchase a data bundle and deliver it instantly to a phone number.
- [List Data Plans](https://docs.mysubwallet.ng/reference/data-plans.md): Fetch every data plan with its plan_id, to use in POST /api/data.
- [List DISCOs](https://docs.mysubwallet.ng/reference/discos.md): Electricity distribution companies for the `disco` field in POST /api/bill.
- [Pay Electricity Bill](https://docs.mysubwallet.ng/reference/electricity.md): Pay an electricity bill. Prepaid responses include the recharge token.
- [Buy eSIM](https://docs.mysubwallet.ng/reference/esim-buy.md)
- [List eSIM Countries](https://docs.mysubwallet.ng/reference/esim-countries.md)
- [My eSIMs](https://docs.mysubwallet.ng/reference/esim-my.md)
- [List eSIM Packages](https://docs.mysubwallet.ng/reference/esim-packages.md)
- [Buy Exam Pins](https://docs.mysubwallet.ng/reference/exam.md): Buy WAEC, NECO and NABTEB result-checker pins.
- [List Exam Bodies](https://docs.mysubwallet.ng/reference/exam-bodies.md): Exam bodies and prices for the `exam` field in POST /api/exam.
- [Search Airports](https://docs.mysubwallet.ng/reference/flight-airports.md)
- [Book Flight](https://docs.mysubwallet.ng/reference/flight-book.md): Confirm price, debit wallet and issue a ticket. Requires KYC. Auto-refunds on failure.
- [Search Flights](https://docs.mysubwallet.ng/reference/flight-search.md)
- [Fund Betting Account](https://docs.mysubwallet.ng/reference/fund-betting.md)
- [List Networks](https://docs.mysubwallet.ng/reference/networks.md): Network IDs (`plan_id`) used across the API.
- [Verify Betting Account](https://docs.mysubwallet.ng/reference/verify-betting.md): Confirm a betting customer ID before funding.
- [Verify Meter](https://docs.mysubwallet.ng/reference/verify-meter.md): Confirm the customer on an electricity meter before payment.
- [Verify Smartcard](https://docs.mysubwallet.ng/reference/verify-smartcard.md): Confirm the customer name on a cable smartcard before purchase.

## OpenAPI Specs

- [openapi](https://docs.mysubwallet.ng/api-reference/openapi.json)