---
title: "Changes to Cancel a bank transfer"
method: POST
path: "/transactions/{transactionId}/cancel"
---

# Changes to Cancel a bank transfer

`POST /transactions/{transactionId}/cancel`

> Every recorded change to this operation, newest first.
> 117 revisions in range; 2 not diffed.

## Timeline

Changed in 20 of 117 revisions.

- **2026-11-03** `7ef4b76d04a3`: 1 warning
- **2026-10-28** `d996ddfb9d2b`: 2 info
- **2026-10-27** `190120f7c3c4`: 2 warning, 1 info
- **2026-10-26** `e959a710f4b2`: 6 breaking, 6 info
- **2026-10-26** `f11f1e76bdd7`: 1 warning
- **2026-10-26** `0a6dad5815c7`: 1 warning
- **2026-10-24** `715332dcb111`: 1 warning
- **2026-10-21** `24d712c399dd`: 12 info
- **2026-10-20** `761d1d030cb5`: 2 warning
- **2026-10-14** `06dd7787d29a`: 2 warning
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
- **2026-10-09** `a7c5552d4ea1`: 6 info
- **2026-10-09** `36ec020f29da`: 1 warning
- **2026-10-07** `9c02b8bb58f1`: 28 info
- **2026-10-05** `e73712057c75`: 1 breaking, 1 info
- **2026-10-05** `6d67fe99049c`: 3 info
- **2026-10-05** `2685440cbd84`: 1 breaking, 1 info
- **2026-10-05** `777033714279`: 2 info
- **2026-10-05** `32bcbd4023e4`: 3 warning
- **2026-10-02** `dfe5a02f2fee`: 1 info

## Changes

- **2026-11-03** `7ef4b76d04a3`: 1 warning
  - added the new `BENEFICIARY_NOT_TRUSTED` enum value to the `code` response property for the response status `409`
- **2026-10-28** `d996ddfb9d2b`: 2 info
  - added the optional property `details/missingFields` to the response with the `400` status
  - added the optional property `details/refusalReason` to the response with the `400` status
- **2026-10-27** `190120f7c3c4`: 2 warning, 1 info
  - added the new `PLATFORM_DECLINED` enum value to the `oneOf[subschema #3: Card Transaction]/cardDeclinedReason` response property for the response status `200`
  - added the new `PLATFORM_UNAVAILABLE` enum value to the `oneOf[subschema #3: Card Transaction]/cardDeclinedReason` response property for the response status `200`
  - added the optional property `oneOf[subschema #3: Card Transaction]/platformDeclineReason` to the response with the `200` status
- **2026-10-26** `e959a710f4b2`: 6 breaking, 6 info
  - added `#/components/schemas/SwiftRailDetails` to the `oneOf[subschema #1: Incoming Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SwiftRailDetails` to the `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SwiftRailDetails` to the `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SwiftRailDetails` to the `oneOf[subschema #2: Outgoing Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SwiftRailDetails` to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SwiftRailDetails` to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails` response property `oneOf` list for the response status `200`
  - added `SWIFT` discriminator mapping keys to the `oneOf[subschema #1: Incoming Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails` response property for the response status `200`
  - added `SWIFT` discriminator mapping keys to the `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails` response property for the response status `200`
  - added `SWIFT` discriminator mapping keys to the `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails` response property for the response status `200`
  - added `SWIFT` discriminator mapping keys to the `oneOf[subschema #2: Outgoing Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails` response property for the response status `200`
  - added `SWIFT` discriminator mapping keys to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails` response property for the response status `200`
  - added `SWIFT` discriminator mapping keys to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails` response property for the response status `200`
- **2026-10-26** `f11f1e76bdd7`: 1 warning
  - added the new `PURCHASE_CARD_LIMIT_REACHED` enum value to the `code` response property for the response status `409`
- **2026-10-26** `0a6dad5815c7`: 1 warning
  - added the new `INVOICE_ALREADY_USED` enum value to the `code` response property for the response status `409`
- **2026-10-24** `715332dcb111`: 1 warning
  - added the new `EXACT_AMOUNT_UNAVAILABLE` enum value to the `code` response property for the response status `400`
