---
title: "Terminal Transaction Status Callback/Webhook"
method: POST
path: "/transaction_status/clientcustomendpoint"
---

# Terminal Transaction Status Callback/Webhook

`POST /transaction_status/clientcustomendpoint`

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

## Headers

- `your_custom_key_1` string, required
- `your_custom_key_2` string, required

## Request body

- object
  - `callback_attempt` integer, required — Number of times the callback has been attempted.
  - `callback_txn_id` string, required — Unique identifier mapped to the callback attempt.
  - `consumer_urn` string, required — Unique urn assigned to client that they pass in request payload
  - `callback_timestamp` string, required — Timestamp of the callback. Not the timestamp of the transaction.
  - `original_callback_txn_id` string — Unique identifier mapped to the first callback attempt.
  - `transaction_status` string, required — The status of the transaction. Values passed: PENDING, SUCCESS, FAILED, EXPIRED, DEEMED, REFUND_FAILED, REFUNDED, DISPUTED_AMOUNT
  - `transaction_status_description` string — Description message of the transaction status received.
  - `amount` number, float, required — The transaction amount. In case of UPI collection, the amount requested against a payment request.
  - `decentro_txn_id` string, required — The unique transaction identifier, passed against the payment request, by Decentro at the time of transaction initiation.
  - `reference_id` string — The referenceId passed at the time of transaction initiation. Passed only if the transaction is initiated through Decentro
  - `bank_reference_number` string — The unique transaction reference number from the bank partner. Will not be propagated in "EXPIRED" and certain "FAILED" scenarios.
  - `npci_txn_id` string — A unique transaction id generated by NPCI for each transaction.
  - `purpose_message` string — The purpose message value, shared during transaction initiation.
  - `collection_type` string — 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_name` string — Merchant name in case of collection transactions.
  - `payer_name` string — Name of the payer if propagated by the partner bank
  - `payee_account_number` string — Virtual account with Decentro against which the fund were credited
  - `payee_account_ifsc` string — IFSC of the beneficiary virtual account created with Decentro
  - `payer_vpa` string — UPI ID (VPA) of the payer.
  - `payee_vpa` string — UPI ID (VPA) of the payee.
  - `error_key` string — Indicates the reason for failure, if applicable.
  - `transaction_attempt_status` string — Status of the transaction attempt. Values passed: SUCCESS, FAILED, DEEMED, HOLD, REFUND_FAILED, REFUNDED
  - `attempt_decentro_txn_id` string — The unique transaction identifier, created by Decentro, for the payment attempt.
  - `transaction_authentication_timestamp` string — The timestamp at which user entered the MPIN and authenticated the payment.
  - `payer_account_number` string — Account number of the payer/remitter. Passed only for virtual account based collections if provided by the bank partner.
  - `payer_account_ifsc` string — Account ifsc of the payer/remitter. Passed only for virtual account based collections if provided by the bank partner.
  - `paid_amount` number, float — The amount collected against a Transaction Attempt.
  - `attempt_action` string — The action taken by the merchant against a HOLD transaction attempt or by our system were Auto-refund is enabled.
  - `transaction_attempt_status_description` string — The description of the status associated with the transaction attempt.
  - `error_key_description` string — The descriptive reason for transaction failure

## Response `200`

200

- object
  - `response_code` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/decentro/apis/decentro-staging.md) · [All operations](https://skmtc.dev/decentro/apis/decentro-staging/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decentro/decentro-staging/revisions/f1a86ce4638c/schema)