Build payments into your platform
Mazad Cash gives you a complete financial infrastructure: embedded wallets, a payment gateway, and multi-currency FX — 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.
How it works
Four steps to go live with Mazad Cash.
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.