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.
🔐 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.
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

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.
🔄 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
FAQs
Related Articles
WhatsApp Payment ComponentsWhatsApp Chatbot3rd 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