West & Central Africa

Collect and send money across Benin, Côte d’Ivoire, Gabon, Congo-Brazzaville, Senegal, and Sierra Leone using mobile money. Transactions are processed in XOF (West African CFA Franc), XAF (Central African CFA Franc), and SLE (Sierra Leonean Leone).

Supported countries and networks

Benin

Networks: MTN, Moov

XOF

Côte d'Ivoire

Networks: MTN, Moov, Orange

XOF

Gabon

Networks: MTN, Airtel

XAF

Congo-Brazzaville

Networks: MTN, Airtel

XAF

Senegal

Networks: Orange, Free, Moov

XOF

Sierra Leone

Networks: Orange, Africell

SLE

Currencies by country

Country	Currency	Code	Phone prefix
Benin	West African CFA Franc	XOF	+229
Côte d’Ivoire	West African CFA Franc	XOF	+225
Gabon	Central African CFA Franc	XAF	+241
Congo-Brazzaville	Central African CFA Franc	XAF	+242
Senegal	West African CFA Franc	XOF	+221
Sierra Leone	Sierra Leonean Leone	SLE	+232

Collecting money

Initialize collection

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

Customer confirms

The customer approves the transaction via their mobile money PIN.

Receive webhook

MarzPay sends a webhook with the final transaction status.

Example: Initialize a Senegalese 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": "XOF",
    "phone": "+221700123456",
    "network": "ORANGE",
    "callback_url": "https://your-app.com/webhooks/collections"
  }'

{
  "status": "success",
  "data": {
    "reference": "MZ_COL_20240115_pqr678",
    "amount": 5000,
    "currency": "XOF",
    "phone": "+221700123456",
    "network": "ORANGE",
    "status": "pending",
    "checkout_url": "https://wallet.wearemarz.com/checkout/MZ_COL_20240115_pqr678"
  }
}

Fees

Country	Network	Fee	Minimum	Maximum
Benin	MTN / Moov	1.5%	100 XOF	5000 XOF
Côte d’Ivoire	MTN / Moov / Orange	1.5%	100 XOF	5000 XOF
Gabon	MTN / Airtel	1.5%	100 XAF	5000 XAF
Congo-Brazzaville	MTN / Airtel	1.5%	100 XAF	5000 XAF
Senegal	Orange / Free / Moov	1.5%	100 XOF	5000 XOF
Sierra Leone	Orange / Africell	2.0%	1000 SLE	20000 SLE

Phone number format

All phone numbers must use the international format:

Correct: +221700123456
Incorrect: 0700123456

API Playground - West & Central Africa - Test all West and Central African endpoints live

Markets

East Africa

Central Africa

Southern Africa

West Africa

Supported countries and networks

Benin

Côte d'Ivoire

Gabon

Congo-Brazzaville

Senegal

Sierra Leone

Currencies by country

Collecting money

Example: Initialize a Senegalese collection

Fees

Phone number format

​Supported countries and networks

Benin

Côte d'Ivoire

Gabon

Congo-Brazzaville

Senegal

Sierra Leone

​Currencies by country

​Collecting money

​Example: Initialize a Senegalese collection

​Fees

​Phone number format

Supported countries and networks

Currencies by country

Collecting money

Example: Initialize a Senegalese collection

Fees

Phone number format