Rwanda (MTN / Airtel)

Collect and send money in Rwanda using MTN and Airtel mobile money. All transactions are processed in RWF (Rwandan Francs) with +250 phone numbers.

Supported networks

MTN Rwanda

Supports collections and disbursements.

CollectionsDisbursements

Airtel Rwanda

Supports collections and disbursements.

CollectionsDisbursements

Collecting money

Initialize collection

Call the collections initialize endpoint with the customer’s phone number, amount, and network.

Customer confirms

The customer receives a mobile money prompt to enter their PIN and approve the transaction.

Receive webhook

MarzPay sends a webhook with the final transaction status.

Example: Initialize a Rwandan collection

Tab Title
Tab Title

curl -X POST https://api.wearemarz.com/v1/collections/initialize \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "RWF",
    "phone": "+250700123456",
    "network": "MTN",
    "callback_url": "https://your-app.com/webhooks/collections"
  }'

{
  "status": "success",
  "data": {
    "reference": "MZ_COL_20240115_def456",
    "amount": 5000,
    "currency": "RWF",
    "phone": "+250700123456",
    "network": "MTN",
    "status": "pending",
    "checkout_url": "https://wallet.wearemarz.com/checkout/MZ_COL_20240115_def456"
  }
}

Sending money (disbursements)

curl -X POST https://api.wearemarz.com/v1/disbursements/send \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "RWF",
    "phone": "+250700123456",
    "network": "MTN",
    "reference": "INV-2024-002",
    "callback_url": "https://your-app.com/webhooks/disbursements"
  }'

Fees

Transaction type	Network	Fee	Minimum	Maximum
Collection	MTN	1.5%	100 RWF	2000 RWF
Collection	Airtel	1.5%	100 RWF	2000 RWF
Disbursement	MTN	1.0%	50 RWF	1000 RWF

Phone number format

All Rwandan phone numbers must use the international format:

Correct: +250700123456
Incorrect: 0700123456
Incorrect: 250700123456

API Playground - Rwanda - Test MTN and Airtel endpoints live

Markets

East Africa

Central Africa

Southern Africa

West Africa

Supported networks

MTN Rwanda

Airtel Rwanda

Collecting money

Example: Initialize a Rwandan collection

Sending money (disbursements)

Fees

Phone number format

​Supported networks

MTN Rwanda

Airtel Rwanda

​Collecting money

​Example: Initialize a Rwandan collection

​Sending money (disbursements)

​Fees

​Phone number format

Supported networks

Collecting money

Example: Initialize a Rwandan collection

Sending money (disbursements)

Fees

Phone number format