Paybeta API v2

One API for every bill payment

Sell airtime, data, electricity tokens, cable TV and education PINs inside your own app or website. A simple REST API with a sandbox, webhooks and commission on every transaction.

  • Sandbox environment
  • OpenAPI spec
  • 24/7 developer support
# Buy ₦2,000 MTN airtime
curl -X POST https://api.paybeta.ng/v2/airtime/purchase \
  -H "P-API-KEY: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "mtn_vtu",
    "phoneNumber": "08068539220",
    "amount": 2000,
    "reference": "1714747864"
  }'
200 OK Example response
{
  "status": "successful",
  "message": "Airtime top-up successful",
  "data": {
    "reference": "1714747864",
    "amount": 2000,
    "chargedAmount": 1960,
    "commission": 40
  }
}
34live services in one API
Up to 4%commission per transaction
REST + JSONwith webhooks for status updates
24/7developer support
What you can sell

Every bill, one integration

Live API commission rates. Your earnings are applied automatically on every transaction.

Airtime

MTN, Glo, Airtel and T2Mobile top-ups.

Earn up to4%

Data

Data bundles for every network.

Earn up to4%

Electricity

Validate meters and vend prepaid tokens or postpaid payments.

Earn up to1.2%

Cable TV

DStv, GOtv, StarTimes and Showmax.

Earn up to1.5%

Education

JAMB and WAEC PINs.

Flat commission per PIN

Betting

Wallet funding for major betting platforms.

Earn up to0.2%

See every biller on the commission rates page.

Built for developers

Simple, predictable endpoints

Authenticate every request with your secret key in the P-API-KEY header.

  • POST/airtime/purchaseBuy airtime for any network
  • POST/data-bundle/purchaseBuy a data bundle
  • POST/electricity/validateValidate a meter and get the customer name
  • POST/electricity/purchaseVend an electricity token or postpaid payment
  • POST/transaction/queryCheck the status of any transaction
Productionhttps://api.paybeta.ng/v2

Live transactions, real value.

Sandboxhttps://api.sandbox.paybeta.ng/v2

Test your integration safely before going live.

OpenAPI specdocs.paybeta.ng/openapi.json

Import into Postman or generate an SDK.

Use cases

From startups to enterprises

Mobile apps

Add bill payments right inside your mobile app.

Websites

Launch your own VTU or bill payment website.

SaaS platforms

Embed bill payments in your software product.

Fintechs & wallets

Give your users more ways to spend their balance.

Get started

Go live in 3 steps

Create a console account

Sign up on the Paybeta console to get your API keys.

Build in the sandbox

Use the docs and sandbox to test every flow end to end.

Go live & earn

Switch to production and earn commission on every transaction.

Ready to start building?

Get your API keys, explore the docs and join our developer community.