v53

OpenAPI 3.1.0raw.githubusercontent.com2026-07-3128260917.5 KB

Modifications

Cancel an authorised payment

Cancels the authorisation on a payment that has not yet been captured, and returns a unique reference for this request. You get the outcome of the request asynchronously, in a TECHNICAL_CANCEL webhook.

If you want to cancel a payment using the pspReference, use the /payments/{paymentPspReference}/cancels endpoint instead.

If you want to cancel a payment but are not sure whether it has been captured, use the /payments/{paymentPspReference}/reversals endpoint instead.

For more information, refer to Cancel.

post/cancels

Headers

Idempotency-Keystring

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

Request body

merchantAccountstring required

The merchant account that is used to process the payment.

paymentReferencestring required

The reference of the payment that you want to cancel.

referencestring

Your reference for the cancel request. Maximum length: 80 characters.

Response

Created - the request has been fulfilled and has resulted in one or more new resources being created.

merchantAccountstring required

The merchant account that is used to process the payment.

paymentReferencestring required

The reference of the payment to cancel.

pspReferencestring required

Adyen's 16-character reference associated with the cancel request.

referencestring

Your reference for the cancel request.

status'received' required

The status of your request. This will always have the value received.