API reference

izigate API

A small REST API with JSON in and out. Base URL: https://gate.izipay.me/api/v1

Authentication

Create an API key in your dashboard under API Keys and send it as a Bearer token with every request. Keep it on your server, never in the browser.

Authorization: Bearer izpk_live_YOUR_KEY

Every response has the form {"success": true, "data": {…}}, or {"success": false, "error": {…}} with a 4xx status.

Create a payment

POST /payments

Creates a payment and returns a unique deposit address. Show the address and the amount to your customer, as text or as a QR code.

FieldRequiredDescription
price_amountYesAmount to collect in USD, for example 100.00.
pay_currencyYesWhat the customer pays with. See Coins.
order_idNoYour order reference. It comes back in webhooks.
order_descriptionNoFree text description.
ipn_callback_urlNoWebhook URL for this payment only, overrides the one in your dashboard.
sandboxNotrue with a test key to create a test payment.
# cURL
curl -X POST https://gate.izipay.me/api/v1/payments \
  -H "Authorization: Bearer izpk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price_amount": 100.00, "pay_currency": "usdttrc20", "order_id": "order-1042"}'
// Node.js
const res = await fetch("https://gate.izipay.me/api/v1/payments", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.IZIGATE_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ price_amount: 100, pay_currency: "usdttrc20", order_id: "order-1042" })
});
const { data } = await res.json();
console.log(data.pay_address, data.pay_amount);
# Python
import requests
r = requests.post("https://gate.izipay.me/api/v1/payments",
    headers={"Authorization": "Bearer izpk_live_YOUR_KEY"},
    json={"price_amount": 100, "pay_currency": "usdttrc20", "order_id": "order-1042"})
data = r.json()["data"]

Response:

{
  "success": true,
  "data": {
    "payment_id": "7cc73692-b5d3-402d-9c15-6495bcc7a3d7",
    "status": "waiting",
    "pay_address": "TY7vA68AS2s6tN7Fe7xqEdusCfpPBcJBc8",
    "pay_amount": 100,
    "pay_currency": "usdt",
    "network": "trc20",
    "price_amount": 100,
    "expires_at": "2026-09-19 08:38:43",
    "qr_data": "TY7vA68AS2s6tN7Fe7xqEdusCfpPBcJBc8"
  }
}

Get a payment

GET /payments/{payment_id}
GET /payments?limit=50&status=confirmed

Poll a single payment or list your payments. Most integrations just wait for the webhook.

Statuses

StatusMeaning
waitingThe address is open, nothing confirmed yet.
confirmedThe payment is confirmed on chain and credited to your balance.
partially_paidLess than the amount arrived.
expiredNothing arrived before expires_at.
failedThe payment could not be processed.

Webhooks

Set your endpoint in the dashboard under Webhooks. It must be a public https:// URL. Each event is a JSON POST with an X-Signature header: HMAC-SHA256 of the raw body with your signing secret (whsec_…).

Events: payment.confirmed, payment.partial, payment.failed, payout.pending, payout.completed, payout.failed.

{
  "id": "evt_f360f9685e79bf88b60050fe",
  "type": "payment.confirmed",
  "created": 1789656000,
  "data": {
    "payment_id": "7cc73692-b5d3-402d-9c15-6495bcc7a3d7",
    "order_id": "order-1042",
    "status": "confirmed",
    "pay_currency": "USDT",
    "network": "trc20",
    "amount_paid": 100,
    "amount_usd": 100,
    "fee_usd": 1,
    "credited_usd": 99,
    "balance_usd": 99
  }
}
// PHP: verify the signature
$raw = file_get_contents("php://input");
$expected = hash_hmac("sha256", $raw, "whsec_YOUR_SIGNING_SECRET");
if (!hash_equals($expected, $_SERVER["HTTP_X_SIGNATURE"] ?? "")) { http_response_code(400); exit; }
$event = json_decode($raw, true);
if ($event["type"] === "payment.confirmed") { /* mark the order as paid */ }
http_response_code(200);
// Node.js (raw body)
const sig = crypto.createHmac("sha256", process.env.IZIGATE_WHSEC).update(req.rawBody).digest("hex");
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(req.get("X-Signature") || ""))) return res.sendStatus(400);

Balance

GET /gateway/balance

Your balance (confirmed payments minus fees and payouts) and the latest ledger entries.

Payouts

POST /payouts
{ "amount_usd": 250, "network": "trc20", "currency": "usdt", "address": "TYourWallet…" }

GET /payouts

Withdraws your balance to your own wallet. The minimum is $10. The amount is reserved immediately and a flat network fee is deducted from it, so your wallet receives amount_usd minus the fee. The response shows both network_fee and net_amount. Payouts are sent automatically in USDT on Tron (trc20), BNB Chain (bsc), Polygon (polygon) or Ethereum (eth), usually within a few minutes, and you get a payout.completed webhook with the transaction hash. Limit $1,000 per 24 hours.

Auto settlement

Turn on auto settlement in Settings and add a Tron USDT address. Each confirmed USDT payment on Tron is then forwarded straight to your wallet, minus the 1% fee and the Tron network fee, without going through your balance.

Coins

NetworkCoinspay_currency
Tron (TRC20)USDT, USDC, TRXusdttrc20, usdctrc20, trx
BNB Smart ChainUSDT, BNBusdtbsc, bnb
PolygonUSDTusdtpolygon
Ethereum (ERC20)USDT, ETHusdterc20, eth
SolanaUSDT, SOLusdtsol, sol
BitcoinBTCbtc

Fees

No monthly fee. From each confirmed payment we deduct 1% and a flat network fee that covers the gas of moving the payment to our pool. The payment.confirmed webhook shows fee_usd, network_fee_usd and credited_usd. Payouts have their own flat network fee:

NetworkNetwork fee per paymentNetwork fee per payout
Tron (TRC20)$3.00$3.00
BNB Smart Chain$0.10$0.50
Polygon$0.10$0.20
Ethereum (ERC20)$4.00$3.00
Solana$0.30no payouts
Bitcoin$2.00no payouts

Sandbox

Ask support@izipay.me for a test key (prefix izpk_test_). Create a payment with "sandbox": true, then confirm it without real crypto:

curl -X POST https://gate.izipay.me/api/v1/sandbox/confirm \
  -H "Authorization: Bearer izpk_test_YOUR_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payment_id": "PAYMENT_ID_FROM_CREATE"}'

You receive the same webhook as in production. Sandbox payments never change your real balance, and test keys cannot request payouts.

Questions? Write to support@izipay.me.