Integrate BotPenguin with Razorpay
This section contains essential information and usage guidelines for integrating Razorpay with your BotPenguin WhatsApp Bot.
What is Razorpay?
Razorpay is a secure payment gateway that enables businesses to collect online payments through multiple payment methods, including UPI, credit cards, debit cards, net banking, wallets, and more.
Integrating Razorpay with BotPenguin allows your WhatsApp chatbot to securely collect payments from customers directly within conversations.
When should you use this?
Use this integration when:
You want to collect payments through your WhatsApp chatbot.
You need customers to complete payments without leaving the conversation.
You want to automate payment collection using Razorpay.
Benefits of Razorpay Integration
π³ Collect payments directly through your WhatsApp chatbot.
β‘ Support multiple payment methods through Razorpay.
π Receive payment status updates automatically.
π€ Automate payment collection within chatbot conversations.
π Provide a seamless payment experience for your customers.
Expected Outcome
After completing this setup:
Razorpay will be connected to your BotPenguin account.
Your WhatsApp chatbot will be able to generate payment requests.
Payment status will automatically sync with BotPenguin.
Razorpay can be selected as the payment gateway inside the Payment Component.
Tip: Perform a test payment after completing the setup to verify everything is working correctly.
π Prerequisites
Before setting up this integration, ensure you have:
A BotPenguin account.
An active Razorpay account.
A WhatsApp Bot.
Access to your Razorpay API Keys.
Permission to create Webhooks in Razorpay.
Missing any of the above prerequisites may prevent successful integration.
How to Use Razorpay
1. Open Razorpay Integration
Log in to your BotPenguin account.
Select the WhatsApp Bot you want to configure.
Navigate to Third Party Integrations.
Search for Razorpay.
Click Connect.

2. Generate Razorpay API Keys
Log in to your Razorpay Dashboard.
Search for API Keys.

Open the API Keys page.
If you do not already have credentials, click Generate New API Key.

Copy the following credentials:
Key ID
Key Secret
Store the Key Secret securely. It may not be visible again after creation.

3. Connect Razorpay
Return to BotPenguin.
Enter your:
Razorpay Key ID
Razorpay Key Secret
Click Connect.

4. Configure Razorpay Webhook
To allow BotPenguin to receive payment status updates, configure a webhook in Razorpay.
In Razorpay, navigate to Account Settings β Webhooks.
Click Add Webhook.

Return to BotPenguin and copy the Webhook URL displayed in the Razorpay integration.
Paste this URL into Razorpay.
Select the following events:
payment.failed
payment_link.paid
payment_link.partially_paid
payment_link.expired
payment_link.cancelled
Click Create Webhook.

5. Open Your Chatflow
Navigate to Chat Flows.

Open the chatflow where you want to collect payments.
You can either:
Open an existing chatflow, or
Create a new chatflow.
6. Add the Payment Component
Add the Payment component onto your chatflow.

Open the component configuration.

7. Configure the Payment Component
Before configuring the payment provider, enter the payment message that will be displayed to the customer.
This message should clearly explain what the customer is paying for before they proceed with the payment.

8. Select RazorPay as the Payment Method and add Payment Amount
Under Payment Method, open the dropdown.
Select RazorPay

Add the amount you want to collect using the link.
Once selected, the Payment component will use your connected RazorPay account to process customer payments.
9. Configure the Flow Logic
Choose what should happen after the payment attempt.

Payment Successful: Select the next chatflow that should be displayed after the payment is completed successfully.
Payment Failed: Select the next chatflow that should be displayed if the payment fails or is cancelled.
Go to next message: You can define the next message the component should redirect the flow to incase the component fails to work.
This allows you to create different conversation paths based on the payment outcome.
Your chatbot is now ready to collect payments using RazorPay. Publish your chatflow to make the payment experience available to your customers.
π How Data Flows
A customer initiates payment through your WhatsApp chatbot.
BotPenguin creates a payment request using Razorpay.
The customer completes the payment.
Razorpay sends payment updates to BotPenguin through the configured webhook.
BotPenguin updates the payment status and continues the chatbot flow based on the payment result.
π« Limitations
Razorpay Integration is supported only for WhatsApp Bots.
Webhook configuration is mandatory for automatic payment status updates.
Invalid API credentials will prevent the integration from connecting.
Removing the webhook may stop payment status synchronization.
Best Practices
π‘ Configure the webhook before using Razorpay in production.
β οΈ Perform a test payment after completing the setup.
π Keep your API credentials secure.
π― Regularly verify webhook delivery from your Razorpay Dashboard.
Troubleshooting
Unable to connect Razorpay
Likely Cause: The Razorpay Key ID or Key Secret was entered incorrectly.
Resolution: Verify that the Razorpay Key ID and Key Secret have been entered correctly, then reconnect the integration.
Payment status is not updating
Likely Cause: The Razorpay webhook is not configured correctly or required events are not enabled.
Resolution: Verify that the Razorpay webhook has been configured correctly and that all required webhook events are enabled.
Webhook events are not reaching BotPenguin
Likely Cause: The webhook URL is incorrect, inactive, or not configured properly in Razorpay.
Resolution: Ensure the webhook URL has been copied correctly and is active in your Razorpay Dashboard.
Razorpay is not available in the Payment Component
Likely Cause: The Razorpay integration has not been connected successfully.
Resolution: Verify that the integration has been connected successfully from Third Party Apps Integration. Refresh the chatbot editor if necessary.
FAQs
Which bots support Razorpay Integration?
Razorpay Integration is currently supported only for WhatsApp Bots.
Why do I need to configure a webhook?
The webhook allows Razorpay to notify BotPenguin about payment events, enabling automatic payment status updates.
Where can I find my Razorpay API Keys?
Log in to your Razorpay Dashboard and navigate to the API Keys section to generate or view your credentials.
Can I regenerate my API Keys?
Yes. If you generate new API Keys, update them in BotPenguin and reconnect the integration.
Can I use Razorpay without configuring the webhook?
No. The webhook is required for BotPenguin to receive payment status updates from Razorpay.
How can I verify that the integration is working?
Configure the Payment Component with Razorpay as the payment gateway and perform a test payment through your WhatsApp chatbot.
Related Articles
WhatsApp Payment ComponentsWhatsapp Bot3rd Party Apps Integrationsπ Completion
π Congratulations! Your Razorpay account has been successfully connected to BotPenguin. You can now securely collect payments through your WhatsApp chatbot.
Support
If you still have questions for our team, write to us at support@botpenguin.com. We'll get back to you within 48 hours.
Last updated
Was this helpful?