post https://api.sendwyre.com/v3/orders/:orderId/refund/partner
End-point to request Wallet Order Refunds
Response parameters
walletOrderId: order id being refunded.
createdAt: unix timestamp when the refund was processed.
requester: account SRN of who requested this refund.
status: the refund status. Possible values are COMPLETED, FAILED, CREATED. This value will never change after the refund request ends.
finishedAt: unix timestamp when the refund has finished processing.
failedReason: a string representing the failure detail when status = FAILED.
Retrieve refund details
For convenience, you can fetch at any time the refund details based on the order id.
curl --location --request GET '{{WYRE_API}}/v3/orders/:id/refund' --header 'Content-Type: application/json' --header 'Authorization: Bearer {{YOUR_API_KEY}}'
{
"walletOrderId":"WO_Q9PYNDY8LX",
"createdAt":1611685410000,
"requester":"account:AC_8VF3YWMBZ8X",
"status":"COMPLETED",
"finishedAt":1611685411000,
"failedReason":null
}
Refund Limitations
There is a maximum 30 day time limit to issue a refund, starting from the date of purchase.
Requirements
- This request requires full authentication.
- Wallet order can only be refunded for who created the order (same referrerAccountId).
- Wallet order can be refunded only once. If it fails, it cannot be tried again.
- The accountId issuing the refund should have enough balance available to refund.
- When the refund is accepted, the wallet order amount with the same source currency will be withdrawn from the partner account id. If there are not enough funds available, an exception will be thrown with error code
refund.insufficientFunds. - The refund request completes or fails in the same request.
- Ex, if you want to allow refunds for USD, AUD and EUR, make sure you have a sufficient balance available in your account for all those currencies.