v1

latestOpenAPI 3.0.0Proprietary2026-07-1313647393.0 KB

X Payouts

Create a payout

Disburse funds via NEFT, RTGS, IMPS, UPI, or card. Supports standard payouts (fund_account_id), composite payouts (contact + fund account inline), card payouts (PCI DSS required), and mobile number payouts (resolved via NPCI mapper). Idempotency header X-Payout-Idempotency (UUID v4, 4–36 chars) is mandatory since March 15, 2025. Never generate a new idempotency key while a payout is in 'processing' state.

post/payouts

Headers

X-Payout-Idempotencystring required

UUID v4 idempotency key. Mandatory since March 15, 2025.

Request body

account_numberstring required

Razorpay X account number to debit

fund_account_idstring

Required for standard payouts; omit for composite

fund_accountobject

Inline fund account for composite payout

amountinteger required

Amount in paise

currency'INR' required

Case-sensitive

narrationstring

reference_idstring

notesobject

queue_if_low_balanceboolean

true: queue payout when account balance is insufficient (default: false)

Response

Payout created

idstring

Payout ID (pout_*)

entity'payout'

fund_account_idstring

amountinteger

Amount in paise (min 100)

currency'INR'

feesinteger

taxinteger

Transfer mode — case-sensitive. amazonpay limited to ₹10,000 per transaction; no custom narration allowed.

utrstring

Unique Transaction Reference from bank

reference_idstring

debit_account_numberstring

narrationstring

fee_typestring

batch_idstring

notesobject

created_atinteger

queue_if_low_balanceboolean

true: queue payout when account balance is insufficient. false (default): fail immediately.