---
title: "Transaction Status Callback"
method: POST
path: "/transactionStatus"
---

# Transaction Status Callback

`POST /transactionStatus`

## Request body

- object
  - `transaction_status` string — The status of the transaction. Values passed: SUCCESS and FAILURE
  - `transaction_amount` integer — The transaction amount.
  - `bank_reference_number` string — Bank Reference Number of the transaction
  - `callback_attempt` integer — A numerical value that indicates the attempt no. of the callback
  - `callback_timestamp` string — Timestamp of the callback. Not the timestamp of the transaction.
  - `callback_txn_id` string — A URN created for the transaction status callback
  - `consumer_urn` string — Unique urn assigned to client that they pass in request payload
  - `decentro_txn_id` string — The unique transaction identifier, passed against the payout request, by Decentro at the time of transaction initiation.
  - `orginal_callback_txn_id` string — Unique identifier mapped to the first callback attempt.
  - `payer_account_number` string — The Virtual Account from which the payout transaction took place.
  - `payer_account_ifsc` string — The Virtual Account IFSC
  - `payee_account_number` string — The beneficiary account number of the payout request
  - `payee_account_ifsc` string — The beneficiary account IFSC
  - `payee_vpa` string — The beneficiary UPI ID will be present here.
  - `transaction_status_description` string — The transaction message after the transaction is completed.
  - `purpose_message` string — The purpose message passed in the payout request
  - `transfer_type` string — IMPS, UPI, NEFT and RTGS will be present here.
  - `reference_id` string — The URN created by the platform in the Initiate Payout API
  - `beneficiary_name` string — The beneficiary name will be present here
  - `provider_message` string — Decentro recommends not to use this parameter
  - `transaction_message` string — Decentro recommends not to use this parameter

## 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)