v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Mandate Presentation API

This API is used to execute a registered UPI based mandate that is created using the Create Mandate API.

post/v3/payments/upi/autopay/mandate/presentation

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.

purpose_messagestring required

Remarks to be added for the presentation.

presentation_sequence_idstring required

The presentation sequence ID received in the notification response.

Response

200

decentro_txn_idstring

api_statusstring

messagestring

response_keystring

Example response

{
  "decentro_txn_id": "C331608245F84919BFED6D69D8372783",
  "api_status": "SUCCESS",
  "message": "Mandate presentation initiated successfully.",
  "data": {
    "presentation_status": "PENDING",
    "debit_date": "Aug 24, 2020, 12:00:00 AM",
    "decentro_mandate_id": "97C96B3CA797417A8094D50E96D58774",
    "amount": "100.0"
  },
  "response_key": "success_presentation_initiated"
}