# Payouts API - Transfer Status Lifecycle

The **Payouts API** enables the initiation and management of financial transactions to beneficiaries. Throughout its lifecycle, a transaction may pass through various **statuses** indicating its current state or outcome.

## <span style="color:#7b2cbf">Transfer Statuses</span>

<Container>
  
    <span style="color:#7b2cbf">PENDING</span> 

**Description:**
  The transfer has been created but is not yet processed.

**Typical Scenario:**
  Transaction is queued and awaiting submission to the bank.

</Container>


<Container>
  <span style="color:#7b2cbf">REJECTED</span> 

**Description:**
  The transaction was rejected due to validation errors.
To proceed, correct the issue and re-initiate the transaction using the **same`transactionId`**.

**Possible Reasons & Error Codes:**

| Reason                                  | Status   | Code                   |
| --------------------------------------- | -------- | ---------------------- |
| Beneficiary ID is missing or invalid    | REJECTED | REJECT\_BENEF\_ID      |
| Transaction ID is missing or invalid    | REJECTED | REJECT\_TXN\_ID        |
| Transfer amount is invalid              | REJECTED | REJECT\_TRF\_AMT       |
| Transfer mode is invalid or unsupported | REJECTED | REJECT\_TRF\_MODE      |
| Transfer remark is missing or too long  | REJECTED | REJECT\_TRF\_RMK       |
| Fund source ID is missing or invalid    | REJECTED | REJECT\_FND\_SRC\_ID   |
| Beneficiary detail ID is invalid        | REJECTED | REJECT\_BENEF\_DET\_ID |
| Beneficiary name is missing or invalid  | REJECTED | REJECT\_BENEF\_NAME    |
| Beneficiary account number is invalid   | REJECTED | REJECT\_BENEF\_ACC     |
| Beneficiary IFSC is missing or invalid  | REJECTED | REJECT\_BENEF\_IFSC    |
| Beneficiary email is missing or invalid | REJECTED | REJECT\_BENEF\_EMAIL   |
| Checksum for payload is missing/invalid | REJECTED | REJECT\_CHKSUM         |

</Container>


<Container>
 <span style="color:#7b2cbf">PROCESSING</span> 

**Description:**
  The transfer has been sent to the bank. The final status (**success or failure**) is awaited.

**Typical Scenario:**
  Transfer remains in this state until confirmation is received from the bank.

</Container>


<Container>
    <span style="color:#7b2cbf">SUCCESS</span> 

**Description:**
  The transaction was successfully completed and confirmed by the bank.

</Container>


<Container>
    <span style="color:#7b2cbf">FAILED</span> 

    **Description:**
  The transaction failed at the bank. This outcome is determined based on the bank’s response flags.
</Container>


<Container>
 <span style="color:#7b2cbf">REVERSED</span>   

    **Description:**
  The transaction was initially processed by the bank but later reversed.

Updated following reconciliation to reflect the reversal

</Container>