Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Netbanking Terminal Transaction Status Callback/Webhook

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

post/CALLBACK_NETBANKING_TRANSACTION_STATUS/clientcustomendpoint

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

callback_attemptinteger required

Number of times the callback has been attempted.

amountnumber float required

The transaction amount. In case of UPI collection, the amount requested against a payment request.

callback_timestampstring required

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

callback_txn_idstring required

Unique identifier mapped to the callback attempt.

initiation_typestring

The method of netbanking transaction. Describes whether the funds were received via an intent link, QR, or redirection. Possible values: INTENT, QR, REDIRECTION.

consumer_urnstring required

Unique urn assigned to client that they pass in request payload

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.

payer_namestring

Name of the payer if propagated by the partner bank

payer_account_numberstring

Account number of the payer/remitter. Passed only for virtual account based collections if provided by the bank partner.

paid_amountnumber float

The amount collected against a Transaction Attempt.

purpose_messagestring

The purpose message value, shared during transaction initiation.

request_decentro_txn_idstring

The unique transaction identifier, created by Decentro, for the payment.

transaction_attempt_status_descriptionstring

The description of the status associated with the transaction attempt.

transaction_attempt_statusstring

Status of the transaction attempt. Values passed: SUCCESS, FAILED, DEEMED, HOLD, REFUND_FAILED, REFUNDED

transaction_authentication_timestampstring

The timestamp at which user entered the MPIN and authenticated the payment.

transaction_statusstring required

The status of the transaction. Values passed: PENDING, SUCCESS, FAILED, EXPIRED, DEEMED, REFUND_FAILED, REFUNDED, DISPUTED_AMOUNT

bank_reference_numberstring

The unique transaction reference number from the bank partner. Will not be propagated in "EXPIRED" and certain "FAILED" scenarios.

Response

200

response_codestring

Example response

{
  "response_code": "CB_S00000"
}