# Razorpay

[Razorpay](https://razorpay.com/) is an online payments provider established in India and
covering more than 100 payment methods.

(payment-providers-razorpay-configure-dashboard)=

## Configuration on Razorpay Dashboard

1. 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.
2. 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`
   .
3. Fill the {guilabel}`Secret` field with a password of your choice and save it for later.
4. Make sure the {guilabel}`payment.authorized`, {guilabel}`payment.captured`,
   {guilabel}`payment.failed`, {guilabel}`refund.failed` and {guilabel}`refund.processed`
   checkboxes are ticked.
5. Click on {guilabel}`Create Webhook` to finalize the configuration.

(payment-providers-razorpay-recurring-payments)=

:::{important}
The {guilabel}`Recurring payments` feature must
be activated if you want to make recurring payments.
Send a request to the [Razorpay Support team](https://razorpay.com/support/#request) to
enable recurring payments.
:::

(payment-providers-razorpay-configure-odoo)=

## Configuration on Odoo

1. {ref}`Navigate to the payment provider Razorpay <payment_providers/add_new>` and change its
   state to {guilabel}`Enabled`.
2. 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_providers/razorpay/configure_dashboard`.
3. Configure the rest of the options to your liking.

:::{important}
If you configure Odoo to capture amounts manually:

- Be aware that the **manual voiding** of a transaction is not supported by Razorpay.
- After **five days**, if the transaction hasn't been captured yet, it'll automatically be
  **voided**.
:::

:::{seealso}
- {doc}`../payment_providers`
:::