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 in Uganda (MTN, Airtel — UGX, +256) and Kenya (M-Pesa — KES, +254). Use the same API endpoints; set country to UG or KE.

→ Kenya (M-Pesa) guide

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 → Webhook Setup
Chat on WhatsApp