..
  This file is part of GNU TALER.
  Copyright (C) 2014-2026 Taler Systems SA

  TALER is free software; you can redistribute it and/or modify it under the
  terms of the GNU Affero General Public License as published by the Free Software
  Foundation; either version 2.1, or (at your option) any later version.

  TALER is distributed in the hope that it will be useful, but WITHOUT ANY
  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License along with
  TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/>

  @author Bohdan Potuzhnyi

.. _pos_refunds:

Create Refunds
==============

.. contents::
  :depth: 1
  :local:

Refunds are tied to paid orders. Start from the order history and press
**Refund** on the order card.

.. figure:: ../../images/pos/history.png
   :alt: Point-of-sale order history with refund action
   :width: 70%
   :align: center

   Starting a refund from a paid order.

.. note::

   If the button is not shown, the order has either already been fully refunded
   through Taler, or the refund deadline has expired. In that case, the order
   can no longer be refunded through Taler and must be handled through another
   payment method.

Enter the refund amount and the refund reason. The amount can be the full order
amount or a smaller partial amount, depending on the merchant's policy and the
remaining refundable amount.

.. figure:: ../../images/pos/refund.png
   :alt: Creating a point-of-sale refund
   :width: 70%
   :align: center

   Creating a refund for a paid point-of-sale order.

After the refund is created, the app shows the refund QR code page. The customer
collects the refund with a Taler Wallet by scanning the QR code or opening
the refund URI.

.. figure:: ../../images/pos/refund-qr.png
   :alt: Point-of-sale refund QR code
   :width: 70%
   :align: center

   Refund QR code page.

Leave, Reopen, or Cancel a Refund
---------------------------------

To leave the refund QR code page and continue with another task, press the back
button. This closes the refund QR code page and opens the order history again.

To return to the refund QR code page, open the history page, find the order,
and use the order's **Show refund** action. The refund QR code page for that
order opens again.

To cancel a refund that has not been collected yet, press **Cancel refund** on
the refund QR code page. After the refund is canceled, the customer can no
longer collect that refund.

After the wallet collects the refund, the screen closes automatically and the
order card is updated with refund information. The updated refund state can also
be checked in the Merchant Portal order details.

.. topic:: Next step

   Continue with :ref:`pos_config` to review app settings, language, login
   settings, and app information.