WhatsApp Payment Components
This section contains essential information and usage guidelines for managing WhatsApp Payment Components inside BotPenguin.
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
Tip: Route both successful and failed payment outcomes to their own flows so users always get a clear next step.
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
Go to your chosen WhatsApp bot, then click "Edit Your Chatflow".
Select the flow you want to add the Payment component to.
Go to "Decide and Act", then click "Payments" to add the component.
Configure the payment settings:
Select Payment Method: Choose from
All Pay,
RazorPay,
Peach Payments,
Telr Pay,
Tilo Pay,
Worldpay, or
Payfast.
Select Currency: Choose your currency from the dropdown.
Payment amount: Enter a fixed amount, or use a custom attribute to pass a variable amount from the user.
Choosing Flows: Set which flow to redirect to on payment success and on failure.
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.
Navigate to the flow you want to integrate, then click the "WhatsApp Payments" component.
Configure the component:
Message: Edit the message shown to the user.
Image: Optionally upload an image to display with the payment request.
Footer: Add footer text to appear alongside the message.
Select Payment Configuration: Choose the payment configuration you set up in Section C.
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
Go to business.facebook.com and click "Search" in the left-hand sidebar.
Search for and open "WhatsApp Manager".
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).
Select the country to configure payments for (currently India and Singapore), click "Add Configuration", and fill in the payment name and payment method.
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
Issue: Payments are throwing unexpected errors.
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.
Issue: The "WhatsApp Payments" (native) component isn't available or fails on setup.
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.
Issue: Payment Configuration isn't showing up in BotPenguin after setup in WhatsApp Manager.
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.
FAQs
What's a typical use case for the Payments component in WhatsApp?
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.
How do I add a custom attribute to the Payments tab?
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.
What's the difference between the "Payments" component and the "WhatsApp Payments" component?
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.
Where can I track payments that have happened?
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.
Which countries are supported for native WhatsApp Payments configuration?
Currently India and Singapore, set up via the Payment Configuration section in WhatsApp Manager.
Related Articles
3rd Party Apps IntegrationsWhatsapp BotManage ChatflowSupport
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.
Last updated
Was this helpful?