---
title: "Cancel Transfer"
method: POST
path: "/cancelTransfer"
tags: ["Transfers"]
---

# Cancel Transfer

`POST /cancelTransfer`

## Request

- Base URL: `{corename}.payment-hub.{env}.gpsrv.com/payment-hub/1.0`
- URL: `{corename}.payment-hub.{env}.gpsrv.com/payment-hub/1.0/cancelTransfer`
- Auth: none declared. Required headers: `Authorization`

Use the Cancel Transfer endpoint to cancel an outgoing transfer that was initiated by <a href="ref:payhub_post_createTransfer" target="_blank">Create Transfer</a>.

Transfers must be in a `POSTED` status to be eligible for cancellation.

## Headers

- `Authorization` string, required

## Request body

- object
  - `accountNo` string, required: The <<glossary:PRN>> associated with the outgoing transfer to cancel.
  - `transferId` string, required: Unique identifier of the transfer to cancel. Pattern: Alphanumeric string Example: `TXN-12345ABCDE`

## Response `200`

Successful Response

- object
  - `transferId` string, required: The unique identifier for the cancelled transfer.
  - `reverseAdjustmentId` string, nullable, required: The unique identifier for the reversed adjustment transaction.

## Other responses

- `400`: Bad Request
- `401`: No valid API credentials provided.
- `403`: The provided API credential does not allow this operation.
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too many requests.
- `500`: Internal Server Error
- `502`: Bad Gateway.
- `503`: Service Unavailable.

---

[API](https://skmtc.dev/galileo-ft/apis/payment-hub-api-2-0.md) - [All operations](https://skmtc.dev/galileo-ft/apis/payment-hub-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/payment-hub-api-2-0/revisions/20e06b09d5e4?raw)
