[ADD] payment_acquirers: add configuration steps for Razorpay

task-2800823

closes odoo/documentation#2149

Related: odoo/odoo#92848
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>

content/applications/finance/payment_acquirers.rst

@@ -19,6 +19,7 @@ Payment acquirers (credit cards, online payments)
    payment_acquirers/mollie
    payment_acquirers/ogone
    payment_acquirers/paypal
+   payment_acquirers/razorpay
    payment_acquirers/sips
    payment_acquirers/stripe
 
@@ -126,11 +127,11 @@ Online payment acquirers
      -
      -
      -
-   * - PayUMoney
-     - Payment from the acquirer website
-     -
-     -
+   * - :doc:`Razorpay <payment_acquirers/razorpay>`
+     - Payment from Odoo
      -
+     - Full only
+     - Full and partial
    * - :doc:`SIPS <payment_acquirers/sips>`
      - Payment from the acquirer website
      -
@@ -376,6 +377,7 @@ payment method... What best suit your needs.
    - :doc:`payment_acquirers/mollie`
    - :doc:`payment_acquirers/ogone`
    - :doc:`payment_acquirers/paypal`
+   - :doc:`payment_acquirers/razorpay`
    - :doc:`payment_acquirers/sips`
    - :doc:`payment_acquirers/stripe`
    - :doc:`../websites/ecommerce/shopper_experience/payment_acquirer`

content/applications/finance/payment_acquirers/razorpay.rst

@@ -0,0 +1,47 @@
+========
+Razorpay
+========
+
+`Razorpay <https://razorpay.com/>`_ is an online payments provider established in India and
+covering more than 100 payment methods.
+
+.. _payment_acquirers/razorpay/configure_dashboard:
+
+Configuration on Razorpay Dashboard
+===================================
+
+#. Log into `Razorpay Dashboard <https://dashboard.razorpay.com/>`_ and go to
+   :menuselection:`Settings --> API Keys`. Generate the new keys and copy the values of the
+   :guilabel:`Key Id` and :guilabel:`Secret Key` fields and save them for later.
+#. | Go to :menuselection:`Settings --> Webhooks`, click on :guilabel:`Create New Webhook`,
+     and enter your Odoo database URL followed by `/payment/razorpay/webhook` in
+     the :guilabel:`Webhook URL` text field.
+   | For example: `https://example.odoo.com/payment/razorpay/webhook`.
+#. Fill the :guilabel:`Secret` field with a password of your choice and save it for later.
+#. Make sure the :guilabel:`payment.authorized`, :guilabel:`payment.captured`,
+   :guilabel:`payment.failed`, :guilabel:`refund.failed` and :guilabel:`refund.processed`
+   checkboxes are ticked.
+#. Click on :guilabel:`Create Webhook` to finalize the configuration.
+
+.. _payment_acquirers/razorpay/configure_odoo:
+
+Configuration on Odoo
+=====================
+
+#. :ref:`Navigate to the payment acquirer Razorpay <payment_acquirers/add_new>` and change its
+   state to :guilabel:`Enabled`.
+#. In the :guilabel:`Credentials` tab, fill the :guilabel:`Key Id`, :guilabel:`Key Secret`, and
+   :guilabel:`Webhook Secret` with the values you saved at the step
+   :ref:`payment_acquirers/razorpay/configure_dashboard`.
+#. Configure the rest of the options to your liking.
+
+.. important::
+  - If you configure Odoo to capture amounts manually, make sure to set the
+    :guilabel:`Manual Capture` to :guilabel:`manual` on Razorpay. Otherwise, the transaction
+    would be blocked in the authorized state in Odoo. To do so, go to your Razorpay Dashboard and
+    then to :menuselection:`Settings --> Configuration`.
+  - After **five days**, if the transaction hasn't been captured yet, the customer has the right
+    to **revoke** it.
+
+.. seealso::
+   - :doc:`../payment_acquirers`