Call any endpoint with your API keys — no Postman required. Open API playground

Getting Started with

Welcome to ! This guide will help you set up your account and start processing payments quickly.

Download integration guide (PDF) Open API playground API reference

1. Account Setup

1

Visit the landing page and click "Get Started" or "Sign Up"

2

Fill in your business information and verify your email

3

Complete your profile by uploading required business documents

2. API Base URL

All API requests should be made to the following base URL:

https://demo-wallet.wearemarz.com/api/v1

Example API Endpoints

  • https://demo-wallet.wearemarz.com/api/v1/collect-money - Collect payments from customers
  • https://demo-wallet.wearemarz.com/api/v1/send-money - Send money to customers
  • https://demo-wallet.wearemarz.com/api/v1/transactions - View transaction history
  • https://demo-wallet.wearemarz.com/api/v1/balance - Check account balance
  • https://demo-wallet.wearemarz.com/api/v1/phone-verification/verify - Verify phone numbers

3. API Keys & Authentication

API keys are required to authenticate your requests to the API.

1

Navigate to API Keys in your dashboard

2

Click "Generate New API Key" and provide a descriptive name

3

Copy and securely store your API key - it won't be shown again

Supported markets

supports mobile money collections and disbursements across:

Market Country Currency Mobile money Phone format
Uganda UG UGX MTN, Airtel +256…
Kenya KE KES M-Pesa +254…
Rwanda RW RWF MTN, Airtel +250…
DRC CD CDF & USD Vodacom, Airtel, Orange +243…
Zambia ZM ZMW MTN, Airtel, Zamtel +260…
Cameroon CM XAF MTN, Orange +237…
Benin BJ XOF MTN, Moov +229…
Côte d'Ivoire CI XOF MTN, Orange +225…
Gabon GA XAF Airtel +241…
Congo-Brazzaville CG XAF MTN, Airtel +242…
Senegal SN XOF Orange, Free +221…
Sierra Leone SL SLE Orange +232…

Use the same API endpoints; set country to UG, KE, RW, CD, ZM, CM, BJ, CI, GA, CG, SN, or SL. For DRC, also send currency as CDF (default) or USD.

→ Kenya guide → Rwanda guide → DRC guide → Zambia guide → Cameroon guide → West Africa guide → Pricing

4. Making Your First Transaction

supports two main transaction types: Collections (receiving money from customers) and Send Money (sending money to customers).

Collect Money from Customer

Request payment from a customer's mobile money account:

curl --location 'https://wallet.wearemarz.com/api/v1/collect-money' \
--header 'Authorization: Basic YOUR_API_CREDENTIALS' \
--form 'phone_number="+256700000000"' \
--form 'amount="1000"' \
--form 'country="UG"' \
--form 'reference="123e4567-e89b-12d3-a456-426614174000"' \
--form 'description="Payment for services"' \
--form 'callback_url="https://your-app.com/webhook"' \
--form 'metadata=[{"orderId":"ORD-123"},{"customerId":"customer@email.com","isPII":true}]'

metadata is optional — echoed on create and webhooks. See Collections.

Send Money to Customer

Send payment to a customer's mobile money account:

curl --location 'https://wallet.wearemarz.com/api/v1/send-money' \
--header 'Authorization: Basic YOUR_API_CREDENTIALS' \
--form 'phone_number="+256700000000"' \
--form 'amount="1000"' \
--form 'country="UG"' \
--form 'reference="123e4567-e89b-12d3-a456-426614174000"' \
--form 'description="Payment to customer"' \
--form 'callback_url="https://your-app.com/webhook"'

4. Testing Your Integration

Sandbox Mode

New accounts start in sandbox mode where you can test all features without processing real payments or creating actual transactions.

Important: In sandbox mode:

  • • No real transactions are created
  • • No real money is processed
  • • All APIs return dummy responses
  • • Perfect for testing your integration

What's Next?

→ API playground → API Reference → Collections Guide → Send Money Guide → Kenya (M-Pesa) Guide → Rwanda Guide → DRC Guide → Webhook Setup
Chat on WhatsApp