Docs
This feature is a Private Beta Release. Contact support to enable Razorpay payment gateway for your Test and Live site.
Razorpay is a payment solution that offers a fast, affordable, and secure way to accept and disburse payments online. It has quickly grown to be the preferred payment gateway for businesses across India. Chargebee now offers Razorpay as a payment gateway for customers based in India.
The following criteria must be considered prior to choosing Razorpay as your payment solution:
Chargebee offers the following options to integrate with Razorpay:
Review the table below for additional information:
Integration Type | Description | PCI Requirements | 3DS supported? |
---|---|---|---|
Chargebee Hosted Pages | In this method, the card information of the customers are collected by Chargebee's checkout and directly passed on to Razorpay. | Low (Your PCI compliance requirements are greatly reduced due to usage of Chargebee's checkout) |
Yes |
Gateway JS Note: Netbanking is not supported by this mode of integration |
In this method, the card details are captured and tokenized on your side by Razorpay and the token is sent to Chargebee. | Low (Since the card details are tokenized by Razorpay) |
Yes |
Razorpay Checkout + Chargebee's API Note: Netbanking is not supported by this mode of integration |
In this method, the card details are captured and tokenized on your side by Razorpay and the token is sent to Chargebee. | Low (Since the card details are tokenized by Razorpay) |
Yes |
Chargebee JS + Chargebee API | In this method, you can use Chargebee Components and Hosted Fields to collect the customers card details. | Low | Yes |
Razorpay supports various account types and additional options to cater to different business needs, such as collecting both domestic and international payments. Previously, the Chargebee and Razorpay integration only supported domestic accounts with INR currency. To facilitate export payments for India-based businesses, the integration now also supports export accounts, allowing for payments in non-INR currencies.
Enabling export payments within your domestic account allows you to seamlessly handle both domestic and international transactions. To set up or modify these options, please contact Chargebee support .
To handle export payments (collecting payments in non-INR currencies for India-based businesses), you need to enable international payments separately. This feature is not enabled by default. Please refer to this Razorpay documentation to understand the steps required to enable international payments and cards, which is mandatory for collecting non-INR payments through Chargebee with Razorpay.
The following prerequisites must be met prior to configuring this integration:
This configuration is completed on your Razorpay and Chargebee site:
Prior to configuration, you must retrieve the Key ID and Key Secret for your Razorpay account. Follow the steps below to retrieve this information.
Log into your Razorpay account.
If you have a copy of the previously generated Key ID and Secret Key, then make a note of these and proceed to Add Razorpay Gateway. If you don't, Navigate to Settings > API Keys, and Click Regenerate Key.
Select the applicable option to disable the previous key in the Roll Key pop-up, and click OK to view the details.
Note:
Follow the steps below to configure Razorpay with your Chargebee site:
Navigate to Settings > Configure Chargebee > Payment Gateways > Add Gateway.
Click Razorpay.
Enter the Key ID and Key Secret from your Razorpay account in the applicable fields.
Select the relevant account type from the Razorpay Account Type drop-down menu and click Connect.
The configuration of the Webhooks is a mandatory prerequisite for this integration to function effectively. Follow the steps below to configure Webhooks:
Review the Notification URL and Secret in the Notification URL pop-up, these must be copied to your Razorpay site to ensure that Chargebee receives notifications for all events associated with this account.
Login to your Razorpay account, Navigate to Settings > Webhooks > Add new Webhook.
Copy and paste the Notification URL in the Webhook URL field.
Copy and paste the Secret from the Notification URL pop-up and check all events within Active events to receive notifications.
Enter the email you want to use for webhook alerts and notifications.
Click Create Webhook.
Once complete return to the Chargebee configuration page, check the I have added this URL in Razorpay box, and click Continue.
You can choose to enable the payment methods to support your Razorpay- Chargebee integration. It is important that you ensure the applicable payment methods are enabled in Razorpay.
Netbanking e-mandate and UPI mandate payment methods differ from conventional Netbanking and UPI which are used for P2P or A2A transfers. Chargebee's implementation of Netbanking mandate and UPI mandates are optimized for recurring payments and adhere to limitations prescribed by Razorpay and banks.
Follow the steps below to enable payment methods for your Razorpay payment gateway:
Toggle-on the applicable payment methods (Cards, UPI, and Netbanking e-Mandate) you would like to enable for your Chargebee site.
Review your Smart Routing settings to choose Razorpay as the preferred gateway for UPI and Netbanking (eMandate) payments.
Outcome: The Razorpay gateway is now configured for your Chargebee site.
Click here to review the checkout flow for Netbanking and UPI payment methods.
Customers can choose to process card payments via Razorpay. However, the following conditions will apply:
The following steps indicate the checkout process for a subscription while using card transactions:
Note: Click here for the checkout flow associated with Netbanking and UPI payment methods.
Review the order details and click Proceed to checkout.
Enter your account details and shipping addresses in the subsequent screens to proceed.
Click the Credit Card tab and enter the card details into each of the fields. Click Next to proceed.
Review the details for the mandate to be set up and click Proceed to review.
Click the pay button to proceed to complete your transaction.
Complete the 3DS authentication when redirected to the bank page.
Upon successful authentication, customers are redirected to the checkout to confirm the subscription purchase. — !>