Payout States and Life Cycle

Payout Life Cycle

The following flow illustrates the various states in the payout life cycle:

Payout States

Following are the various payout states:

• pending
• queued
• scheduled
• processing
• processed
• reversed
• cancelled
• rejected
• failed

Pending

If you have the

At this stage, the payout details are stored in the system, but no processing is done either by Razorpay or the Contact's bank.

From the pending state, payouts can either move to the:

• queued state if you do not have sufficient balance to process the payout.
• scheduled state if you have scheduled the payout.
• processing state if you have sufficient balance to process the payout.
• rejected state if you reject the payout or if you did not approve the payout before the scheduled date and time.

Queued

A payout is assigned the queued status only when you do not have sufficient balance in your business account.

At this stage, the payout details are stored in the system, but no processing has been done either by Razorpay or the contact's bank.

From the queued state, payouts can either move to the:

• processing state when you add sufficient balance to process the payout.
• cancelled state if you cancel the payout.

Scheduled

The payout remains in the scheduled state until the scheduled date and time. At this stage, the payout details are stored in the system, but no processing is done either by Razorpay or the Contact's bank.

From the scheduled state, payouts can either move to the:

• processing state when the scheduled time is reached.
• cancelled state if you cancel the payout.
• failed state if you do not have sufficient balance to process the payout.

Processing

A payout can acquire the processing state in one of the three ways:

• From the pending state, when you approve the payout and you have sufficient balance to process the payout.
• From the queued state, when you add sufficient funds to your account to process the payout.
• Immediately, when a payout is created if you do not have the Queued Payouts or Approval Workflow feature enabled on your account.

At this stage, either Razorpay or the Contact's bank process the payout. No further action is required by you while a payout is in the processing state.

From processing state, payouts can either move to the:

• processed state if the payout is successful.
• reversed state if the payout fails.

Deemed Success

IMPS and UPI Payouts can be in the processing state for up to T+3 working days. NPCI marks these payouts as

Below is how a payout is processed from when you authorise it to when you receive the terminal payout state (processed/failed/reversed).

• If NPCI is successfully able to credit money to your beneficiary account, it returns a success status to the partner bank who in turn returns it to us and we mark the payout as processed.
• If NPCI is not able to credit money to your beneficiary account, it returns a failed status to the partner bank, who passes the status to us and we mark the payout as reversed.

Sometimes, there are technical errors when trying to credit the payout to the beneficiary account. When this happens, it is not possible to be certain if the payout was credited to the beneficiary.

In such cases, NPCI moves the payout to an intermediate state (

When we receive the deemed success from NPCI, we do not move the payout to a terminal state. We do this to avoid returning a false positive state to you. Instead, we keep the payout in the processing state till we receive the final status from the partner bank.

After NPCI and beneficiary bank reconcile the deemed success transactions, we receive the final status from the partner bank. Only then do we move the payout to the terminal state (processed/failed/reversed). This takes T+3 working days.

Processed

The processed status means that payout has been processed by the contact's Bank.

A payout in the processed state can move to the reversed state if a payout failure is detected.

This can happen due to various reasons such as the customer's bank reversing the transaction or if the payout was reversed by the clearing house.

This is a terminal state for a payout. No further action is possible on a payout at this state.

Reversed

A payout acquires the reversed state when the payout operation fails. This can happen due to issues with our partner banks, clearing house or even the customer's bank.

As soon as Razorpay identifies a payout failure scenario, it moves the payout to the reversed state and creates a reversal transaction that credits your business account with the original payout amount including fees and tax.

A Payout can move from reversed state to failed state only in case of RazorpayX Current accounts.

This is a terminal state for a payout. No further action is possible on a payout at this state.

Rejected

A payout in the pending state moves to the rejected state when:

• You manually reject the payout.
• You do not approve it before the scheduled date and time.

No further action is possible on a payout at this state.

Cancelled

A payout moves to the cancelled state when you manually cancel a payout in the:

• queued state. You can cancel a payout in the queued state either from the

  Dashboard

  or using our

  APIs

  .
• scheduled state. You can cancel a payout in the scheduled state from the

  Dashboard

  .

A payout that is cancelled acquires the cancelled state. No further action is possible on a payout at this state.

Failed

The payout failed status is applicable in both cases when you're making payouts using your current account balance or your RazorpayX Lite balance.

• Payouts in the processing state move to the failed state when they are failed by our current account partner bank.
• Payouts in the scheduled state move to the failed state if you do not have sufficient balance to process them.

This is a terminal state for a payout. No further action is possible on a payout at this state.

Reversal Transaction

A reversal transaction is created whenever a payout fails.

A payout may fail at Razorpay, at the contact's bank or elsewhere. In some rare scenarios, failure might happen a few days after the payout is moved to the processed state.

As soon as Razorpay detects a failure, we create a reversal transaction and credit the payout amount (including the fees and tax) to your business account. The original payout transaction status is changed to reversed.

Anytime a payout fails, a webhook is triggered to notify of the failure. A payout failure event is accompanied by a reversal transaction.

You can view a list of reversed transactions from the

Related Information

• Queued Payouts

• Scheduled Payouts

• Intelligent Payouts

• Payouts to Cards

• Payout Status Details

• Payout Best Practices