v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Enach Mandate Execution

This API allows the platform to initiate a presentation using Decentro's ENACH V3 stack.

post/v3/payments/enach/mandate/execute

Headers

client_idstring required

client_secretstring required

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

The unique identifier propagated by Decentro in the mandate registration API.

debit_datestring date required

The date when the funds need to be debited from the payer's account.

amountnumber float required

The amount that needs to be debited and needs to be lesser than or equal to the registration amount.

split_settlement_rule_urnstring

This param will help us to identify the split settlement rule at transaction level.

Response

200

decentro_txn_idstring

api_statusstring

messagestring

response_keystring

Example response

{
  "decentro_txn_id": "3B8ABE0E394045998A3103C6CDAE94B7",
  "api_status": "SUCCESS",
  "message": "Successfully initiated the mandate execution.",
  "data": {
    "presentation_status": "INITIATED",
    "decentro_mandate_id": "2C9E1C0FC3B240369B4B8E7AF9CE8179",
    "amount": 500
  },
  "response_key": "success_mandate_execution_initiated"
}