Embedded Wallet
Give every user on your platform a Mazad wallet — without them needing to download the Mazad app. Sync users, read balances, and accept payments through a hosted checkout popup.
How it works
Three capabilities
The Embedded Wallet API is organized around three actions: sync users, read data, and collect payments.
User Sync
Mirror your user base into Mazad. Each synced user automatically receives a wallet with IQD and multi-currency sub-wallets.
Read Wallets & Transactions
Query balances, list transactions, and retrieve wallet metadata for any user in your platform — all server-side.
Checkout Popup
Drop a pre-built payment popup into your frontend. Users pay from their Mazad wallet, you get a webhook and settlement.
Integration flow
Sync your users
POST /embedded/users/sync with your user IDs. Mazad creates wallets automatically.
Display balances
GET /embedded/users/{id}/wallet to show wallet balances inside your UI.
Create a checkout session
POST /embedded/checkout/sessions to get a session token for the popup.
Open the popup
Call MazadCheckout.open() in the browser. User confirms payment. You get a webhook.
Handle the result
Poll GET /embedded/payments/{id} or listen for the payment.completed webhook.
No app download required
Ready to integrate Mazad into your platform?
Our team will review your business and issue your production API keys within 2 business days.