Razorpay integration is available as a separate plugin that must be purchased from the Aikeedo Marketplace before you can configure this payment gateway.
Prerequisites
Before you begin, ensure you have:- An active Razorpay merchant account
- Access to your Aikeedo admin panel
- Your domain using HTTPS (valid SSL certificate)
- Business eligibility for accepting payments in India
Step 1: Set up your Razorpay account
If you are new to Razorpay:- Visit the Razorpay website and click Sign Up”.
- Complete onboarding and KYC verification.
- Wait for account approval (usually 1–2 business days).
Step 2: Get your API keys in Razorpay
- Log in to the Razorpay Dashboard.
- Select the mode at the top: Test or Live.
- Go to Account & Settings → API Keys and click Generate Key for the selected mode.
- Copy the following from the pop‑up:
- Key Id (starts with
rzp_test_
in Test orrzp_live_
in Live) - Key Secret (shown once when generated)
- Key Id (starts with
Keep your Key Secret confidential. It is shown only once on generation; store it securely.
Generating Live keys may require your website/app details to be verified in Razorpay. Only users with Owner or Admin role can access API Keys. See Razorpay’s guide: API Keys.
Step 3: Configure required Razorpay settings for subscriptions
These settings are mandatory when you sell subscriptions:- Enable Flash Checkout in your Razorpay Dashboard. See Razorpay’s docs: Subscriptions – Flash Checkout.
- Fee bearer model must be set to You pay the fees. The “Convenience fee model” is not supported for subscriptions. See Razorpay’s guide: Configuration – Fee bearer model.
Without these settings, subscription payments will fail.
Step 4: Create a webhook in Razorpay
- In the Razorpay Dashboard, go to Accounts & Settings → Webhooks.
- Click Add New Webhook.
- Set the Webhook URL to your site URL followed by
/webhooks/razorpay
, for example:https://your-domain.com/webhooks/razorpay
. - Select All events.
- Set a Webhook secret (any random string). Copy it—you will paste the same value into Aikeedo.
- Save the webhook.
The webhook secret must match exactly in Razorpay and in Aikeedo.
Step 5: Enable Razorpay in Aikeedo
Open the Aikeedo admin and go to Payments → Razorpay. Fill in the sections as shown in the Aikeedo dashboard screenshot.Details section
- Status: Enable the toggle to turn on Razorpay.
- Charge Currency: Choose your billing currency. If you use a currency different from your default currency and have a currency rate provider configured, amounts are converted automatically.
- Mode: Choose Test for testing or Live for real payments.
For subscriptions, ensure Flash Checkout is enabled and Fee bearer is set to “You pay the fees” in Razorpay, as noted above.
Keys section
- API Key Id: Paste the value from Razorpay.
- API Key Secret: Paste the secret from Razorpay.
Webhooks section
- Webhook URL: This is shown in the Aikeedo UI. Create the same URL in Razorpay.
- Webhook secret: Paste the exact secret you set in Razorpay.
- Click Save changes.
Razorpay is now connected. You can accept payments and create subscriptions.
Testing your integration
- Set Mode to Test in Aikeedo and use your Razorpay Test keys.
- Make a test purchase or subscription using Razorpay’s test methods: Test Card Details.
- Confirm you see payment updates in Aikeedo and in the Razorpay Dashboard.
The test environment does not move real funds. Switch to Live mode only after successful tests.
Troubleshooting
Subscription payments fail
Subscription payments fail
Check that Flash Checkout is enabled and Fee bearer is set to “You pay the fees” in Razorpay. See: Subscriptions – Flash Checkout and Configuration – Fee bearer model.
No webhook events received
No webhook events received
Verify your site is accessible via HTTPS, the Webhook URL matches
https://your-domain.com/webhooks/razorpay
, and the secret matches in both places.Invalid API credentials
Invalid API credentials
Re‑copy the API Key Id and API Key Secret from Accounts & Settings → API Keys and paste them into Aikeedo.
Additional resources
- Razorpay Subscriptions – Flash Checkout: Subscriptions – Flash Checkout
- Fee bearer model configuration: Configuration – Fee bearer model
- Test cards and sandbox methods: Test Card Details