> 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/whatsapp-bot/manage-chatflow/components-in-chatflow/whatsapp-payment-components.md).

# WhatsApp Payment Components

### What is the WhatsApp Payment Component?

The WhatsApp Payment Component lets you collect payments directly inside a chat conversation, without redirecting users away from WhatsApp. It allows you to trigger a payment request mid-flow and helps you close transactions at the exact moment a customer is ready to buy — right inside the conversation layer.

***

### When should you use this?

Use this feature when:

* You want customers to complete a purchase without leaving WhatsApp
* You need to collect payment for orders, bookings, or services triggered from a chat flow
* You are trying to reduce checkout friction and cart abandonment on a high-volume channel like WhatsApp

***

### Benefits of WhatsApp Payment Components

* 🚀 Helps you close sales in-conversation, without a separate checkout page
* ⏱️ Reduces time spent manually sharing payment links or following up
* 🎯 Improves conversion by keeping the entire journey inside one chat
* 🔄 Ensures consistency across payment methods and currencies
* 📈 Enhances trust with a native, WhatsApp-first payment experience

***

### Expected Outcome

After setting this up:

* Your chat flow will trigger a payment request at the right step automatically
* You will notice fewer drop-offs between "ready to buy" and "paid"
* Users will experience a single continuous conversation, from inquiry to confirmed payment

{% hint style="info" icon="lightbulb" %}
Tip: Route both successful and failed payment outcomes to their own flows so users always get a clear next step.
{% endhint %}

***

### How to Use WhatsApp Payment Components

There are two ways to accept payments on WhatsApp: the standard "Payments" component (redirect-based, via a third-party gateway) and the "WhatsApp Payments" component (native, in-chat, requires Meta business verification). Section C covers the one-time setup needed for the native option.

#### Section A: Using the "Payments" Component

1. Go to your chosen WhatsApp bot, then click "Edit Your Chatflow".

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

2. Select the flow you want to add the Payment component to.
3. Go to "Decide and Act", then click "Payments" to add the component.

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

4. Configure the payment settings:
   1. Select Payment Method: Choose from
      1. All Pay,
      2. RazorPay,
      3. Peach Payments,
      4. Telr Pay,
      5. Tilo Pay,
      6. Worldpay, or
      7. Payfast.
   2. Select Currency: Choose your currency from the dropdown.
   3. Payment amount: Enter a fixed amount, or use a custom attribute to pass a variable amount from the user.
   4. Choosing Flows: Set which flow to redirect to on payment success and on failure.

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

Once the gateway is connected under Third Party Applications, the Payments component works like any other flow component.

***

#### Section B: Using the "WhatsApp Payments" Component

This is the native, in-chat payment option. Business verification with Meta must be completed first.

1. Navigate to the flow you want to integrate, then click the "WhatsApp Payments" component.

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

2. Configure the component:
   1. Message: Edit the message shown to the user.
   2. Image: Optionally upload an image to display with the payment request.
   3. Footer: Add footer text to appear alongside the message.
   4. Select Payment Configuration: Choose the payment configuration you set up in Section C.
3. Once configured, complete the payment method setup in WhatsApp Business Manager (business.facebook.com) — covered in Section C below.

***

#### Section C: Setting Up Payment Configuration on WhatsApp Manager

1. Go to business.facebook.com and click "Search" in the left-hand sidebar.

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

2. Search for and open "WhatsApp Manager".

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

3. Go to the "Payment Configuration" section near the bottom of the screen, making sure you're on the correct business portfolio (switchable via the dropdown in the top-left).

<figure><img src="/files/06shLNMIvx4uGabyBITo" alt=""><figcaption></figcaption></figure>

5. Select the country to configure payments for (currently India and Singapore), click "Add Configuration", and fill in the payment name and payment method.

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

Once saved, return to BotPenguin and select this configuration in the WhatsApp Payments component. Your WhatsApp payment setup is now complete.

***

### Best Practices

> 💡 Use a clear, specific payment message so users know exactly what they're paying for.

> ⚠️ Always connect the payment gateway under Third Party Integrations before publishing the flow — a missing connection is the most common cause of failed payments.

> 🚀 Test both the success and failure flow paths before going live.

> 🎯 For variable amounts, use a custom attribute rather than hardcoding a fixed value.

***

### Troubleshooting

<details>

<summary>Issue: Payments are throwing unexpected errors.</summary>

Solution: Confirm the selected payment method (RazorPay, Peach Payments, Telr Pay, Tilo Pay, Worldpay, Payfast, etc.) is also connected under Third Party Integrations — the component won't work with an unconfigured gateway.

</details>

<details>

<summary>Issue: The "WhatsApp Payments" (native) component isn't available or fails on setup.</summary>

Solution: Confirm business verification with Meta has been completed — this is a prerequisite for the native in-chat option, not the redirect-based Payments component.

</details>

<details>

<summary>Issue: Payment Configuration isn't showing up in BotPenguin after setup in WhatsApp Manager.</summary>

Solution: Double-check you configured it under the correct business portfolio in WhatsApp Manager, and that the country selected (currently India or Singapore only) matches your setup.

</details>

***

### FAQs

<details>

<summary>What's a typical use case for the Payments component in WhatsApp?</summary>

Triggering a payment request after a user confirms an order, booking, or service inside a chat flow — for example, after selecting a product or agreeing to an invoice amount.

</details>

<details>

<summary>How do I add a custom attribute to the Payments tab?</summary>

When setting the payment amount, instead of entering a fixed number, create a custom attribute that captures the amount from the user during the conversation, then reference that attribute in the amount field.

</details>

<details>

<summary>What's the difference between the "Payments" component and the "WhatsApp Payments" component?</summary>

The "Payments" component redirects to a third-party gateway (RazorPay, Peach Payments, Telr Pay, Tilo Pay, Worldpay, Payfast, etc.). The "WhatsApp Payments" component is native and in-chat, but requires completed Meta business verification and a Payment Configuration set up in WhatsApp Manager first.

</details>

<details>

<summary>Where can I track payments that have happened?</summary>

Payment records are tied to the gateway you connected under Third Party Integrations — check your gateway account (e.g., RazorPay, Worldpay, Payfast dashboard) for transaction history alongside BotPenguin's chat logs.

</details>

<details>

<summary>Which countries are supported for native WhatsApp Payments configuration?</summary>

Currently India and Singapore, set up via the Payment Configuration section in WhatsApp Manager.

</details>

***

### Related Articles

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

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

{% content-ref url="/pages/2Zpm8t0xDV1XalyNwckp" %}
[Manage Chatflow](/bots/whatsapp-bot/manage-chatflow.md)
{% endcontent-ref %}

***

### Support

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.