Skip to main content

Cancel initiated transfers

post/transfers/cancel

Initiates the cancellation of a list of transfers that triggered an additional review. Adyen sends the outcome of the cancel request through webhooks.

To use this endpoint:

  • Your API credential must have the TransferService Approve role.
  • The account holder must have the required capabilities.

Reach out to your Adyen contact to set up these permissions.

Endpoint destination URL
https://balanceplatform-api-test.adyen.com/btl/v4/transfers/cancel
Click to copy
Idempotency-Keystring

A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

transferIdsarray[string]

Contains the unique identifiers of the transfers that you want to cancel.

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

  • 200 - No Content

    Look at the actual response code for the status of the request.

  • 401 - Unauthorized

    Authentication required.

  • 403 - Forbidden

    Insufficient permissions to process the request.

  • 422 - Unprocessable Entity

    A request validation error.

  • 500 - Internal Server Error

    The server could not process the request.