diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals.rst b/content/applications/sales/point_of_sale/payment_methods/terminals.rst index aa9eff8ae4..2e2988e7b5 100644 --- a/content/applications/sales/point_of_sale/payment_methods/terminals.rst +++ b/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 ` - :doc:`Ingenico configuration ` - :doc:`Mercado Pago configuration ` +- :doc:`QFPay configuration ` - :doc:`Razorpay configuration ` - :doc:`SIX configuration ` - :doc:`Stripe configuration ` @@ -53,6 +54,7 @@ Successful`. terminals/adyen terminals/ingenico terminals/mercado_pago + terminals/qfpay terminals/razorpay terminals/six terminals/stripe diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/qfpay.rst b/content/applications/sales/point_of_sale/payment_methods/terminals/qfpay.rst new file mode 100644 index 0000000000..54c894a48d --- /dev/null +++ b/content/applications/sales/point_of_sale/payment_methods/terminals/qfpay.rst @@ -0,0 +1,66 @@ +===== +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 `. + - 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 `_. + In your application email, request for the activation of Asynchronous Notifications, provide your server address, followed by `/qfpay/notify`. + If you already have an account, contact `technical.support@qfpay.com` and provide your merchant and store information on top of the server address. + + .. 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 :guilabel:`POS-KEY`. + Login in the Haojin App or in the MMS (Merchant Management System) portal. Go to + :menuselection:`Haojin App --> My --> Settings --> Pos Call Up Key --> Reset Key` or + :menuselection:`MMS portal --> Setting --> Device Setting --> retrieve the POS key`. + +#. Copy that :guilabel:`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 ` into the corresponding + fields: + + - :guilabel:`Terminal IP` + - :guilabel:`POS Key` + - :guilabel:`Notification Key`