How to integrate Razorpay with systeme.io

In this article, you will learn how to integrate your Razorpay account with your systeme.io account. 

To get started, you will need:

• A Systeme.io account
• A Razorpay account

1. Setup and configuration

1. To connect your Razorpay account to your systeme.io account, click on your profile picture and then on Settings (1).

In the menu on the left of the page, click Payment Gateways (2), then on  Connect (3).

2. Add your Razorpay credentials to your systeme.io account, and click on Save (4).

2. Generating the API keys ID/Secret

To get the API keys ID/secret information from your Razorpay, log into your Razorpay account, go to Settings (4), and then to Websites & API Keys (5). 

Generate and copy the API keys ID/secret (6)

Alternatively, log in to your account and go to https://dashboard.razorpay.com/app/keys to generate and copy the API keys ID/secret.

3. Configuring the Razorpay webhooks

Copy the webhook URL and secret from the Razorpay section in your systeme.io account.

Click on Settings (7), then, from your Razorpay account, go to Webhooks (8) and click on Add new webhook (9).

In the popup that appears, paste the webhook URL and the webhook secret. 

Tick the following fields to configure events: 

a. Payment events:

• payment.authorized
• payment.failed
• payment.captured

b. Order events:

• order.paid

c. Invoice events:

• invoice.paid
• invoice.expired

d. Subscription events:

• subscription.authenticated
• subscription.paused
• subscription.resumed
• subscription.activated
• subscription.pending
• subscription.halted
• subscription.charged
• subscription.cancelled
• subscription.completed
• subscription.updated

e. Refund events:

• refund.processed
• refund.created

IMPORTANT: Make sure to tick the events listed above. Without them, systeme.io will not be able to access the required information to collect the transactions/subscriptions, and customers will not have access to the resources.

Note: For Razorpay integration to work properly, your order form must include these mandatory fields: Email, First name, Last name, and Phone number. Without them, payments cannot be processed through the Razorpay gateway.

4. Supported currencies and restrictions

Before receiving payments, ensure your funnels and products are set up using one of the supported currencies for this gateway.

Razorpay has specific rules depending on whether you are processing one-time payments or subscriptions:

• Supported buyers: India (IN)
• Recurring payments (subscriptions): Yes, but supported in INR only.
• Supported currencies (one-time payments): INR, LKR, PEN, and VND.
• Merchant restrictions: Your Razorpay merchant account must be registered in India (IN).

What happens when a Razorpay payment fails?

In addition to the main payment attempt, three attempts will be made, with one day between each attempt. The delay between each attempt cannot be changed. However, the seller has the option of making a new direct debit attempt without waiting for the one-day delay from his Razorpay dashboard. However, it is important to note that this will not affect the maximum number of attempts.