v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Account Balance Callback/Webhook

post/account_balance/clientcustomendpoint

Headers

your_custom_key_1string

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

your_custom_key_2string

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

Request body

callback_attemptstring required

Number of times the callback has been attempted.

callback_txn_idstring required

Unique identifier mapped to the callback attempt.

consumer_urnstring required

Unique urn assigned to client that they pass in request payload for creating a payment link, collect request or dynamic QR.

callback_timestampstring required

Timestamp of the Callback. Not the transaction itself.

original_callback_txn_idstring required

Unique identifier mapped to the callback.

typestring required

Possible values = Credit or Debit

account_balancestring required

The updated balance of the account mapped to consumer URN

collection_typestring 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_idstring required

The unique transaction identifier, passed against the payment request, by Decfin at the time of transaction initiation.

amountstring required

The transaction amount.

transaction_typestring

Possible values: MAIN or COMMISSION

payee_account_numberstring

The internal account number where the funds are collected.

payee_account_ifscstring

The account IFSC of the payee account number

transaction_messagestring

Description message to be shown after the completion of payment.

transfer_typestring

Values: IMPS, RTGS, NEFT. Only passed in virtual account based collections.

parent_decentro_txn_idstring

decentro_txn_id of the transaction that is already in terminal state.

payer_account_numberstring

Account number of the payer/remitter. Passed only for virtual account based collections if provided by the bank partner.

Response

200

response_codestring

Example response

{
  "response_code": "CB_S00000"
}