Capture

Capture

You can initiate the capture request through the POST Capture interface. You can specify the amount you want to complete, but it cannot exceed the original authorized transaction amount.

Sync Flow:

Async Flow:

The main process is as follows:

1. When you initiate the capture, use the merchantTransInfo.merchantTransID that you provided when calling the POST Payment interface. You need to add this parameter to the URL of the POST Capture request so that EVO Payment can locate the original authorization transaction and initiate the capture.

2. Check the capture.status field in the EVO Payment response. If the value is Success, the transaction was successful; otherwise, check result.code and result.message for the reason for the transaction failure.

3. If you do not receive a response message from EVO Payment, you need to call GET Capture to query the transaction result. Upon receiving the query response, evaluate the transaction result using the capture.status field in the same manner as in step 2. If the transaction failed, refer to capture.failureCode and capture.failureReason for details on the failure.

4. If you included a webhook in your POST Capture request and the transaction's capture.status is Success, you can also obtain the transaction result through asynchronous notification, where the eventCode is Capture. Again, assess the transaction result using the capture.status field as in step 2.