---
title: "Account Balance Callback/Webhook"
method: POST
path: "/account_balance/clientcustomendpoint"
---

# Account Balance Callback/Webhook

`POST /account_balance/clientcustomendpoint`

## Headers

- `your_custom_key_1` string
- `your_custom_key_2` string

## Request body

- object
  - `callback_attempt` string, 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 for creating a payment link, collect request or dynamic QR.
  - `callback_timestamp` string, required — Timestamp of the Callback. Not the transaction itself.
  - `original_callback_txn_id` string, required — Unique identifier mapped to the callback.
  - `type` string, required — Possible values = Credit or Debit
  - `account_balance` string, required — The updated balance of the account mapped to consumer URN
  - `collection_type` string, required — 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.
  - `decentro_txn_id` string, required — The unique transaction identifier, passed against the payment request, by Decfin at the time of transaction initiation.
  - `amount` string, required — The transaction amount.
  - `transaction_type` string — Possible values: MAIN or COMMISSION
  - `payee_account_number` string — The internal account number where the funds are collected.
  - `payee_account_ifsc` string — The account IFSC of the payee account number
  - `transaction_message` string — Description message to be shown after the completion of payment.
  - `transfer_type` string — Values: IMPS, RTGS, NEFT. Only passed in virtual account based collections.
  - `parent_decentro_txn_id` string — decentro_txn_id of the transaction that is already in terminal state.
  - `payer_account_number` string — Account number of the payer/remitter. Passed only for virtual account based collections if provided by the bank partner.

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