- **2026-10-21** `24d712c399dd`: 12 info
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCategory` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCode` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCategory` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCode` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCategory` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCode` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCategory` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCode` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCategory` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCode` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCategory` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/returnCode` to the response with the `200` status
- **2026-10-20** `761d1d030cb5`: 2 warning
  - added the new `AGENT_CARD_EXISTS` enum value to the `code` response property for the response status `409`
  - added the new `CARDHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-14** `06dd7787d29a`: 2 warning
  - added the new `INCORRECT_CARD_DETAILS` enum value to the `oneOf[subschema #3: Card Transaction]/cardDeclinedReason` response property for the response status `200`
  - added the new `TEMPORARILY_UNAVAILABLE` enum value to the `oneOf[subschema #3: Card Transaction]/cardDeclinedReason` response property for the response status `200`
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
  - added the new `ACCOUNTHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-09** `a7c5552d4ea1`: 6 info
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/statementDescriptor` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/statementDescriptor` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/statementDescriptor` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/statementDescriptor` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/statementDescriptor` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails/oneOf[subschema #2: ACH Transfer]/allOf[subschema #2]/statementDescriptor` to the response with the `200` status
- **2026-10-09** `36ec020f29da`: 1 warning
  - added the new `PIN_CHANGE_REQUIRED` enum value to the `code` response property for the response status `409`
- **2026-10-07** `9c02b8bb58f1`: 28 info
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/railDetails` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/railDetails` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/railDetails` to the response with the `200` status
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/onChainTransaction` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/onChainTransaction` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/accountHolderName` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/accountIdentifier` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/bankIdentifier` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/bankName` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/endToEndId` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/onChainTransaction` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/paymentRail` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/remittanceInformation` deprecated
  - response property `oneOf[subschema #1: Incoming Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/traceNumber` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[#/components/schemas/Transaction]/destination/oneOf[subschema #1: Account Destination]/allOf[subschema #2]/onChainTransaction` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #1: Account Source]/allOf[subschema #2]/onChainTransaction` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/accountHolderName` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/accountIdentifier` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/bankIdentifier` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/bankName` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/endToEndId` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/onChainTransaction` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/paymentRail` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/remittanceInformation` deprecated
  - response property `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/source/oneOf[subschema #3: External Funding Source]/allOf[subschema #2]/traceNumber` deprecated
- **2026-10-05** `e73712057c75`: 1 breaking, 1 info
  - added `#/components/schemas/PaymentArsAccountInfo` to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/paymentInstructions/items/accountOrWalletInfo` response property `oneOf` list for the response status `200`
  - added `ARS_ACCOUNT` discriminator mapping keys to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/paymentInstructions/items/accountOrWalletInfo` response property for the response status `200`
- **2026-10-05** `6d67fe99049c`: 3 info
  - removed the `INVALID_PAYREQ_RESPONSE` enum value from the `code` response property for the response status `400`
  - removed the `LOOKUP_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
  - removed the `QUOTE_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
- **2026-10-05** `2685440cbd84`: 1 breaking, 1 info
  - added `#/components/schemas/PaymentBitcoinDepositAddressInfo` to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/paymentInstructions/items/accountOrWalletInfo` response property `oneOf` list for the response status `200`
  - added `BITCOIN_L1` discriminator mapping keys to the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/paymentInstructions/items/accountOrWalletInfo` response property for the response status `200`
- **2026-10-05** `777033714279`: 2 info
  - removed `DKK_ACCOUNT, INR_ACCOUNT, NGN_ACCOUNT, CAD_ACCOUNT, GBP_ACCOUNT, HKD_ACCOUNT, IDR_ACCOUNT, MYR_ACCOUNT, PHP_ACCOUNT, SGD_ACCOUNT, THB_ACCOUNT, VND_ACCOUNT, BITCOIN_L1, AED_ACCOUNT, KES_ACCOUNT, MWK_ACCOUNT, RWF_ACCOUNT, TZS_ACCOUNT, UGX_ACCOUNT, XOF_ACCOUNT, ZAR_ACCOUNT, ZMW_ACCOUNT, BWP_ACCOUNT, XAF_ACCOUNT, BDT_ACCOUNT, ARS_ACCOUNT, EGP_ACCOUNT, GHS_ACCOUNT, GTQ_ACCOUNT, HTG_ACCOUNT, JMD_ACCOUNT, PKR_ACCOUNT, SLV_ACCOUNT, CNY_ACCOUNT, ILS_ACCOUNT, TRY_ACCOUNT` discriminator mapping keys from the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/paymentInstructions/items/accountOrWalletInfo` response property for the response status `200`
  - removed `#/components/schemas/PaymentDkkAccountInfo, #/components/schemas/PaymentInrAccountInfo, #/components/schemas/PaymentNgnAccountInfo, #/components/schemas/PaymentCadAccountInfo, #/components/schemas/PaymentGbpAccountInfo, #/components/schemas/PaymentHkdAccountInfo, #/components/schemas/PaymentIdrAccountInfo, #/components/schemas/PaymentMyrAccountInfo, #/components/schemas/PaymentPhpAccountInfo, #/components/schemas/PaymentSgdAccountInfo, #/components/schemas/PaymentThbAccountInfo, #/components/schemas/PaymentVndAccountInfo, #/components/schemas/PaymentAedAccountInfo, #/components/schemas/PaymentKesAccountInfo, #/components/schemas/PaymentMwkAccountInfo, #/components/schemas/PaymentRwfAccountInfo, #/components/schemas/PaymentTzsAccountInfo, #/components/schemas/PaymentUgxAccountInfo, #/components/schemas/PaymentXofAccountInfo, #/components/schemas/PaymentZarAccountInfo, #/components/schemas/PaymentZmwAccountInfo, #/components/schemas/PaymentBwpAccountInfo, #/components/schemas/PaymentXafAccountInfo, #/components/schemas/PaymentBdtAccountInfo, #/components/schemas/PaymentArsAccountInfo, #/components/schemas/PaymentEgpAccountInfo, #/components/schemas/PaymentGhsAccountInfo, #/components/schemas/PaymentGtqAccountInfo, #/components/schemas/PaymentHtgAccountInfo, #/components/schemas/PaymentJmdAccountInfo, #/components/schemas/PaymentPkrAccountInfo, #/components/schemas/PaymentSlvAccountInfo, #/components/schemas/PaymentCnyAccountInfo, #/components/schemas/PaymentIlsAccountInfo, #/components/schemas/PaymentTryAccountInfo, #/components/schemas/PaymentBitcoinDepositAddressInfo` from the `oneOf[subschema #2: Outgoing Transaction]/allOf[subschema #2]/paymentInstructions/items/accountOrWalletInfo` response property `oneOf` list for the response status `200`
- **2026-10-05** `32bcbd4023e4`: 3 warning
  - added the new `AUTH_CREDENTIAL_VERIFICATION_EXPIRED` enum value to the `code` response property for the response status `400`
  - added the new `AUTH_CREDENTIAL_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the new `OPERATION_IN_PROGRESS` enum value to the `code` response property for the response status `409`
- **2026-10-02** `dfe5a02f2fee`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lightsparkdev/apis/grid-api/docs/transactions/:transactionId/cancel/post.md) - [API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [Page](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/transactions/:transactionId/cancel/post)
