[ADD] pos_qfpay: Add QFPay payment terminal

Author: fja-odoo

content/applications/sales/point_of_sale/payment_methods/terminals.rst

@@ -23,6 +23,7 @@ Then, follow the corresponding documentation to configure your device:
 - :doc:`Adyen configuration <terminals/adyen>`
 - :doc:`Ingenico configuration <terminals/ingenico>`
 - :doc:`Mercado Pago configuration <terminals/mercado_pago>`
+- :doc:`QFPay configuration <terminals/qfpay>`
 - :doc:`Razorpay configuration <terminals/razorpay>`
 - :doc:`SIX configuration <terminals/six>`
 - :doc:`Stripe configuration <terminals/stripe>`
@@ -53,6 +54,7 @@ Successful`.
    terminals/adyen
    terminals/ingenico
    terminals/mercado_pago
+   terminals/qfpay
    terminals/razorpay
    terminals/six
    terminals/stripe

content/applications/sales/point_of_sale/payment_methods/terminals/qfpay.rst

@@ -0,0 +1,67 @@
+=====
+QFPay
+=====
+
+Connecting a **QFPay payment terminal** allows you to offer a fluid payment flow to your customers
+and ease the work of your cashiers.
+
+.. important::
+   - QFPay payment terminals do not require an :doc:`IoT Box </applications/general/iot>`.
+   - QFPay terminals can be used only in **Hong-Kong**.
+
+.. _qfpay/configuration:
+
+QFPay configuration
+===================
+
+To configure your QFPay payment terminal, follow these steps:
+
+#. Create a QFPay account on `QFPay's website <https://qfpay.global/products/qfpay-pos-api/>`_.
+   During your application request for the activation of Asynchronous Notifications, provide your server address, followed by `/qfpay/notify`.
+
+   .. example::
+      Write your server address as followed: `https://yourdomain.odoo.com/qfpay/notify`
+
+   Copy the notification key provided by QFPay.
+
+#. Set up your QFPay terminal by connecting the Haojin App to your QFPay account as instructed by QFPay.
+
+   .. note::
+      Set up a fixed IP address for your terminal.
+      If it changes you will have to update it in the Odoo configuration.
+      You will also need to request an updated self-signed certificate from QFPay.
+
+   Copy the IP address of the terminal.
+
+#. Request a self-signed certificate linked to the IP address of the terminal from QFPay.
+   Import the certificate on the machine running the Odoo POS.
+
+#. Generate a POS-KEY.
+   Login in the Haojin App or in the MMS (Merchant Management System) portal.
+
+   :menuselection:`Haojin App --> My --> Settings --> Pos Call Up Key --> Reset Key`
+   or
+   :menuselection:`MMS portal --> Setting --> Device Setting --> retrieve the POS key`
+
+   Copy that POS-KEY.
+
+Odoo POS configuration
+----------------------------
+
+To connect the QFPay terminal with Odoo Point of Sale, follow these steps:
+
+#. Go to :menuselection:`Point of Sale --> Configuration --> Settings`, scroll down to the
+   :guilabel:`Payment Terminals` section, enable the :guilabel:`QFPay` terminal, and click
+   :guilabel:`Save`.
+#. Go to :menuselection:`Point of Sale --> Configuration --> Payment Methods` and :doc:`create a
+   payment method <../../payment_methods>`.
+#. Set the :guilabel:`Journal` field to :guilabel:`Bank`.
+#. Select the desired point of sale in the :guilabel:`Point of Sale` field.
+#. Set the :guilabel:`Integration` field to :guilabel:`Terminal`.
+#. Set the :guilabel:`Integrate with` field to :guilabel:`QFPay`.
+#. Paste the copied information from :ref:`QFPay <qfpay/configuration>` into the corresponding
+   fields:
+
+   - :guilabel:`Terminal IP`
+   - :guilabel:`POS Key`
+   - :guilabel:`Notification Key`