Build payments into your platform
Mazad Wallet gives you a complete financial infrastructure: embedded wallets, payment gateway, subscriptions, and payroll — all through a single REST API.
curl -X POST https://wallet.e-mazad.store/api/v1/embedded/checkout/sessions \
-H "Authorization: Bearer sk_sandbox_abc123" \
-H "Content-Type: application/json" \
-d '{
"external_user_id": "usr_buyer_001",
"amount": 25000,
"currency": "IQD",
"description": "Order #1234"
}'What you can build
Three common integration patterns — pick the one that fits your business.
Marketplace Escrow
Hold buyer funds until delivery is confirmed. Auto-create wallets for every user and move money with a single API call.
Recurring Subscriptions
Create plans, enroll subscribers, and let Mazad handle billing cycles, retries, and lifecycle webhooks automatically.
Mass Payroll
Pay hundreds of workers in a single batch. Upload a CSV or call the API, track each disbursement in real time.
How it works
Four steps to go live with Mazad Wallet.
Get API Keys
Contact our sales team to receive your sandbox credentials and merchant account.
Sync Users
Call POST /users/sync with your user data. Mazad auto-creates a wallet for each user.
Accept Payments
Use the Payment Gateway or Checkout Popup to collect funds into your merchant wallet.
Move Money
Transfer, hold, or release funds between wallets using simple API calls.
Platform highlights
Instant Settlement
Wallet-to-wallet transfers settle immediately. No waiting for bank clearing.
Escrow Built-in
Hold funds until conditions are met, then release or refund with one call.
Multi-Currency
Accept IQD, USD, EUR, SAR, JOD, and TRY with real-time FX conversion.
Supported currencies
All amounts are specified in the smallest unit of the currency (e.g., fils for IQD, cents for USD).
| Code | Currency | Type |
|---|---|---|
| IQD | Iraqi Dinar | Primary |
| USD | US Dollar | Supported |
| EUR | Euro | Supported |
| SAR | Saudi Riyal | Supported |
| JOD | Jordanian Dinar | Supported |
| TRY | Turkish Lira | Supported |
Base URLs
All API requests should be made to one of these base URLs depending on your environment.
| Environment | Base URL |
|---|---|
| Sandbox | https://wallet.e-mazad.store/api/v1 |
| Production | https://wallet.e-mazad.store/api/v1 |
Sandbox credentials
sk_sandbox_. Contact our sales team to get your sandbox and production keys.Ready to integrate Mazad into your platform?
Our team will review your business and issue your production API keys within 2 business days.