PAYOUT GATEWAY

Create Payout Request

Initiate automated fiat distribution directly into Indian bank accounts or UPI handles using your active USDT merchant balance.

POST/api/payout/create

Body Authentication Parameter

Pass your merchant secret API key inside the request JSON payload as: "api_key": "YOUR_MERCHANT_API_KEY".

Request Sample

BASH

curl -X POST https://onnxpay.com/api/payout/create \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_MERCHANT_API_KEY",
    "amount_inr": 1000,
    "amount_usdt": 11.11,
    "exchange_rate": 90.00,
    "recipient_name": "Rajesh Kumar",
    "payout_method": "BANK",
    "account_number": "918273645102",
    "ifsc_code": "SBIN0001234",
    "bank_name": "State Bank of India"
  }'

Request Parameters

Field	Type	Requirement	Description
api_key	string	Required	Merchant secret API Key.
amount_inr	number	Required	Amount in Indian Rupees (INR) to be transferred to recipient.
amount_usdt	number	Required	USDT equivalent value before platform payout fee.
exchange_rate	number	Required	Conversion exchange rate. Must satisfy: `amount_inr / amount_usdt ≈ exchange_rate`.
recipient_name	string	Required	Full legal name of the bank account / UPI VPA holder.
payout_method	string	Required	Set to either `"BANK"` or `"UPI"`.
account_number	string	Conditional	Bank Account Number (Required if `payout_method === "BANK"`).
ifsc_code	string	Conditional	Bank IFSC Code (Required if `payout_method === "BANK"`).
upi_id	string	Conditional	UPI Virtual Payment Address (Required if `payout_method === "UPI"`).

Response Payload

A successful response will return a `200 OK` status, lock `net_debit_usdt` in merchant payout escrow, and return the payout reference details:

JSON

{
  "success": true,
  "message": "Payout order created successfully",
  "payoutId": "payout_981a28bf20a1",
  "amount_inr": 1000,
  "amount_usdt": 11.11,
  "fee_usdt": 0.44,
  "net_debit_usdt": 11.55,
  "exchange_rate": 90,
  "status": "unassigned"
}