> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/bots/website-mobile-app-bot/3rd-party-integrations/botpenguin-integrations/integrate-botpenguin-with-razorpay.md).

# Integrate BotPenguin with Razorpay

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.

{% hint style="info" icon="lightbulb" %}
**Tip:** Perform a test payment after completing the setup to verify everything is working correctly.
{% endhint %}

***

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

{% hint style="warning" icon="triangle-exclamation" %}
Missing any of the above prerequisites may prevent successful integration.
{% endhint %}

***

## How to Use Razorpay

### 1. Open Razorpay Integration

1. Log in to your BotPenguin account.
2. Select the WhatsApp Bot you want to configure.
3. Navigate to **Third Party Integrations**.
4. Search for **Razorpay**.
5. Click **Connect**.

<figure><img src="/files/bjMPoJ8h6UvFwW6fOF3r" alt=""><figcaption></figcaption></figure>

***

### 2. Generate Razorpay API Keys

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

<figure><img src="/files/dUvR9DcdZaRCDjixmMM8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/eoE3GIrUj6quAA7TZguj" alt=""><figcaption></figcaption></figure>

5. Copy the following credentials:
   1. Key ID
   2. Key Secret

{% hint style="info" %}
Store the Key Secret securely. It may not be visible again after creation.
{% endhint %}

<figure><img src="/files/SuaG02tmXnoX0g55OnWt" alt=""><figcaption></figcaption></figure>

***

### 3. Connect Razorpay

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

<figure><img src="/files/gep987J8w0rUlbAHQNDG" alt=""><figcaption></figcaption></figure>

***

### 4. Configure Razorpay Webhook

To allow BotPenguin to receive payment status updates, configure a webhook in Razorpay.

1. In Razorpay, navigate to **Account Settings → Webhooks**.
2. Click **Add Webhook**.

<figure><img src="/files/UJaOx5Se9W8Bd9DJSSH2" alt=""><figcaption></figcaption></figure>

3. Return to BotPenguin and copy the **Webhook URL** displayed in the Razorpay integration.
4. Paste this URL into Razorpay.
5. Select the following events:
   1. payment.failed
   2. payment\_link.paid
   3. payment\_link.partially\_paid
   4. payment\_link.expired
   5. payment\_link.cancelled
6. Click **Create Webhook**.

<figure><img src="/files/qwbOAvBd6Iy38lduJima" alt=""><figcaption></figcaption></figure>

***

### 5. Open Your Chatflow

1. Navigate to **Chat Flows**.

<figure><img src="/files/5QR96Y6OpYUk2xcmCsKz" alt=""><figcaption></figcaption></figure>

2. Open the chatflow where you want to collect payments.
3. You can either:
   1. Open an existing chatflow, or
   2. Create a new chatflow.

### 6. Add the Payment Component

1. Add the **Payment** component onto your chatflow.

<figure><img src="/files/l5nSXXz2IpYCifVreOpL" alt=""><figcaption></figcaption></figure>

2. Open the component configuration.

<figure><img src="/files/chCUBotDfPAKUrgC2E92" alt=""><figcaption></figcaption></figure>

***

### 7. Configure the Payment Component

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

<figure><img src="/files/evCQOA8okizmCSUoDvDQ" alt=""><figcaption></figcaption></figure>

***

### 8. Select RazorPay as the Payment Method and add Payment Amount

1. Under **Payment Method**, open the dropdown.
2. Select RazorPay

<figure><img src="/files/FJvgXwtspFubiZMGDvAN" alt=""><figcaption></figcaption></figure>

3. Add the amount you want to collect using the link.
4. Once selected, the Payment component will use your connected RazorPay account to process customer payments.

***

### 9. Configure the Flow Logic

1. Choose what should happen after the payment attempt.

<figure><img src="/files/LwzWdeX6f3hKrQSNQgdc" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" icon="lightbulb" %}
Your chatbot is now ready to collect payments using RazorPay. Publish your chatflow to make the payment experience available to your customers.
{% endhint %}

***

### 🔄 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

<details>

<summary>Unable to connect Razorpay</summary>

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

</details>

<details>

<summary>Payment status is not updating</summary>

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

</details>

<details>

<summary>Webhook events are not reaching BotPenguin</summary>

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

</details>

<details>

<summary>Razorpay is not available in the Payment Component</summary>

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

</details>

***

### FAQs

<details>

<summary>Which bots support Razorpay Integration?</summary>

Razorpay Integration is currently supported only for **WhatsApp Bots**.

</details>

<details>

<summary>Why do I need to configure a webhook?</summary>

The webhook allows Razorpay to notify BotPenguin about payment events, enabling automatic payment status updates.

</details>

<details>

<summary>Where can I find my Razorpay API Keys?</summary>

Log in to your **Razorpay Dashboard** and navigate to the **API Keys** section to generate or view your credentials.

</details>

<details>

<summary>Can I regenerate my API Keys?</summary>

Yes. If you generate new API Keys, update them in BotPenguin and reconnect the integration.

</details>

<details>

<summary>Can I use Razorpay without configuring the webhook?</summary>

No. The webhook is required for BotPenguin to receive payment status updates from Razorpay.

</details>

<details>

<summary>How can I verify that the integration is working?</summary>

Configure the **Payment Component** with **Razorpay** as the payment gateway and perform a test payment through your WhatsApp chatbot.

</details>

***

### Related Articles

{% content-ref url="/pages/cmLvotoMRdKwoaeUrDz5" %}
[WhatsApp Payment Components](/bots/whatsapp-bot/manage-chatflow/components-in-chatflow/whatsapp-payment-components.md)
{% endcontent-ref %}

{% content-ref url="/pages/7aa674tex06UpOx7vym3" %}
[Whatsapp Bot](/bots/whatsapp-bot.md)
{% endcontent-ref %}

{% content-ref url="/pages/Cq9bB7zQMzuTT8Cbm0s7" %}
[3rd Party Apps Integrations](/bots/whatsapp-bot/3rd-party-apps-integrations.md)
{% endcontent-ref %}

***

### 🎉 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**](mailto:support@botpenguin.com). We'll get back to you within 48 hours.