..
  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_authentication:

Sign in to the Point-of-Sale App
================================

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

The point-of-sale app connects to a GNU Taler Merchant Portal account. The
account and the password must already exist before the merchant can use the app.
For the Merchant Portal setup, see the
:ref:`merchant-backoffice` tutorials. To obtain a hosted account on
``my.taler-ops.ch``, see :ref:`obtain_instance_taler_ops_ch`. To try the app
with the public demo Merchant Portal instead, see
:ref:`the sandbox instructions <pos_sandbox>`.

Open the app and enter the Merchant Portal URL and password.

.. figure:: ../../images/pos/login.png
   :alt: Taler point-of-sale login screen
   :width: 70%
   :align: center

   Login screen for connecting the app to a Merchant Portal account.

If the Merchant Portal account requires multi-factor authentication, select the
available authentication method.

.. figure:: ../../images/pos/mfa-select.png
   :alt: Selecting a multi-factor authentication method
   :width: 70%
   :align: center

   Selecting the authentication method for the Merchant Portal account.

Then enter the generated one-time code to finish the login.

.. figure:: ../../images/pos/mfa-code.png
   :alt: Entering a one-time authentication code
   :width: 70%
   :align: center

   Entering the one-time code required by the Merchant Portal.

After a successful sign-in, the main navigation is available. From here the
merchant can create orders, inspect the order history, and handle refunds.

.. figure:: ../../images/pos/navigation.png
   :alt: Main navigation of the Taler point-of-sale app
   :width: 70%
   :align: center

   Main navigation after the app is connected to the Merchant Portal.

.. topic:: Next step

   Continue with :ref:`pos_orders` to create and complete a customer order.