# Setup RazorPay Account

### Overview

The **Razorpay integration in BotPenguin** allows you to collect payments directly from users during chatbot conversations. Once integrated, all customer payments initiated via your bot are securely processed through your **Razorpay account**.

This integration is commonly used for:

* Order payments
* Service bookings
* Subscriptions
* Payment links via WhatsApp, Web, or other channels

***

### Prerequisites

Before integrating Razorpay with BotPenguin, ensure the following:

* An **active Razorpay account**
* Access to your Razorpay **API Key ID** and **Secret Key**
* Razorpay account set to **Live mode** (for real payments)
* Your bot is already created in BotPenguin

***

### Where to Find Razorpay in BotPenguin

1. Log in to your **BotPenguin Dashboard**
2. From the left sidebar, click **Integrations**
3. Under **Third-party Apps Integrations**, search for **Razorpay**
4. Click **Configure**

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

### Steps to complete integration <a href="#steps-to-complete-integration" id="steps-to-complete-integration"></a>

#### Step 1: Setup Razorpay Account <a href="#step-1-setup-razorpay-account" id="step-1-setup-razorpay-account"></a>

Follow the below official documentation to create the account.

{% embed url="<https://razorpay.com/docs/payments/create-account/>" %}
Razor pay account creation process
{% endembed %}

#### Step 2: Generate Secret Key <a href="#step-2-generate-secret-key" id="step-2-generate-secret-key"></a>

Follow the below official documentation to create the account.

{% embed url="<https://razorpay.com/docs/api/authentication/>" %}
Generate API Crendentials
{% endembed %}

#### Step 3: Open Razorpay Integration

* Go to **Integrations → Razorpay**
* Click the **Configure** button next to Razorpay

You will be redirected to the **Add Razorpay Integration Details** page.

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

***

#### Step 4: Get Razorpay API Keys

1. Log in to your **Razorpay Dashboard**
2. Navigate to **Settings → API Keys**
3. Generate or copy:
   * **Key ID**
   * **Secret Key**

⚠️ Keep your Secret Key confidential. Do not share it publicly.

***

#### Step 5: Enter Razorpay Credentials in BotPenguin

On the Razorpay integration screen, fill in:

* **Razorpay Access Key ID**\
  Paste your Razorpay **Key ID**
* **Razorpay Secret Access Key**\
  Paste your Razorpay **Secret Key**

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

***

#### Step 4: Enable “Charge at Will” (Optional)

* Toggle **“Do you have charge at will enabled”** if:
  * Your Razorpay account supports recurring or token-based charges
  * You plan to charge customers automatically without repeated approvals

If you are unsure, keep this option **disabled**.

***

#### Step 5: Save Integration

* Click **Update Details**
* If the credentials are valid, the integration status will show **Integrated**

Your Razorpay account is now successfully connected to BotPenguin.

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

***

### How Payments Work After Integration

* Payment requests are triggered via chatbot flows
* Customers complete payment using Razorpay’s secure checkout
* Payment status can be captured and used in bot logic
* All transactions are visible in your **Razorpay Dashboard**

***

### Supported Use Cases

* One-time payments
* Product purchases
* Booking confirmations
* Invoice payments
* WhatsApp payment flows (via CTA or payment links)

***

### Common Issues & Troubleshooting

#### Integration Not Saving

* Ensure API keys are copied correctly
* Make sure there are no extra spaces in the keys
* Verify keys are from the correct Razorpay account

#### Payments Not Going Through

* Check if Razorpay account is activated
* Ensure Live keys are used (not Test keys)
* Verify your bot flow is correctly triggering payment events

#### Invalid Credentials Error

* Regenerate API keys in Razorpay
* Update the new keys in BotPenguin

***

### Security Notes

* BotPenguin does not store customer card details
* All payments are processed securely by Razorpay
* API keys are encrypted and stored safely

***

### When to Contact Support

Contact **BotPenguin Support** if:

* Integration shows “Integrated” but payments fail
* You see webhook or callback issues
* Payment status is not updating in bot flows

Provide:

* Bot ID
* Razorpay Account ID
* Screenshot of the integration screen (optional)

#### Need Help?

Please feel free to reach out to us at <mark style="color:$primary;"><support@botpenguin.com></mark>, in case of any questions or concerns.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.botpenguin.com/partner-platform-guidelines/integration-setup/setup-razorpay-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.