Pre-Deposit check callback

post

https://your.custom.endpoint.com/v3/pre_deposit_check

This callback allows client to accept or reject any incoming transaction in their virtual account.

🙌
Important Note
Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.

Overview

The client can use this callback to accept or reject any incoming transactions in their virtual account. If client has not subscribed to this callback, it is mandatory to whitelist the remitter against the virtual account.

The incoming transactions will be rejected under the following scenarios:

Company has not opted for pre-deposit checks neither whitelisted the remitter account.
Company rejects the transaction.
Company does not respond with the valid payload. (Refer examples)
Company does not respond within the configured timeframe of 8 seconds.

Body Params

consumer_urn

string

required

A unique identifier assigned to client's by Decentro during On boarding.

payee_account_number

string

required

Virtual account with Decentro against which the fund were credited

transfer_type

string

required

The type of transaction done on the virtual account. Values: RTGS, NEFT, IMPS, UPI

amount

string

required

The transaction amount.

payer_name

string

Name of the payer if propagated by the partner bank

payer_account_number

string

Account number of the payer

payer_account_ifsc

string

IFSC of the payer account

bank_reference_number

string

required

Unique reference number generated for each transaction.

Headers

your_custom_key_1

string

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

your_custom_key_2

string

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

Response

🙌Important Note

Overview

200200

🙌
Important Note