---
title: "rtr/withdraw/transaction/request-cancellation"
method: POST
path: "/rtr/withdraw/transaction/request-cancellation"
tags: ["Vopay Instant Endpoints"]
---

# rtr/withdraw/transaction/request-cancellation

`POST /rtr/withdraw/transaction/request-cancellation`

## Request

- Base URL: `https://earthnode-dev.vopay.com/api/v2`
- URL: `https://earthnode-dev.vopay.com/api/v2/rtr/withdraw/transaction/request-cancellation`
- Auth: none declared

This endpoint allows you to attempt to cancel an in progress Vopay Instant transaction. Note that the cancellation request will fail if the recipient has already deposited the funds.

A transaction in a state that can be neither cancelled nor have a cancellation requested (for example approved but not yet sent) is refused with ErrorCode INVALID_TRANSACTION_STATUS.

## Request body `application/x-www-form-urlencoded`

- object
  - `AccountID` string, required: Your account ID
  - `Key` string, required: API key for the account
  - `Signature` string, required: Hashed signature for the request
  - `TransactionID` string, required: The unique ID for the transaction

## Response `200`

- object
  - `Success` boolean, required: True if the request was successful, false if it failed
  - `ErrorMessage` string, required: Contains a description of the error if the request failed
  - `TransactionID` integer, required: The unique ID for the transaction
  - `TransactionStatus` string, required: A message indicating the current transaction status - cancellation requested
  - `Timestamp` string, date-time, required: The timestamp when the transaction status was last modified

---

[API](https://skmtc.dev/vopay/apis/payment-rails.md) - [All operations](https://skmtc.dev/vopay/apis/payment-rails/llms.txt) - [OpenAPI document](https://skmtc.dev/vopay/apis/payment-rails/revisions/d6fe8969ddcf?raw)