Void a Payment
Cancel a payment before settlement so the transaction is never finalized.
Voiding a payment cancels a transaction before it settles. This is a fast way to cancel a payment—for example, if a customer's item is suddenly out of stock or if the customer changes their mind.
When you void a payment, the held funds are immediately released back to the cardholder's account.
Key information on Voids
| Feature | Description |
|---|---|
| Timing | Can only be performed on unsettled transactions (Sale, Capture, or Authorization). Settlement typically occurs at the end of the business day or processing batch. |
| Effect | The transaction is canceled before funds are transferred to the merchant. This process prevents the sale from being finalized. |
| Customer Impact | The original charge appears as "pending" on the customer's statement, and then is removed. The fund hold is released, making the money available to the customer again. |
| Fund Release Time | Funds are usually available within 24–72 hours after the void is processed. In rare cases, depending on the customer's issuing bank, the hold may take up to **7 business days **to drop off. |
NOTE:
- Voids are only possible before settlement. Once a payment has settled, you must issue a refund instead.
Steps to Void a Payment
To void a transaction, follow these steps:
- First, check the payment has not yet settled by reviewing the
statusfield using aGET checkout/v3/payment?id={id}endpoint. - Make a
DELETErequest tocheckout/v3/payment/{id}endpoint. - After executing the void, you can verify the new status by making another
GETrequest/checkout/v3/payment?id={id}endpoint. - The final response will show the payment's
statusasVoided.
Updated 19 days ago