Cancel Transaction

You can cancel a transaction while it is still in SCHEDULED or PENDING status.

Note: Cancellation is irreversible—once canceled, the transaction will not be processed.

---

Resource Access

Production (api.ahrvo.network)

POST https://api.ahrvo.network/banking/us2/v1/transaction/id/{transactionId}/cancel

Staging (gateway.ahrvo.network)

POST https://gateway.ahrvo.network/banking/us2/v1/transaction/id/{transactionId}/cancel

---

Arguments

Attribute	M / O	Description
reason	M	Enumerated reason for cancellation (e.g., ON_USER_REQUEST, INSUFFICIENT_FUNDS, OTHERS).
comment	O*	Free-text comment required when reason = OTHERS.

---

Sample Request — Cancel by id

POST /banking/us2/v1/transaction/id/2/cancel HTTP/1.1
Host: {placeholder('hostname')}
Authorization: Bearer {placeholder('JWT token')}
x-api-key: {apiKey}
Content-Type: application/json

Payload

{
  "reason": "OTHERS",
  "comment": "customer requested to cancel the scheduled transaction"
}

---

Sample Response

HTTP/1.1 204 No Content