To return funds to a shopper after a payment is Approved, you need to refund the payment. Referenced refunds are connected to the original payment, using the unique identifier of that payment.
When you make a POS payment, the Terminal API response returns the transaction identifier of the payment in the format tenderReference.pspReference. To make a referenced refund, you specify this transaction identifier in your refund request. This lets us validate the refund against the original payment, to ensure that it hasn't already been refunded.
You can make a:
- Full refund to return the total value of the purchase to the shopper.
- Partial refund to return part of the purchase to the shopper. For example, when a shopper returns one of the items they purchased. You can also make multiple partial refunds. For example, when a shopper returns several items at different times.
Make a referenced refund
Select a tab to see the parameters that you need to specify for a full referenced refund, or a partial referenced refund.
For a complete list of fields you can pass and receive for a referenced refund, see the ReversalRequest API reference and the ReversalResponse API reference.
Refund an offline payment when back online
When there is a temporary loss of internet connectivity, you can continue making point-of-sale payments. This is referred to as offline payments. The response for an offline payment does not include a PSP reference because PSP references are generated on the Adyen payments platform, and that could not be reached due to the loss of internet connectivity.
If you need to refund such a payment when your integration is back online, you need to accommodate the fact that the PSP reference is missing from the offline payment response.
There are two options:
-
Use the tender reference from the offline payment response.
Payment terminals generate a tender reference for each payment. To make a referenced refund of an offline payment, you provide the tender reference and the date of the offline payment. In most cases you also need to know the unique identifier of the terminal that processed the payment. See the tabs below for details. -
Use the PSP reference from the webhook.
The alternative strategy is to find the PSP reference of the offline payment in the standard webhook that you received (or in your Customer Area). You can then make a regular referenced refund using the PSP reference. In a Mobile solution, this is the only supported option for refunding offline payments.
Refund an ecommerce payment
An ecommerce payment does have a PSP reference, but the tender reference is missing because it is generated by the terminal. To refund an ecommerce payment, you need to know the PSP reference, the date, and the currency of the original payment.