From 119ecffb45f6db8a96d78f08fc10af42ed0930c6 Mon Sep 17 00:00:00 2001 From: Mahendra Barad Date: Thu, 2 Jun 2022 12:21:41 +0000 Subject: [PATCH] [ADD] payment_acquirers: add configuration steps for Razorpay task-2800823 closes odoo/documentation#2149 Related: odoo/odoo#92848 Signed-off-by: Antoine Vandevenne (anv) --- .../finance/payment_acquirers.rst | 10 ++-- .../finance/payment_acquirers/razorpay.rst | 47 +++++++++++++++++++ 2 files changed, 53 insertions(+), 4 deletions(-) create mode 100644 content/applications/finance/payment_acquirers/razorpay.rst diff --git a/content/applications/finance/payment_acquirers.rst b/content/applications/finance/payment_acquirers.rst index 4f8f7d581..d3bf88cf9 100644 --- a/content/applications/finance/payment_acquirers.rst +++ b/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 from Odoo - + - Full only + - Full and partial * - :doc:`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` diff --git a/content/applications/finance/payment_acquirers/razorpay.rst b/content/applications/finance/payment_acquirers/razorpay.rst new file mode 100644 index 000000000..93df7cd79 --- /dev/null +++ b/content/applications/finance/payment_acquirers/razorpay.rst @@ -0,0 +1,47 @@ +======== +Razorpay +======== + +`Razorpay `_ 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 `_ 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 ` 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`