Payouts APIs - Razorpay

Available in🇮🇳 India

You can use the Razorpay’s Payout APIs to perform various actions. You can perform most of these actions from the RazorpayX Dashboard as well.

What’s NewYou can now initiate payouts directly to mobile numbers using the Payout Composite API

Watch Out!It is mandatory to allowlist IPs and pass the idempotency key to make a successful payout.

Payout APIs

The table below lists the various endpoints and gives a brief description of each:

API Endpoint	Description
Creates a Payout to a Bank Account	Create a payout to a bank account.
Create a Payout to a VPA	Creates a payout to a VPA.
Fetch a Payout with ID	Retrieves details of one payout via ID.
Fetch all Payouts	Retrieves details of all the payouts.
Cancel a Queued Payout	Cancels a payout in `queued` state.

Payout to Cards APIs

The table below lists the various endpoints and gives a brief description of each:

Watch Out!Payouts via Visa Direct and MasterCard Send are temporarily unavailable. Please watch this space for further updates.

API Endpoint	Description
Make Payouts to Cards without saving cards	Make a payout to a card without saving card details.
Create Fund Account to make Payouts to Externally Tokenised Card	Creates a fund account for a tokenised card via external tokenisation providers.
Make Payouts to Externally Tokenised Card	Makes a payout to a tokenised card via external tokenisation providers.
Create Fund Account to make Payouts to Tokenised Card with Razorpay TokenHQ	Creates a fund account for a tokenised card via via Razorpay Token HQ.
Make Payouts to Tokenised Card with Razorpay TokenHQ	Makes a payout to a tokenised card via via Razorpay Token HQ.

Payout Composite API

The table below lists the various endpoints and gives a brief description of each:

API Endpoint	Description
Create a Composite Payout to Mobile Number	Creates a payout to a contact’s mobile number.
Create a Composite Payout to Bank Account	Creates a payout to a contact’s bank account.
Create a Composite Payout to VPA	Creates a payout to a contact’s VPA (UPI).
Create a Composite Payout to Card	Creates a payout to a contact’s card.

Payout Approval API

The table below lists the various endpoints and gives a brief description of each:

API Endpoint	Description
Approve Payout	Approves the payout.
Reject Payout	Rejects the payout.

Payout Idempotency API

The table below lists the various endpoints and gives a brief description of each:

API Endpoint	Description
Request Idempotent Payout	Requests for an idempotent payout.

Transactions APIs

The table below lists the various endpoints and gives a brief description of each:

API Endpoint	Description
Fetch All Transactions	Retrieves all the transactions made from your business account.
Fetch Transaction with ID	Retrieves a particular transaction.

Payout Status Details

Status details are sent as part of the fetch payout API response and webhook payloads. It provides additional details about each payout status. A payout update webhook is sent every time an attribute in status details changes.