---
updatedAt: 2026-11-12T11:24:24.000Z
agentTools:
  projectIndex: https://docs.decentro.tech/llms.txt
---

# Enach Presentation Cancel API

This API is used to cancel eNACH presentations that are in the "Initiated" status.

## Overview

This API enables merchants to cancel eNACH mandate presentations that are in the "Initiated" status i.e., those that haven't yet been processed. Once cancelled, the mandate will not be picked up for presentation to the bank.

### Use Case

* Merchants may initiate a presentation but wish to cancel it before it reaches the bank.
* This API helps prevent accidental or duplicate presentations.
* It improves control for merchants and avoids unnecessary charges by reversing metering.

> 📘 Note:
>
> If the merchant has initiated the presentation and later marks for the cancellation of the mandate before the debit date, they have to use these API to manually mark the presentation for cancellation for such mandate where the mandate status is in cancellation\_pending

### Behavioral Rules

* Presentation can only be cancelled if its current status is "Initiated".
* If the status is "Success", "Failure", or "Pending" cancellation is not permitted.
* Once cancelled:
  * Status is updated to "Cancelled".
  * No callback is sent.
  * Metering is reversed for that record.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "decfin-staging",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://staging.api.decentro.tech"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/v3/payments/enach/mandate/execute/cancel": {
      "post": {
        "summary": "Enach Presentation Cancel API",
        "description": "This API is used to cancel eNACH presentations that are in the \"Initiated\" status.",
        "operationId": "enach-presentation-cancel-api",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reference_id"
                ],
                "properties": {
                  "reference_id": {
                    "type": "string",
                    "description": "Unique identifier for each request."
                  },
                  "decentro_txn_id": {
                    "type": "string",
                    "description": "This Decentro transaction ID belongs to the Mandate Presentation API."
                  },
                  "original_reference_id": {
                    "type": "string",
                    "description": "The reference_id which was passed while initiating the presentation of the mandate"
                  }
                }
              },
              "examples": {
                "Success - decentro_txn_id": {
                  "value": {
                    "reference_id": "XXXXXX",
                    "decentro_txn_id": "2326295613E84B44AF0019836A95759D"
                  }
                },
                "Failure - Txn ID not found": {
                  "value": {
                    "reference_id": "XXXXX",
                    "decentro_txn_id": "2326295613E84B44AF019836A95759D"
                  }
                },
                "Failure - Presentation Status": {
                  "value": {
                    "reference_id": "XXXXXX",
                    "decentro_txn_id": "2326295613E84B44AF0019836A95759D"
                  }
                },
                "Success - original_reference_id": {
                  "value": {
                    "reference_id": "XXXXX",
                    "original_reference_id": "2326295613E84B44AF019836A95759D"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Success": {
                    "value": "{\n    \"decentro_txn_id\": \"E599FC0EFE38419DA50F624876F5BB66\",\n    \"api_status\": \"SUCCESS\",\n    \"message\": \"Successfully cancelled mandate execution.\",\n    \"response_key\": \"success_mandate_execution_cancelled\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "decentro_txn_id": {
                      "type": "string",
                      "example": "E599FC0EFE38419DA50F624876F5BB66"
                    },
                    "api_status": {
                      "type": "string",
                      "example": "SUCCESS"
                    },
                    "message": {
                      "type": "string",
                      "example": "Successfully cancelled mandate execution."
                    },
                    "response_key": {
                      "type": "string",
                      "example": "success_mandate_execution_cancelled"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Failure - Txn ID not found": {
                    "value": "{\n    \"decentro_txn_id\": \"9C99CA1897DE4C9CACF6B8E2B9237ACA\",\n    \"api_status\": \"FAILURE\",\n    \"message\": \"Decentro transaction ID not found. Hint: decentro_txn_id(string)\",\n    \"response_key\": \"error_not_found_decentro_txn_id\"\n}"
                  },
                  "Failure - Presentation Status": {
                    "value": "{\n    \"decentro_txn_id\": \"9A4BEB4C559544768AC35B01388D1530\",\n    \"api_status\": \"FAILURE\",\n    \"message\": \"Decentro transaction ID cannot be canceled as status of presentation status is not in \\\"initiated\\\". Hint: decentro_txn_id(string)\",\n    \"response_key\": \"error_non_cancelable_decentro_txn_id\"\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "Failure - Txn ID not found",
                      "type": "object",
                      "properties": {
                        "decentro_txn_id": {
                          "type": "string",
                          "example": "9C99CA1897DE4C9CACF6B8E2B9237ACA"
                        },
                        "api_status": {
                          "type": "string",
                          "example": "FAILURE"
                        },
                        "message": {
                          "type": "string",
                          "example": "Decentro transaction ID not found. Hint: decentro_txn_id(string)"
                        },
                        "response_key": {
                          "type": "string",
                          "example": "error_not_found_decentro_txn_id"
                        }
                      }
                    },
                    {
                      "title": "Failure - Presentation Status",
                      "type": "object",
                      "properties": {
                        "decentro_txn_id": {
                          "type": "string",
                          "example": "9A4BEB4C559544768AC35B01388D1530"
                        },
                        "api_status": {
                          "type": "string",
                          "example": "FAILURE"
                        },
                        "message": {
                          "type": "string",
                          "example": "Decentro transaction ID cannot be canceled as status of presentation status is not in \"initiated\". Hint: decentro_txn_id(string)"
                        },
                        "response_key": {
                          "type": "string",
                          "example": "error_non_cancelable_decentro_txn_id"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```