Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Pre Debit Notification

This API is used to initiate a pre-debit notification at least 24 hours before presenting the actual mandate.

post/v3/payments/upi/autopay/mandate/notify

Headers

client_idstring required

Decentro assigned client_id during onboarding.

client_secretstring required

Decentro assigned client_secret during onboarding.

x_on_behalf_ofstring

Optional header that allows parent merchant to consume the API on behalf of sub-merchant.

authorizationstring

Customers can generate JWT using our Auth API with various grant types in the request body. JWT is valid for 15minutes.

Request body

reference_idstring required

A specific unique ID assigned by you for this transaction. If not kept unique, transaction status extraction could behave erratically.

decentro_mandate_idstring required

Unique Decentro mandate ID for the Mandate received at the time of mandate creation.

amountnumber float

The debit amount for mandate presentation.

debit_datestring date required

The debit date on which funds should be deducted from payer's account.

Response

200

OR

Example response

{
  "decentro_txn_id": "F3148C353F7745A8AEF5D0CF96F33891",
  "api_status": "SUCCESS",
  "message": "Pre Debit Notification sent successfully.",
  "data": {
    "notification_detail": {
      "notification_status": "SUCCESS",
      "presentation_sequence_id": "DFN-63D5343CF3CD41C29A7F7C3DED8FAC63-00001",
      "debit_date": "Jan 09, 2025, 12:00:00 AM",
      "decentro_mandate_id": "63D5343CF3CD41C29A7F7C3DED8FAC63",
      "amount": "100"
    }
  },
  "response_key": "success_pre_debit_notification"
}