Integrate the Widget on Your Website

Integrate with Affordability Widget to influence your customer's purchase decisions before they reach checkout by displaying various affordable payment options and offers.

Handy Tips

Razorpay Affordability Widget is compatible with all Javascript frameworks like React, Vue, Angular, Svelte and so on.

Prerequisites

Create a
Razorpay account
.
Generate the
API keys
from the
Razorpay Dashboard
by navigating to Account & Settings → Website and app settings → API keys.
You can use the Test Mode keys to test the integration and preview the Widget. Later, switch to Live Mode of the Razorpay Dashboard, generate the
Live API keys
and replace it with the test keys.

Handy Tips

Only the Owner, Admin and Manager roles can enable the widget.

Integration Steps

Follow the integration steps given below to embed the widget on your website.

Follow the integration steps given below to integrate the widget:

Embed the JavaScript file into your website. Copy the snippet and add it to the head section of your website.

<script src="https://cdn.razorpay.com/widgets/affordability/affordability.js">
</script>
Create an HTML element with the below id under the product price. This is to indicate where the affordability widget should appear.
<div id="razorpay-affordability-widget"> </div>

Copy-paste the following snippet to the JS file and link it to your HTML file. Add the test key ID generated from the

Dashboard

const key = "rzp_test_XXXX00000XXXX"; //Replace it with your Test Key ID generated from the Dashboard
const amount = 400000; //in paise

window.onload = function() {
const widgetConfig = {
	"key": key,
	"amount": amount,
};
const rzpAffordabilitySuite = new RazorpayAffordabilitySuite(widgetConfig);
rzpAffordabilitySuite.render();
}

key

mandatory

string API Key ID generated from the

Dashboard

. For example, rzp_test_XXXX00000XXXX.

amount

mandatory

integer The amount to be paid by the customer in paise. For example, if the amount is ₹4000, enter 400000.

Watch Out!

Ensure you pass the final amount in paise to the widget which you want to display to your customers on the product and checkout pages.

You can now preview the widget on your product description page in test mode. Here is a glimpse of the default widget.

Switch to Live Mode

After you preview the widget, switch to live mode and replace the test API keys in the sample code with the live ones to take the integration live. Know more about

live API keys

Once you preview the widget on your product description page, you have to enable the widget to display it on your website for your customers.

Log in to the
Razorpay Dashboard
and navigate to Affordability in the Payment Products section.
Choose Others as your website platform.
Click Enable Widget in the Go live! section.
Select the check box if you consent to enable the widget and click Yes, enable.

Successful Activation

Here is a glimpse of the default widget with offers and payment method options enabled.

Minimum Order Limit

All the payment method options that are enabled and that satisfy the minimum order limit appear on the widget. Know more about the minimum order limit for:

Feature Enablement

Raise a request with our

Support team

to integrate Razorpay Affordability Widget with Checkout. Your customers can select an offer/payment option on the widget, proceed to checkout and complete the payment.

Next Steps

After you successfully integrate the widget on your website, you can choose to

customise the widget

based on your requirement.

Handy Tips

Fill in the
integration support form
in case you are facing any issues with the integration.
In case you have any queries, raise a ticket on the
Razorpay Support Portal
.

Integrate the Widget on Your Website

Prerequisites

Integration Steps

Step 1: Integrate the Widget

Switch to Live Mode

Step 2: Enable the Widget

Successful Activation

Next Steps