> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Payout States and Life Cycle

> [Payouts](/x/payouts) are made to [Contacts](/x/contacts). A payout has various states in its 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`

<Info>
  **Handy Tips**
</Info>

For more information on the complete Payout States and the Status Response Code, refer [Payout Status Details.](/errors/x/payout-status-details)

Get automatic notifcations about the payout states using [Webhooks](/webhooks). [Set up and configure webhooks](/x/apis/subscribe) to improve process efficiency, and stay updated on the status of the payout.

### Pending

If you have the [Approval Workflow](/x/manage-teams/approval-workflow) feature enabled on your account, the payout moves to the `pending` state if the payout requires approval as per the Approval Workflow.

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

<Info>
  **Handy Tips**
</Info>

* The payout needs to be approved/rejected by the required user(s). Any payout in `pending` state for more than 3 months will automatically be `rejected`.
* The `Pending` and `Rejected` states are available only if you have [Approval Workflow](/x/manage-teams/approval-workflow) enabled on your account.

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.

<Warning>
  **Watch Out!**

  The payout remains in this state until you add sufficient funds to your business account. Any payout in `queued` state for more than 3 months will automatically be `failed`.

  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.

  <Info>
    **Handy Tips**
  </Info>

  The `scheduled` state does not apply to Queued Payouts. Know more about [Queued Payouts](/x/payouts/queued).
</Warning>

### 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.

<Info>
  **Handy Tips**
</Info>

The `queued` state does not apply to Scheduled Payouts. Know more about [Scheduled Payouts](/x/payouts/scheduled).

### 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.

<Info>
  **Handy Tips**
</Info>

* IMPS and UPI payouts can remain in the [`processing` state for T+3 working days.](#deemed-success)
* You can check status details of a payout to know why it is in the `processing` state. It maybe due to:
* [Deemed Success](https://razorpay.com/blog/business-banking/payout-processing-imps-upi-transactions-deemed-success-npci/)
* NEFT/RTGS off hours
* Partner bank or beneficiary bank issues
* Other bank or server issues
  You can use this information to keep your beneficiaries informed.

<Steps>
  <Step title="[Status Details via API](/errors/x/payout-status-details)">
    [Status Details via API](/errors/x/payout-status-details)
  </Step>

  <Step title="[Status Details via Dashboard](/x/payouts/status-details)">
    [Status Details via Dashboard](/x/payouts/status-details)
  </Step>

  <Step title="You can subscribe to daily reports to receive a detailed document o...">
    You can subscribe to daily reports to receive a detailed document on the status, reason for status and SLA for the payouts in `processing state`. [Raise a support ticket](/x/support) from the Dashboard, with a list of recipient email IDs. We will enable the function for you in 3 working days.
  </Step>
</Steps>

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 [deemed success/deemed approved](https://razorpay.com/blog/business-banking/payout-processing-imps-upi-transactions-deemed-success-npci/).

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 ([deemed success](https://razorpay.com/blog/business-banking/payout-processing-imps-upi-transactions-deemed-success-npci/)). From this state, the payout can go to the `processed`, `failed` or `reversed` 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 powered Current accounts.

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

<Warning>
  **Watch Out!**

  A transaction can also move from `failed` to `reversed` status in certain situations. When a transaction fails but money is debited from the account, the status changes to `reversed` only after the money is credited back. Until then, the status remains as `failed`.
</Warning>

### 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.

<Info>
  **Handy Tips**
</Info>

The `Pending` and `Rejected` states are available only if you have [Approval Workflow](/x/manage-teams/approval-workflow) enabled on your account.

### 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](https://x.razorpay.com/) or using our [APIs](/api/x/payouts/cancel).
* `scheduled` state. You can cancel a payout in the `scheduled` state from the [Dashboard](https://x.razorpay.com/).

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 [RazorpayX Dashboard](https://x.razorpay.com/).

### Related Information

* [Queued Payouts](/x/payouts/queued)
* [Scheduled Payouts](/x/payouts/scheduled)
* [Intelligent Payouts](/x/payouts/intelligent-payouts)
* [Payouts to Cards](/x/payouts/cards)
* [Payout Status Details](/errors/x/payout-status-details)
* [Payout Best Practices](/x/payouts/best-practices)
