Refunds
When a shopper returns goods or services, you can issue a refund to return their funds. Make sure to do this promptly to help prevent disputes with the customer’s bank.
Refundable funds
Refundable funds are the funds you can use right now to pay a shopper’s refund in the same currency as the original payment. Refundable funds come from:
- Unsettled funds: recent payments that have not been settled to your Wallet yet.
- Available balance: funds already settled to your Wallet.
Refundable funds are calculated per settlement currency.
A refund succeeds only when at least one source - either unsettled funds or available balance - can fully cover the refund amount, and the combined total of both is at least equal to the refund amount.
This works in the following manner:
- If unsettled funds ≥ refund, we fund from unsettled funds and deduct the refund amount from your next settlement.
- If unsettled funds < refund and available balance ≥ refund, we fund from the available balance by reserving the reserve amount now from your Wallet (into your Wallet reserve balance), then releasing the reserve and deducting the refund amount at the refund settlement time.
- If neither source can fully cover the refund, the refund fails. You can retry after additional sales accrue or after topping up your Wallet.
Refund processing
These are the steps you need to follow for operating refunds.
Use the Airwallex API or web app to create a refund against a specific Payment Intent (or Payment Attempt if you require so). You can perform a full or partial refund; if you make a partial refund several refunds can occur until the principal is fulfilled. If your refund request fails to be processed, please make sure you have enough unsettled funds or available balance for refund.
You will be immediately informed that the refund request has been received and is being processed.
You will be notified when the refund has succeeded through our asynchronous notifications.
Refund statuses
There are four possible statuses for refunds. Detailed explanations and a status transition diagram are provided below.
Status | Webhook event | Explanation |
---|---|---|
RECEIVED | refund.received | The refund has been created. This means the requested refund amount is valid, and the payment is not in dispute. |
ACCEPTED | refund.accepted | The refund has been accepted by the payment method provider. For the vast majority of cases, this status can be used to mean the refund has succeeded. |
SETTLED | refund.settled | The refund has been listed in the payment method provider recon file, and will show up in the Airwallex settlement report. |
FAILED | refund.failed | The refund has been rejected, possibly due to insufficient Airwallex receivable/available balance, or by the provider for channel-specific reasons. |