Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

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/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.

callback_txn_idstring required

Unique identifier mapped to the callback attempt.

consumer_urnstring required

Unique urn assigned to client that they pass in request payload

callback_timestampstring required

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

original_callback_txn_idstring

Unique identifier mapped to the first callback attempt.

transaction_statusstring required

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

transaction_status_descriptionstring

Description message of the transaction status received.

amountnumber float required

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

decentro_txn_idstring required

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

reference_idstring

The referenceId passed at the time of transaction initiation. Passed only if the transaction is initiated through Decentro

bank_reference_numberstring

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

npci_txn_idstring

A unique transaction id generated by NPCI for each transaction.

purpose_messagestring

The purpose message value, shared during transaction initiation.

collection_typestring

The method of collection. Describes whether the funds were received via a payment link, dynamic QR, collect request, or a static QR. Only applicable for collection transactions. Possible values: payment_link, dynamic_qr, collection_request, Reverse Penny Drop

payee_namestring

Merchant name in case of collection transactions.

payer_namestring

Name of the payer if propagated by the partner bank

payee_account_numberstring

Virtual account with Decentro against which the fund were credited

payee_account_ifscstring

IFSC of the beneficiary virtual account created with Decentro

payer_vpastring

UPI ID (VPA) of the payer.

payee_vpastring

UPI ID (VPA) of the payee.

error_keystring

Indicates the reason for failure, if applicable.

transaction_attempt_statusstring

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

attempt_decentro_txn_idstring

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

transaction_authentication_timestampstring

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

payer_account_numberstring

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

payer_account_ifscstring

Account ifsc 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.

attempt_actionstring

The action taken by the merchant against a HOLD transaction attempt or by our system were Auto-refund is enabled.

transaction_attempt_status_descriptionstring

The description of the status associated with the transaction attempt.

error_key_descriptionstring

The descriptive reason for transaction failure

Response

200

response_codestring

Example response

{
  "response_code": "CB_S00000"
}