Skip to content

Refund

Refund

If you want to refund funds to the consumer after the authorization is completed, you need to call the POST Refund interface.

INFO

EVO Cloud supports full refunds and multiple partial refunds, but the total refund amount cannot exceed the original authorized amount, with a maximum refund period of 365 days.

Sync Flow:

Async Flow:

The main process is as follows:

  1. When you initiate a refund, you will 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 Refund request so that EVO Cloud can find the original payment transaction and initiate the refund.

  2. Check the refund.status field in the EVO Cloud response. If the value of this field is Success, it indicates that the refund was successful; otherwise, you need to check result.code and result.message to find out the reason for the transaction failure.

  3. If you do not receive a response from EVO Cloud, you need to call GET Refund to query the transaction result. When you receive the query response, you should also check the refund.status field to determine the transaction result, using the same judgment method as in step 2. If the transaction fails, you need to check refund.failureCode and refund.failureReason to find out the reason for the failure.

  4. If you included a webhook in the POST Refund request and the transaction's refund.status is Success, you can also obtain the transaction result through asynchronous notification, where the eventCode is Refund. You should again check the refund.status field to determine the transaction result, using the same judgment method as in step 2.