---
title: "Transaction Status Callback v2"
method: POST
path: "/transactionstatus"
---

# Transaction Status Callback v2

`POST /transactionstatus`

This callback is triggered by Decentro to a custom end-point of the platform for each incoming and outgoing transaction initiated through Decentro, once it reaches its terminal status.

## Request body

- object
  - `attempt` integer, required — A numerical value that indicates the attempt no. of the callback
  - `timestamp` string, required — Timestamp of the CALLBACK. Not the transaction itself.
  - `callbackTxnId` string, required — A URN created for the transaction status callback
  - `originalCallbackTxnId` string, required — The callback URN of the 1st attempt will be present here.
  - `transactionStatus` string, required — The status of the transaction will be present here. "success" and "failure"
  - `referenceId` string, required — The URN created by the platform in the Initiate Payout API
  - `decentroTxnId` string, required — The URN provided by Decentro for the transaction
  - `transactionMessage` string, required — The purpose message will be present here
  - `transferType` string, required — IMPS, UPI, NEFT and RTGS will be present here
  - `bankReferenceNumber` string, required — The bank reference number will be present here. (Note: If the transaction fails without a bank reference number, then this parameter will not be present)
  - `beneficiaryName` string, required — The beneficiary name will be present here
  - `transactionAmount` integer, required — The transaction amount will be present here
  - `providerMessage` string, required — The provider message of the transaction will be present here.

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