CUcurlec
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

Request

  • Base URL
    https://api.razorpay.com/v1
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization codehttps://mcp.razorpay.com/authorize
      Client credentials
      Token URLhttps://mcp.razorpay.com/token
      Scopesread_only
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

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
mode'NEFT' | 'RTGS' | 'IMPS' | 'UPI' | 'card' | 'amazonpay' required

Case-sensitive

purpose'refund' | 'cashback' | 'payout' | 'salary' | 'utility bill' | 'vendor bill' required
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
mode'NEFT' | 'RTGS' | 'IMPS' | 'UPI' | 'card' | 'amazonpay'

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
purpose'refund' | 'cashback' | 'payout' | 'salary' | 'utility bill' | 'vendor bill'
fee_typestring
status'queued' | 'pending' | 'rejected' | 'processing' | 'processed' | 'cancelled' | 'reversed' | 'failed'
batch_idstring
notesobject
created_atinteger
queue_if_low_balanceboolean

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

Changes

No recorded changes to this operation across all 1 revision of this API.