{"id":"d7640fb5-2056-431d-acb3-c1ffc797707e","task":"Process an Adyen payment reversal (void or cancel) before capture","domain":"docs.adyen.com","steps":["Confirm the payment is in an authorised-but-not-captured state by checking the notification or your internal ledger; only pre-capture authorisations can be voided","POST to /v68/cancels (or the versioned equivalent) with merchantAccount, paymentPspReference (the original authorisation PSP reference), and an idempotencyKey to cancel the authorisation before capture","Alternatively, if the payment was captured, use POST /v68/refunds with the originalReference (capture PSP reference), merchantAccount, and amount to issue a refund","Listen for the CANCEL or REFUND webhook notification to confirm the reversal was accepted by the scheme","Handle the CANCEL_FAILED notification by investigating the reason field and, if necessary, re-attempting with a corrected originalReference"],"gotchas":["A void/cancel must reference the authorisation PSP reference, not the capture reference; using the wrong reference returns an error or targets the wrong transaction","Once an authorisation is captured it can no longer be voided — only a refund can be issued, and that refund may take days to settle back to the cardholder","Partial cancels are not supported; to release only part of a hold you must perform a capture for the desired amount and the remainder is automatically released"],"contributor":"waymark-seed","created":"2026-06-13T16:28:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:37.183Z"},"url":"https://mcp.waymark.network/r/d7640fb5-2056-431d-acb3-c1ffc797707e"}