Powerful APIs, SDKs, and tools to integrate mobile money payments into your application.
Simple, predictable REST APIs with JSON responses. Accept payments, manage customers, and more.
View API DocsReal-time event notifications for payments, refunds, and disputes sent to your endpoint.
Get started with Rwanda Pay in minutes
Sign up for a merchant account and generate your API keys from the dashboard.
Use Hosted Checkout (redirect) or Direct API (USSD on customer's phone).
Test in sandbox, then switch to live mode and start accepting payments.
Redirect customers to our secure payment page. We handle the entire payment flow.
Initiate payments directly via API. Customer receives USSD prompt on their phone.
Test the checkout API directly from your browser (sandbox mode).
Initialize a hosted checkout page with just a few lines of code:
<?php
$ch = curl_init('https://api.rwandapay.rw/api/v1/checkout/initialize');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'amount' => 5000,
'tx_ref' => 'ORDER-' . time(),
'customer' => [
'name' => 'John Doe',
'email' => 'john@example.com',
'phone' => '0788123456'
]
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-Public-Key: YOUR_PUBLIC_KEY',
'X-Secret-Key: YOUR_SECRET_KEY',
'Content-Type: application/json',
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
$payment_url = $data['data']['payment_url'];
// Redirect customer to $payment_url
const response = await fetch('https://api.rwandapay.rw/api/v1/checkout/initialize', {
method: 'POST',
headers: {
'X-Public-Key': 'YOUR_PUBLIC_KEY',
'X-Secret-Key': 'YOUR_SECRET_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 5000,
tx_ref: `ORDER-${Date.now()}`,
customer: {
name: 'John Doe',
email: 'john@example.com',
phone: '0788123456'
}
})
});
const data = await response.json();
window.location.href = data.data.payment_url;
Accelerate your integration with our official SDKs
composer require rwandapay/php-sdk
npm install rwandapay-js
pip install rwandapay
Maven: com.rwandapay
Get started with our SDKs and documentation in minutes.