Void a payment
Last updated: August 14, 2024
After a card payment has been authorized, the payment is not complete until it has been captured. If you do not wish to capture the payment, you can void it using the void API described below.
Information
For Visa and Mastercard payments, you can submit a void request on a partially captured payment to release the remaining funds back to the cardholder. If you don't request it, we'll automatically void the remainder and return it to the customer when the authorization expires.
Use the endpoint below to void an authorized—but not yet captured—payment.
For the full API specification, see the API reference.
Information
The Payments API supports idempotency. You can safely retry API requests without the risk of duplicate requests.
post
https://api.checkout.com/payments/{id}/voids
If you receive a 202 Void accepted response, your void request has been accepted for processing. To get the full void response, you will need to subscribe to the payment_voided webhook.
If there was a problem with your request, you'll receive an error response such as 422 Invalid data was sent.
Information
If unsuccessful, you may also receive a 403 Void not allowed or 404 Payment not found error.