Frequently asked questions and answers about MarzPay integration.

General

What countries does MarzPay support?

Uganda, Kenya, Rwanda, DRC, Zambia, Cameroon, Benin, Côte d’Ivoire, Gabon, Congo-Brazzaville, Senegal, and Sierra Leone.

General

What currencies are supported?

UGX, KES, RWF, CDF, USD, ZMW, XAF, XOF, and SLE.

General

How do I get started?

Sign up at the MarzPay Dashboard, complete KYC, get your API keys, and start with Sandbox Mode.

Getting started

Technical

Do I need PCI-DSS compliance?

Only if you handle raw card data. Use the redirect URL method for card payments to reduce compliance scope.

Technical

Can I test without real money?

Yes. Use Sandbox Mode with sandbox API keys to test all endpoints without processing real transactions.

Technical

How do I verify webhooks?

Verify the x-marzpay-signature header using your webhook signing secret and HMAC-SHA256.

Technical

Are webhooks retried?

Yes. Up to 5 attempts with exponential backoff if your endpoint does not return HTTP 200.

Technical

Payments

How long do collections take?

Typically 30 seconds to 2 minutes. The customer must approve the payment on their phone.

Payments

How long do disbursements take?

Typically 1-5 minutes for mobile money. Bank transfers take 1-3 business days.

Payments

Can I refund a payment?

Refunds are processed through the Dashboard or by contacting support. API refund endpoints coming soon.

Payments

Fees

How much do collections cost?

Fees vary by country and network, typically 0.8% to 2.0% of the amount. See Public Pricing for details.

Fees

Are there fees for airtime and data?

No. Airtime and data bundle purchases are free.

Fees

Support

Need more help? Contact us:

Email

WhatsApp

Phone

(+256) 790 809 954

Support
API Playground - Test all endpoints live