API Documentation
Welcome to the API documentation for the IraQPay payment platform. IraQPay lets your users deposit and withdraw with Iraqi wallets — FIB, Qi Card, Switch, FastPay, ZainCash, AsiaPay and Nass Wallet — through a single, signed REST API. Follow the steps below to begin the integration.
Quickstart
Get your credentials, learn the base URL and make your first request.
Read more →Signature
How to sign every request with your API Secret (HMAC-SHA256).
Read more →Available Banks
Fetch the wallet methods enabled for your site and show them to your user.
Read more →Deposit
Create a deposit request and show the user exactly where to send the money.
Read more →Withdraw
Send a payout to your user's wallet number, card or account.
Read more →Callback Verification
Verify callback data and process each result exactly once.
Read more →How it works
- Your user chooses a wallet from the list returned by Available Banks and enters an amount in IQD.
- You create a deposit. IraQPay allocates a receiving account and returns the recipient name and wallet number (
bankAccountName,bankAccountIban) plus an expiry time. - The user sends the exact amount from their own wallet app. Our operators match the incoming transfer.
- We call your webhook with
status: "successful"(orunsuccessful). You verify the signature and credit the user. - Withdrawals work the same way in reverse: you send the recipient details, we pay out and call your webhook when done.
All amounts are in Iraqi Dinar (IQD), as plain numbers without thousands separators (e.g.
25000). Deposits must be a multiple of the step configured for your site (default 250 IQD).