v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Settlement Status Callback/Webhook

This callback is used by Decentro to trigger the status of a settlement to pre-configured endpoint of the platform.

post/settlement_status/customendpoint

Headers

your_custom_key_1string required

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

your_custom_key_2string required

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

Request body

amountstring required

The transaction amount.

bank_reference_numberstring required

The unique transaction reference number from the bank partner

callback_attemptstring required

Number of times the callback has been attempted.

callback_timestampstring required

Timestamp of the callback. Not the timestamp of the transaction.

callback_txn_idstring required

Unique identifier mapped to the callback attempt.

decentro_txn_idstring required

The unique transaction identifier, passed against the payment request, by Decentro at the time of transaction initiation.

original_callback_txn_idstring

Unique identifier mapped to the first callback attempt.

settlement_account_ifscstring

The ifsc of the account number against which settlement has been processed.

settlement_account_numberstring

The account number against which settlement has been processed.

settlement_account_urnstring

The settlement account urn mapped against the settlement account.

settlement_statusstring required

The status of the transaction.

settlement_status_messagestring

The message description of the settlement status

settlement_urnstring

The settlement_urn received during requesting the settlements.

transfer_typestring

The transfer type of the settlement transaction. Possible values: RTGS, IMPS, NEFT

updated balancestring

The updated balance of in the Decfin system after settlements.

virtual_account_numberstring

The virtual account number against which the settlement was triggered by Decentro.

Response

200

response_codestring

Example response

{
  "response_code": "CB_S00000"
}