Getting Started with Marz Pay

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

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://wallet.wearemarz.com/api/v1

Example API Endpoints

  • https://wallet.wearemarz.com/api/v1/collect-money - Collect payments from customers
  • https://wallet.wearemarz.com/api/v1/send-money - Send money to customers
  • https://wallet.wearemarz.com/api/v1/transactions - View transaction history
  • https://wallet.wearemarz.com/api/v1/balance - Check account balance
  • https://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 Marz Pay 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

4. Making Your First Transaction

Marz Pay 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"'

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 Reference → Collections Guide → Send Money Guide → Webhook Setup