[ADD] point_of_sale: documentation to configure razorpay terminal

Added the documentation needed to use razorpay payment method in Point Of Sale.

task- 3762059

closes odoo/documentation#10960

X-original-commit: 5f54878e5f
Signed-off-by: Loredana Perazzo (lrpz) <lrpz@odoo.com>

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:`Razorpay configuration <terminals/razorpay>`
 - :doc:`SIX configuration <terminals/six>`
 - :doc:`Stripe configuration <terminals/stripe>`
 - :doc:`Vantiv configuration <terminals/vantiv>`
@@ -38,6 +39,7 @@ the POS <../payment_methods>`.
    terminals/adyen
    terminals/ingenico
    terminals/mercado_pago
+   terminals/razorpay
    terminals/six
    terminals/stripe
    terminals/vantiv

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

@@ -0,0 +1,70 @@
+========
+Razorpay
+========
+
+Connecting a Razorpay payment terminal allows you to offer a fluid payment flow to your customers
+and ease the work of your cashiers.
+
+.. seealso::
+   :doc:`Use Razorpay as apayment provider. <../../../../finance/payment_providers/razorpay>`
+
+Configuration
+=============
+
+.. _razorpay/credentials:
+
+Locate your Razorpay credentials
+--------------------------------
+
+`Create a Razorpay account <https://razorpay.com/docs/payments/easy-create-account/>`_ and set it up
+on their website.
+
+You need the following credentials to set up the payment method in Odoo:
+
+- `API key <https://razorpay.com/docs/payments/dashboard/account-settings/api-keys/>`_
+- Razorpay username
+- Razorpay device serial number, which can be found underneath the device or on `Razorpay's
+  dashboard <https://dashboard.razorpay.com/>`_.
+
+Configure the payment method
+----------------------------
+
+#. :doc:`Activate the POS Razorpay module <../../../../general/apps_modules>` to enable the
+   payment terminal.
+#. :doc:`Create the related payment method <../../payment_methods>` by going to
+   :menuselection:`Point of Sale --> Configuration --> Payment Methods`.
+
+   #. Set the :guilabel:`Journal` type as :guilabel:`Bank`.
+   #. Select :guilabel:`Razorpay` in the :guilabel:`Use a Payment Terminal` field.
+   #. Enter your username in the :guilabel:`Razorpay Username` field and your device's serial number
+      in the :guilabel:`Razorpay Device Serial No` field.
+   #. Fill in the :guilabel:`Razorpay API Key` field with the :ref:`Razorpay API key
+      <razorpay/credentials>`.
+   #. Set the :guilabel:`Razorpay Allowed Payment Modes` according to your needs.
+
+   .. image:: razorpay/create-method-razorpay.png
+      :alt: Razorpay connection form
+
+   .. note::
+      You can enable the :guilabel:`Razorpay Test Mode` field while testing or keep it unchecked for
+      production.
+
+Once the payment method is created, you can enable it for your POS. To do so, go to the :ref:`POS'
+settings <configuration/settings>` and add the payment method under the :guilabel:`Payment` section.
+
+Pay with a payment terminal
+===========================
+
+When processing a payment, select the Razorpay payment method. Check the amount and click
+:guilabel:`Send`. Once the payment is successful, the status changes to :guilabel:`Payment
+Successful`. To cancel the payment request, click :guilabel:`Cancel`.
+
+.. image:: razorpay/payment-screen.png
+   :alt: Razorpay connection form
+
+.. note::
+   - | In case of connection issues between Odoo and the payment terminal, force the payment by
+       clicking on :guilabel:`Force Done`, which allows you to validate the order.
+     | This option is only available after receiving an error message informing you that the
+       connection failed.
+   - The terminal must have at least a 10% battery level to use it.