# Integrate Whatsapp Bot with Telr Payments

## Telr Payments Integration with BotPenguin

The **Telr Payments integration** allows you to collect payments directly within WhatsApp chatbot conversations using the Telr payment gateway. This enables seamless payment flows for e-commerce orders, registrations, and other paid services where WhatsApp does not provide a native payment solution.

***

### What Is Telr Payments?

**Telr** is a secure online payment gateway that supports multiple payment methods. By integrating Telr with BotPenguin, you can:

* Generate payment links dynamically
* Share payment requests in chat
* Receive payment confirmations
* Automate post-payment actions in chatbot flows

***

### Use Cases

Telr Payments integration is commonly used for:

1. **E-commerce Payment Collection**

Collect payments for products directly through WhatsApp when native WhatsApp payments are unavailable.

**How it works:**

* User selects products via chatbot
* Bot shares a Telr-generated payment link
* User completes payment securely
* Bot confirms the order automatically

**Best for:** Online stores, D2C brands, catalog-based selling

**2. Event & Seminar Registrations**

Automate registration payments for paid events, webinars, and seminars.

**How it works:**

* User registers via chatbot
* Bot sends payment link
* Payment confirmation triggers registration success message

**Best for:** Educational institutes, event organizers, coaches

3. **Appointment & Service Bookings**

Collect advance or full payments for services and appointments.

**How it works:**

* User books a service
* Bot requests payment confirmation
* Appointment is confirmed after payment

 **Best for:** Clinics, consultants, salons, agencies

***

### Prerequisites

Before integrating Telr Payments, ensure you have:

* An active **Telr merchant account**
* Telr **Store ID** and **Authentication Key**
* A published **WhatsApp bot** on BotPenguin
* Required webhook or redirect URLs (if applicable)

***

### How to Integrate Telr Payments

#### Step 1: Open Third-party Apps Integration

1. Log in to your **BotPenguin Dashboard**
2. Select the bot you want to integrate
3. Go to **Third-party Apps Integration**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F72V4f6Bda1sj9WzYFtxN%2Fimage.png?alt=media&#x26;token=86eab1bb-5618-4c39-aeb8-ad535075234c" alt=""><figcaption></figcaption></figure>

4. Search for **Telr Payments**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FovyKD5TkK8qd8ankkA66%2Fimage.png?alt=media&#x26;token=070cfab5-b798-4c41-9781-a6d5e0adc9d8" alt=""><figcaption></figcaption></figure>

***

#### Step 2: Open Telr Payments

1. Click connect.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FTLXLBzEDQIKM2Gv54df1%2Fimage.png?alt=media&#x26;token=c1339b4a-3d36-4eb0-b641-0ba61b07bbef" alt=""><figcaption></figcaption></figure>

2. Review the integration details and use cases.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F2RJX3CyHDSzRRz11wwQa%2Fimage.png?alt=media&#x26;token=e842037b-a1e2-421f-aa7d-e9bed19fa406" alt=""><figcaption></figcaption></figure>

3. Click Connect

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FamQlJaJfDS7Sc8LrLbqI%2Fimage.png?alt=media&#x26;token=3b8f007d-bdd3-4e83-bc50-340fc60acd2b" alt=""><figcaption></figcaption></figure>

***

#### Step 3: Configure Telr Credentials

Enter the required Telr details:

* Store ID
* Authentication Key
* Environment (Live / Test)
* Any additional required configuration fields

Click **Connect** to complete the connection.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FtWnk7N3icgdbHOHxtP5W%2Fimage.png?alt=media&#x26;token=ed0a95e6-1037-4b4c-a971-8b34c7a93be5" alt=""><figcaption></figcaption></figure>

***

#### Step 4: Verify Connection Status

* Once connected, the status will change from **Not Connected** to **Connected.**
* This confirms Telr is successfully linked to your bot.

***

### Using Telr Payments in Chat Flows

After successful integration, you can use Telr Payments inside chatbot flows by:

* Triggering payment link generation
* Sending payment links as chat messages
* Capturing payment success or failure
* Redirecting users to confirmation or follow-up flows

Typical flow example:

1. User confirms purchase
2. Bot generates Telr payment link
3. User completes payment
4. Bot verifies payment status
5. Order confirmation message is sent

***

### Payment Status Handling

You can configure chatbot behavior based on:

* Successful payment
* Failed payment
* Abandoned or incomplete payments

This allows automated responses such as:

* Order confirmation
* Retry payment prompts
* Escalation to live agent

***

### Security & Compliance

* Telr handles all payment processing securely
* BotPenguin does not store card details
* Payments are processed on Telr’s secure infrastructure

***

### Common Issues & Troubleshooting

**Payment link not generated**

* Verify Store ID and Authentication Key
* Ensure Telr account is active

**Payment successful but bot not responding**

* Check webhook or redirect configuration
* Verify chat flow logic after payment step

**Connection failed**

* Recheck credentials
* Ensure correct environment (Test vs Live)

***

### Best Practices

* Test payments in **Test mode** before going live
* Clearly inform users before redirecting them to payment
* Add fallback messages for payment failures
* Log payment status for tracking and support

## FAQs

<details>

<summary><strong>What is Telr Payments integration in BotPenguin?</strong></summary>

Telr Payments integration allows you to collect payments within WhatsApp chatbot conversations by generating secure payment links using the Telr payment gateway.

</details>

<details>

<summary><strong>Do I need a Telr account to use this integration?</strong></summary>

Yes. You must have an active Telr merchant account along with valid credentials (Store ID and Authentication Key).

</details>

<details>

<summary><strong>Can I test Telr payments before going live?</strong></summary>

Yes. Telr supports **Test mode**, allowing you to run test transactions before switching to Live mode.

</details>

<details>

<summary><strong>Which platforms support Telr payments?</strong></summary>

Telr Payments can be used across supported BotPenguin channels, including **WhatsApp**, where native payments are not available.

</details>

<details>

<summary><strong>Does BotPenguin store customer payment details?</strong></summary>

No. All payment processing is handled securely by Telr. BotPenguin does not store any card or sensitive payment information.

</details>

<details>

<summary><strong>How does the bot know when payment is successful?</strong></summary>

The bot receives payment status updates through Telr’s response or webhook configuration, which then triggers the next step in the chat flow.

</details>

<details>

<summary><strong>What happens if a payment fails?</strong></summary>

You can configure chatbot flows to:

* Prompt users to retry payment
* Offer alternative payment instructions
* Transfer the conversation to a live agent

</details>

<details>

<summary><strong>Can I use Telr for non-ecommerce payments?</strong></summary>

Yes. Telr can be used for any payment use case such as registrations, bookings, subscriptions, or custom charges.

</details>

<details>

<summary><strong>Is the Telr payment link secure?</strong></summary>

Yes. All payment links are generated and processed on Telr’s secure infrastructure using industry-standard security protocols.

</details>

<details>

<summary><strong>What should I do if Telr connection fails?</strong></summary>

* Recheck your Store ID and Authentication Key
* Ensure the correct environment (Test/Live) is selected
* Verify your Telr account is active

</details>

<details>

<summary><strong>Can I customize messages before and after payment?</strong></summary>

Yes. You can fully customize chatbot messages shown before payment initiation and after payment confirmation.

</details>

<details>

<summary><strong>Is WhatsApp approval required to use Telr Payments?</strong></summary>

No additional WhatsApp approval is required. Payments are handled externally via Telr payment links.

</details>

<details>

<summary><strong>Where can I view payment-related issues or logs?</strong></summary>

You can monitor payment flow issues via:

* Chat flow logic
* API logs
* Telr dashboard transaction history

</details>

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.