RizPay Developer API

Your users. Your app. Nigeria's bill payments.

You know your users. You decide how they fund their account. You use our API to offer them airtime, data, electricity, and cable TV. Read your product costs from the catalogue and set the retail price your customers pay in your own app.

Your app, your brand
Set your retail prices
SDKs in four languages

Airtime, data, electricity and cable TV through one API. Check the current catalogue for product availability.

4
Networks (Airtime)
Prepaid / postpaid
DisCos (Electricity)
3
Cable Providers

By integrating you agree to the Partner Agreement.

Choose what you want to build

Find a network or biller, connect your server and learn how to recover an unresolved purchase.

How the RizPay API works

You bring the users. We bring the infrastructure. You keep the margin.

You own the user relationship

Your users authenticate with your app. You control their experience. We are invisible infrastructure: no RizPay branding, no redirects, no separate login.

You control funding

Your application controls customer payment collection. Keep your customer payment records separate from the purchases billed to your RizPay partner account.

Set your retail prices

Read product costs from the catalogue and set retail prices in your own system. Your checkout collects your markup; any separately agreed partner incentive is a different calculation.

Four product categories, one API

Airtime (MTN, Airtel, Glo, 9mobile), data plans, electricity (all DisCos), and cable TV (DStv, GOtv, Startimes). One integration covers everything.

Webhooks for real-time events

Get notified on purchase success, failure, and reversal. Every webhook is signed with HMAC-SHA256 so you can verify it came from us.

Full sandbox environment

Test every product category without moving real money. Sandbox API keys are separate from production, so you can build and verify before going live.

Why choose RizPay?

Everything you need to build and grow a bill payment business on top of our platform.

Competitive rates

Earn a margin on every transaction. Volume bonuses available for high-transaction partners.

Fast integration

Single API for all bill payment categories. Clear documentation, code examples, and a full sandbox so you can go from zero to live quickly.

Secure infrastructure

Use scoped server-side API keys and verify signed webhook events. Keep customer authorization and secret management in your own server application.

Real-time transaction events

Webhooks for every transaction event - success, failure, and reversal, with automatic retries on failed deliveries.

Built for developers

Clear docs, working code examples, and a sandbox that mirrors production. No surprises when you go live.

Dedicated support

Priority support for API partners. We are here to help you ship and succeed.

Simple Integration

Start by reading the sandbox catalogue. Keep your API key on your server.

// Node.js server: list products before creating an order.
const response = await fetch(
  'https://my.rizpay.app/api/partners/sandbox/v1/products/airtimes?network=MTN',
  { headers: { Authorization: `Bearer ${process.env.RIZPAY_API_KEY}` },
    signal: AbortSignal.timeout(20000), redirect: 'error' }
);
if (!response.ok) throw new Error('Check API access and try again.');
const catalogue = await response.json();
// Select an ID from catalogue.data. Keep your key on the server.

Official SDKs in four languages

Fully typed clients for TypeScript, Python, PHP and Ruby. Real methods, real models, autocomplete in your editor: skip the hand-rolled HTTP layer and ship your first purchase call today.

TypeScript

@rizpay/sdk

ES6, fully typed interfaces

Install from GitHub

Python

rizpay

Built on httpx

Install from GitHub

PHP

rizpay/rizpay-php

Namespace RizPay

Install from GitHub

Ruby

rizpay

Built on Faraday, Ruby >= 3.0

Install from GitHub
Every client is always in step with the Developer API you integrate against.

Docs your AI agent can actually read

Point your AI coding agent at our documentation and it writes a correct integration, because the docs are machine-readable by design, not just human-readable.

Connect your coding agent

Claude, Cursor, and any other MCP client can search and read our documentation while it writes your integration, so it works from the real contract instead of guessing.

Built for LLM context

The whole documentation set is published as clean plain text an assistant can read in a single pass, so it starts with complete, current context instead of scraped fragments.

Markdown, not scraped HTML

Every documentation page is available as clean markdown, so your tooling reads exactly what you read. No parsers, no scrapers, no drift.

One click to your assistant

Every page has a menu to copy it as markdown or open it straight in Claude or ChatGPT, so you can ask questions about the exact page you are reading.

Products Supported

Explore the product workflows, then check the current catalogue for availability and partner costs.

Airtime

MTN, Airtel, Glo, 9mobile

  • Network selection
  • Amount limits
  • Status tracking
Explore Airtime API

Data Plans

Daily, weekly, monthly bundles

  • Bundle discovery
  • Catalogue costs
  • Validity fields
Explore Data Plans API

Electricity

Check current distributor availability

  • Meter verification
  • Prepaid & postpaid
  • Token retrieval
Explore Electricity API

Cable TV

DStv, GOtv, Startimes

  • Package discovery
  • Decoder verification
  • Purchase tracking
Explore Cable TV API

Your cost, selling price and margin

Your customers pay you through your own application. Production API purchases debit your funded partner account. Reconcile the final transaction debit and fees against the retail total you collected.

Set your retail price

The catalogue gives you your product cost. You decide the retail price in your own app and collect your markup through your own checkout.

Free sandbox to build in

Build and verify your whole integration on a sandbox key, with simulated purchases. Sandbox balances and purchases never move real money.

One integration, four categories

Airtime, data, electricity and cable TV run through one API. Build once, then sell across every category you enable, priced from the live catalogue.

Volume terms, product by product

Tell us your product mix and expected purchase volume and we will work out terms that fit. Terms are set per product, never one blanket rate.

Is my resale margin an API commission?

Your resale markup stays in your own checkout. It is not automatically credited to your RizPay wallet. Any separate incentive follows your agreed terms; there is no universal commission rate to assume.

A markup is not net profit. Account for the final purchase debit, customer payment costs, refunds and other direct costs before evaluating your contribution. Use your authenticated catalogue and transaction records, not a price embedded in a product name.

Rate limits are set per API key and published live in your response headers, fully documented here, so you never have to guess.
Create a developer account

Comparing products? Browse the public product catalogue. For your API account costs, use the authenticated catalogue and agreed terms. Running high volume? Talk to us about terms.

Rather We Built It?

Not every partner wants to write the integration themselves. Our team can build it into your existing product, or build the whole thing from scratch.

Integrate into what you already have

Running a product with real users already? Our team integrates the Developer API directly into your existing app or platform, so bill payments become one more thing it already does.

Build your app from scratch

Starting from zero? We design and build a complete customer-facing app, mobile and web, on top of the same rails you would otherwise integrate yourself.

Ship it under your brand

The API is invisible infrastructure: no RizPay branding, no redirects. Whatever we build for you carries your brand from the first screen to the last.

Start Building Today

Create an account and follow the business-access steps in API settings. Then create a sandbox key and test the full purchase flow.

Sandbox purchases are simulated. They do not deliver real services.