get https://in.staging.decentro.tech/core_banking/money_transfer/get_status
Important Note
Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.
API Endpoints
| Environment | Endpoint |
|---|---|
| Staging / Sandbox | https://in.staging.decentro.tech/core_banking/money_transfer/get_status |
| Production | https://in.decentro.tech/core_banking/money_transfer/get_status |
This API can be used by you to check the money transfer transactions that were initiated/completed by your customers.
Two main parameters are required -
- reference_id ((mandatory if decentro_txn_id is not present) The request ID passed by you for this transaction when initiating it earlier.)
- decentro_txn_id ((mandatory if reference_id is not present) The decentro transaction id that we responded with while providing the initiate payment response.)
Please ensure that when using this API with the reference_id parameter, the Initiate Payout API must respond before the Get Transaction Status API is invoked. Otherwise, the transaction details will not be available in the system.
API specifications
Response Payload
| Response Parameter | Mandatory (M) / Optional (O) / Conditional Mandatory (CM) | Description |
|---|---|---|
| decentroTxnId | M | A URN generated by Decentro against the Get Transaction Status API request initiated. This parameter is recommended for mapping and tracking purposes. |
| originalTxnId | M | The URN generated by Decentro against the Initiate Payout API initiated |
| originalDecentroTxnId | M | A URN generated by Decentro against the Get Transaction Status API request. While available, it is recommended to prioritize decentroTxnId for mapping transactions |
| status | M | Success, Pending, and Failure will be populated in this parameter. The API status and Transaction status must be differentiated by http_status_code. Decentro recommends not to use this parameter to map the status of the transaction. |
| transactionStatus | M | The status of the payout transaction. These are the values that will be present. 1. Success 2. Failure 3. Pending 4. Unknown |
| bankReferenceNumber | CM | Bank Reference Number will be populated. It will be populated for ‘success’,’failure’ and ‘pending’. For some cases, it will not be populated for ‘pending’ |
| message | CM | A message will be propagated by Decentro regarding the status of the transaction |
| providerResponse | CM | The message propagated by provider regarding the status of the transaction |
| transferType | M | UPI,IMPS,NEFT and RTGS will be propagated |
| beneficiaryName | CM | The Beneficiary account holder’s name will be propagated here. This will be propagated only for ‘Success’ |