---
title: "Account Balance"
method: POST
path: "/custom_endpoint"
---

# Account Balance

`POST /custom_endpoint`

This callback is triggered at a virtual account level every time there's a change in the balance

## Headers

- `your_custom_key_1` string
- `your_custom_key_1` string

## Request body

- object
  - `attempt` integer — The callback attempt from Decentro when triggered to the platform's endpoint.
  - `timestamp` string, date-time — The timestamp when Decentro triggered the callback to the platform.
  - `callbackTxnId` string — Decentro's unique ID for the callback attempt.
  - `originalCallbackTxnId` string — Decentro's unique ID for the 1st callback attempt.
  - `accountNumber` string — The virtual account number against which the callback is being triggered.
  - `balance` number, float — The updated balance of the virtual account after the transaction.
  - `transactionMessage` string — The associated transaction related message leading to change in balance.
  - `type` string — The type of transaction that led of change in the balance.
  - `transferType` string — The type of transaction which resulted in change in balance. Values: RTGS, NEFT, IMPS, UPI
  - `transactionAmount` number, float — The transaction amount that resulted in change in balance.
  - `decentroTxnId` string — The unique ID passed by Decentro if the transaction was initiated through Decentro.
  - `payeeName` string — The name of the beneficiary who's receiving the funds. Can be the platform or the beneficiary.
  - `payeeAccountNumber` string — The virtual account number against which the callback is being triggered.
  - `payeeAccountIfsc` string — The IFSC code of the virtual against which the callback is being triggered.
  - `payerVpa` string — The VPA (UPI ID) of the payer who undertook a transaction. Only if the transaction is UPI collection.
  - `bankReferenceNumber` string — The unique transaction reference number received by Decentro from its bank partner.
  - `transactionType` string — The type of transaction against which the callback is being triggered. Values - MAIN, COMMISSION, MAIN REVERSAL, COMMISSION REVERSAL
  - `payerName` string — The name of the payer from whom the transaction originated. Can be the platform or their user.

## Response `200`

200

- union
  - object
    - `response_code` string
  - object
    - `response_code` string

## Other responses

- `202` — 202
- `400` — 400
- `401` — 401
- `2XX` — 2XX
- `4XX` — 4XX

---

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