Build with RizPay

Add bill payments to your app.

Choose a service, connect your server, then follow a purchase through to its final result. These guides cover the decisions between an API request and a customer getting what they paid for.

Already comparing product costs? Keep your catalogue and retail prices current. Your resale margin and any separate partner incentive are different parts of the calculation.

Choose your starting point

Bill payment APIs

Airtime API for Nigerian apps and VTU businesses

Choose a network and let customers top up an amount they select. Use one server integration for airtime purchases, status checks and receipts.

Data bundle API for Nigerian apps

Offer data bundles through RizPay with catalogue-based selection, current partner costs and a purchase flow that tracks delivery separately from payment acceptance.

Electricity payment API for Nigerian applications

Integrate meter verification, electricity purchases and prepaid token retrieval with RizPay. Build a checkout that distinguishes prepaid and postpaid accounts.

Cable TV subscription API for Nigerian apps

Offer DStv, GOtv and StarTimes subscriptions with package discovery, decoder verification and transaction tracking through the RizPay bill payment API.

Cable TV smartcard verification API for Nigerian apps

Verify a DStv, GOtv or StarTimes decoder before checkout, distinguish its existing bouquet from the selected package and preserve the confirmed purchase.

Build a data bundle selector from the API catalogue

Help customers choose a Nigerian data bundle by network, size, duration and current product cost without confusing labels or silently substituting a plan.

Electricity meter verification API: confirm before paying

Build a meter verification step for Nigerian electricity payments, preserve the verified details and prevent changes between confirmation and purchase.

Prepaid and postpaid electricity: design the right API flow

Handle prepaid tokens and postpaid account payments correctly, validate meter type during checkout and give customers a receipt that matches the purchase.

Networks and billers

MTN airtime API integration in Nigeria

Add MTN airtime top-ups to your app using RizPay's network-filtered catalogue, amount limits and transaction status workflow.

Airtel airtime API integration in Nigeria

Build an Airtel top-up flow with RizPay, from selecting the current airtime product to confirming the recipient and checking the final purchase status.

Glo airtime API integration in Nigeria

Integrate Glo airtime purchases through RizPay with explicit network selection, server-side amount checks and a traceable order reference.

9mobile airtime API: product codes and purchases

Use the 9MOBILE identifier in RizPay's airtime catalogue and purchase flow. Keep the API code separate from customer-facing network labels.

MTN data API for bundle resellers and apps

Retrieve MTN data bundles, display their validity and partner cost, and submit the exact selected plan through the RizPay API.

Airtel data API for Nigerian developers

Build an Airtel data selector from RizPay's catalogue, including bundle size, validity and the cost used to calculate your own retail price.

Glo data bundle API integration

Offer Glo data bundles using RizPay's product catalogue, with explicit plan selection, partner pricing and delivery-state handling.

9mobile data API: bundles, codes and pricing

Discover data products with RizPay's 9MOBILE network code and build a selector that preserves bundle identity, validity and current partner cost.

IBEDC electricity payment API integration

Build an IBEDC payment flow with RizPay by reading the electricity catalogue, verifying the meter and reconciling the final electricity purchase result.

IKEDC electricity payment API integration

Integrate Ikeja Electric payments through RizPay with the IKEDC distributor code, meter verification and separate prepaid and postpaid receipt handling.

EKEDC electricity payment API integration

Use RizPay to integrate Eko Electricity payments with distributor selection, meter verification, customer confirmation and transaction reconciliation.

AEDC electricity payment API integration

Add Abuja Electricity payments to your app with RizPay by selecting the AEDC product from the electricity catalogue, verifying the meter and reading purchase status.

DStv subscription API for Nigerian applications

Integrate DStv package discovery, decoder verification and subscription purchases through RizPay, using current catalogue products and costs.

GOtv subscription API for Nigerian applications

Build a GOtv renewal flow with RizPay using package discovery, smart-number verification and a purchase tied to the customer's confirmed selection.

StarTimes subscription API integration in Nigeria

Offer StarTimes subscriptions with RizPay using the STARTIMES provider code, current packages, decoder verification and final purchase status.

Server integrations

Running payments

Handle bill payment API errors by their effect on the order

Distinguish invalid input, access problems and uncertain purchase outcomes so API errors lead to a useful customer action and safe order recovery.

Secure bill payment API keys across your application

Choose least-privilege API scopes, separate sandbox and production secrets, and prepare a key replacement process that preserves unresolved purchases.

Handle bill payment API rate limits without duplicate orders

Budget requests across catalogue refreshes, purchase workers and status checks, and handle rate-limit responses without blindly repeating payment requests.

Plan partner wallet balance for bill payment API traffic

Read the partner balance, distinguish it from customer collections and account for concurrent purchases when planning funding and low-balance responses.

Recover missed and repeated bill payment webhooks

Acknowledge webhook events after durable receipt, recover from receiver outages and handle repeat deliveries without duplicate receipts or financial entries.

Keep bill payment catalogues and partner prices current

Build product selectors from RizPay's catalogue, handle pagination and price changes, and distinguish partner cost from the retail price your customer pays.

Recover an electricity token without purchasing twice

Handle missing prepaid tokens by retrieving and reconciling the original RizPay electricity transaction. Keep meter details and receipts private.

Handle Nigerian phone numbers in a bill payment API

Normalize airtime and data recipients, preserve leading zeros, confirm the network and keep test numbers separate from real customer purchases.

How to handle pending bill payment API transactions

Keep pending bill payments recoverable with stored references, status checks and webhook reconciliation. Avoid charging or purchasing again after a timeout.

Prevent duplicate airtime and bill payment purchases

Use durable order references and reconciliation to prevent duplicate purchases when a request times out, a customer retries or a worker runs twice.

Reconcile bill payment orders with API transaction records

Compare local orders, RizPay purchases and customer payment records, revisit unresolved transactions and investigate differences without creating new purchases.

From a RizPay sandbox integration to production

Prepare a RizPay integration for live orders with business access, separate keys, tested recovery paths, verified webhooks and a clear reconciliation process.

Verify RizPay webhooks and process events safely

Verify the timestamp and raw-body HMAC signature on RizPay webhooks, then deduplicate events and reconcile purchases without exposing customer data.

Build your business