Payout Status Details

Notify your beneficiaries of their payout details, and know how to troubleshoot when a payout status does not seem right.

Payout Status details are returned when a payout is created and moves to another state.

About 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 fired every time an attribute in status details changes.

It also provides information about payouts in the processing state. If a payout is in the processing state due to deemed success, NEFT/RTGS off hours, and so on; such details are available via Status Details. You can use the information in this object to keep your beneficiaries informed.

Handy Tips

The status details object in the payouts' API response gives details about the exact reason for a payout state and the next steps to be taken. Please share this information with your developers.

Payout Status Responses

Below are the sample status details response code and the complete status details response that appears as part of the status details.

Sample Code

description

string A description for the error. For example, IMPS is not enabled on beneficiary account, Retry with different mode.

source

string Possible values:

gateway: Technical error at Razorpay partner bank.
beneficiary_bank: Technical error at beneficiary bank.
business: Merchant action required.
internal: Technical error at Razorpay's server.

reason

string The error reason. For example, imps_not_allowed.

Payout Status - Reason and Next Steps

All the reasons for any payout state appear at the

source parameter

of the code. The below table lists out the explanations for the sources.

Payout Status Source

Source	Explanation
`gateway`	Technical error at Razorpay partner bank.
`beneficiary_bank`	Technical error at beneficiary bank.
`business`	Merchant action required.
`internal`	Technical error at Razorpay's server.

Payout Status Details and Next Steps

Download the table

to view various payout statuses, and suggests the possible steps you can take to proceed further.

Last Updated on 22nd November, 2022.

Webhooks

You can get notified about these payout statuses and states instantly when you have configured the respective webhooks for it. Webhook notifications reduce the delay in information, and you can choose what states you want to be notified about.

We recommend

setting up webhooks and configuring them

.