IQIraQPayAPI Reference

Quickstart

This guide will help you get set up and ready to use the IraQPay Integration API: where your credentials come from, which base URL to call and how to make your first request.

Getting started

Before making any requests you must obtain your Application Key and Application Secret from the IraQPay team (they are shown once in the operator panel under Site → API). After that, share with us:

  • the IP addresses you will send requests from (optional allowlist; required if you want pay-outs restricted to your servers),
  • your Callback URL (HTTPS) where transaction results will be delivered.

Using the key and secret

Include your Application Key in every request in the header appKey. Use the Application Secret to generate the mandatory sign header — see Signature. The same secret verifies callback data we send to you.

Never ship the secret to a browser or mobile app. All calls must originate from your backend.

Base URL

BASEhttps://api.deuspay.co

Sandbox / staging: https://api-staging.deuspay.co (separate credentials; no real money moves). Interactive OpenAPI is available at /docs on both hosts.

Your first request

Fetch the wallet methods enabled for your site. GET requests sign an empty string.

APP_KEY="your_app_key"; SECRET="your_app_secret"
SIGN=$(printf "" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64)
curl "https://api.deuspay.co/v1/available-banks" \
  -H "appKey: $APP_KEY" -H "sign: $SIGN"
import { createHmac } from "node:crypto";
const sign = createHmac("sha256", process.env.IQPAY_SECRET).update("").digest("base64");
const res = await fetch("https://api.deuspay.co/v1/available-banks", {
  headers: { appKey: process.env.IQPAY_APP_KEY, sign },
});
console.log(await res.json());
<?php
$sign = base64_encode(hash_hmac('sha256', '', $SECRET, true));
$ch = curl_init('https://api.deuspay.co/v1/available-banks');
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["appKey: $APP_KEY", "sign: $sign"]]);
$json = json_decode(curl_exec($ch), true);

What's next?