Introduction
Learn about the RizPay API and how it enables bill payments in your application
The RizPay API enables businesses and developers to integrate bill payment capabilities directly into their applications. Provide your users with seamless access to airtime, data plans, electricity, and cable TV payments.
Who is this for?
The RizPay API is designed for:
- Fintech applications adding bill payment features
- E-commerce platforms offering value-added services
- Mobile wallets expanding payment options
- Business applications automating recurring payments
What can you do?
| Feature | Description |
|---|---|
| Airtime | Purchase airtime for MTN, Airtel, Glo, and 9mobile |
| Data Plans | Buy daily, weekly, or monthly data bundles |
| Electricity | Pay prepaid and postpaid electricity bills |
| Cable TV | Subscribe to DStv, GOtv, and Startimes |
| Webhooks | Receive real-time transaction notifications |
Key Features
Simple Integration
RESTful API with predictable resource-oriented URLs. JSON request and response bodies.
curl -X GET \
-H "Authorization: Bearer sk_live_your_secret_key" \
https://my.rizpay.app/api/partners/v1/account/balance
Business Pricing
Developers enjoy discounted rates compared to retail pricing. Volume-based bonuses available for high-transaction businesses.
Real-time Webhooks
Stay informed about transaction status changes. Automatic retries ensure delivery. Detailed logs for debugging.
Sandbox Environment
Test your integration without affecting real accounts or making real purchases. The sandbox mirrors production behavior exactly.
Granular Permissions
Scoped API keys let you grant only the permissions needed. Create separate keys for different use cases.
Base URLs
| Environment | URL |
|---|---|
| Production | https://my.rizpay.app/api/partners/v1 |
| Sandbox | https://my.rizpay.app/api/partners/sandbox/v1 |
Getting Started
- Sign in or Create Account - Already have an account? Sign in. New to RizPay? Create an account
- Upgrade to Business at Settings > API Keys
- Generate API Keys from the same page after upgrading
- Start Building using this documentation
Next Steps
- Quick Start - Make your first API call
- Authentication - Understand API keys and scopes
- Error Handling - Handle errors gracefully