Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Account Balance

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

post/custom_endpoint

Headers

your_custom_key_1string

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

your_custom_key_1string

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

Request body

attemptinteger

The callback attempt from Decentro when triggered to the platform's endpoint.

timestampstring date-time

The timestamp when Decentro triggered the callback to the platform.

callbackTxnIdstring

Decentro's unique ID for the callback attempt.

originalCallbackTxnIdstring

Decentro's unique ID for the 1st callback attempt.

accountNumberstring

The virtual account number against which the callback is being triggered.

balancenumber float

The updated balance of the virtual account after the transaction.

transactionMessagestring

The associated transaction related message leading to change in balance.

typestring

The type of transaction that led of change in the balance.

transferTypestring

The type of transaction which resulted in change in balance. Values: RTGS, NEFT, IMPS, UPI

transactionAmountnumber float

The transaction amount that resulted in change in balance.

decentroTxnIdstring

The unique ID passed by Decentro if the transaction was initiated through Decentro.

payeeNamestring

The name of the beneficiary who's receiving the funds. Can be the platform or the beneficiary.

payeeAccountNumberstring

The virtual account number against which the callback is being triggered.

payeeAccountIfscstring

The IFSC code of the virtual against which the callback is being triggered.

payerVpastring

The VPA (UPI ID) of the payer who undertook a transaction. Only if the transaction is UPI collection.

bankReferenceNumberstring

The unique transaction reference number received by Decentro from its bank partner.

transactionTypestring

The type of transaction against which the callback is being triggered. Values - MAIN, COMMISSION, MAIN REVERSAL, COMMISSION REVERSAL

payerNamestring

The name of the payer from whom the transaction originated. Can be the platform or their user.

Response

200

OR

Example response

{
  "response_code": "CB_S00000"
}