For payment methods that support separate Capture (such as international credit card payments), the payment process is completed in two steps:

• Authorization: Verify the shopper's payment details with the issuer and reserve funds.
• CAPTURE: Transfer the reserved funds from the shopper to your account.

Void: If you have successfully authorized but do not want to perform CAPTURE, you can initiate a void operation. Void typically refers to canceling a payment that has been authorized but not yet captured. This operation releases the previously reserved funds, ensuring that funds are not deducted from the shopper's account. This is different from refund, which is performed on captured funds. Void is a common "modification" operation in the payment field that directly affects the status of authorized or captured payments.

Initiating VOID

For orders with AUTH_SUCCESS status, you can initiate a VOID operation by calling the VOID-Pre-Authorization Cancellation API. To receive asynchronous notifications for VOID, please set notificationUrl. For detailed message content, see Pre-Authorization Cancellation Asynchronous Notification

Note

When you cannot confirm whether the original transaction has already been captured, you can call Single Transaction Query.

Handling VOID Operation Status

After calling the VOID-Pre-Authorization Cancellation API, you may receive the following status optional values in the synchronous response:

• SUCCESS - Success
• FAILED - Failed
• PROCESSING - Processing

To handle the PROCESSING situation, you need to correctly set notificationUrl when calling the VOID-Pre-Authorization Cancellation API, so as to correctly receive Pre-Authorization Cancellation Asynchronous Notification

In the VOID notification flow, status returns the final VOID result, which is either SUCCESS or FAILED.

Note

When you don't receive asynchronous notifications or cannot confirm the status, you can call Pre-Authorization Cancellation Query. In the query response, status can return SUCCESS, FAILED, or PROCESSING.

Multiple VOID

The CAPTURE-Pre-Authorization Confirmation API is idempotent based on merchantVoidId, allowing you to safely call it multiple times.

Note

Partial VOID is currently not supported; the total amount of VOID must equal the transaction amount

• When merchantVoidId is the same, calling the VOID-Pre-Authorization Cancellation API again will return query results.
• When you need to retry calling the VOID-Pre-Authorization Cancellation API due to failure, you need to update merchantVoidId and re-initiate the request.

Previous pageCapture

Next pageRefund