Payouts Status Codes

Overview

The Payouts API allows for the initiation and management of financial transactions to beneficiaries. The API supports various states and statuses that a transaction may go through during its lifecycle.

Transaction Statuses

PENDING

• Description: The transaction has been created but not yet processed. This status is common in batch payout transfers. For single payout transfers, this status will not occur.

• Scenario: When the transaction is created and queued, but not yet sent to the bank.

REJECTED

• Description: The transaction has been rejected. To proceed, the transaction must be re-initiated with the same transactionId after addressing the issues based on the provided error code.

• Possible Reasons and 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 missing or 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 the payload is missing or invalid	REJECTED	REJECT_CHKSUM

PROCESSING, IMPS_CALL_MADE, NEFT_CALL_MADE, UPI_CALL_MADE

• Description: The transaction has been sent to the bank, and the final status has not yet been received. The transaction remains in this state until a terminal status is received.

SUCCESS

• Description: The transaction has been successfully completed and confirmed by the bank.

FAILED

• Description: The transaction failed at the bank. This status is determined based on a flag in the API response.

REVERSED

• Description: The transaction was reversed after being processed by the bank. This status is updated following a reconciliation that marks the reversal.