---
title: "Settlement Status Callback/Webhook"
method: POST
path: "/settlement_status/customendpoint"
---

# Settlement Status Callback/Webhook

`POST /settlement_status/customendpoint`

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

## Headers

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

## Request body

- object
  - `amount` string, required — The transaction amount.
  - `bank_reference_number` string, required — The unique transaction reference number from the bank partner
  - `callback_attempt` string, required — Number of times the callback has been attempted.
  - `callback_timestamp` string, required — Timestamp of the callback. Not the timestamp of the transaction.
  - `callback_txn_id` string, required — Unique identifier mapped to the callback attempt.
  - `decentro_txn_id` string, required — The unique transaction identifier, passed against the payment request, by Decentro at the time of transaction initiation.
  - `original_callback_txn_id` string — Unique identifier mapped to the first callback attempt.
  - `settlement_account_ifsc` string — The ifsc of the account number against which settlement has been processed.
  - `settlement_account_number` string — The account number against which settlement has been processed.
  - `settlement_account_urn` string — The settlement account urn mapped against the settlement account.
  - `settlement_status` string, required — The status of the transaction.
  - `settlement_status_message` string — The message description of the settlement status
  - `settlement_urn` string — The settlement_urn received during requesting the settlements.
  - `transfer_type` string — The transfer type of the settlement transaction. Possible values: RTGS, IMPS, NEFT
  - `updated balance` string — The updated balance of in the Decfin system after settlements.
  - `virtual_account_number` string — The virtual account number against which the settlement was triggered by Decentro.

## Response `200`

200

- object
  - `response_code` string

---

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