Engati - User Guide
...
Building Your Bot
Configuring Integrations

WhatsApp Payment

16min

Introduction

WhatsApp, in partnership with Razorpay and PayU, has launched native UPI payments on its platform, complemented by integrated payment gateway solutions. Through the Payments API, businesses can now streamline transactions by collecting payments directly within WhatsApp, facilitating seamless order completion without requiring users to exit the app. This document serves as a comprehensive guide to effectively utilizing this new feature for business operations. Please note that WhatsApp Payments is currently not available for WhatsApp Growth customers.

Prerequisite

The individual integrating the WhatsApp Payment Gateway on FBM must have both FBM access and Payment Gateway access.

Payment Configuration Setup in FBM

  1. Navigate to the following link: Link to Facebook Business Manager or select “click here” from the Integration setup on Engati.
Document image


2. Select "Payment configurations" followed by "India"

Document image


3. Locate the valid WhatsApp Business Account (WABA)

Document image


4. Click on "New configuration" and proceed by following the provided steps:

Document image

Document image

Document image

Document image


Integration setup on Engati

  1. Navigate to Integrations > Cloud Integrations > WhatsApp Payment
  2. Select "Connect" to establish a connection with your payment gateway
Document image


3. Enter the "Payment Configuration Name" and choose the appropriate "Payment Type" to complete the setup.

Document image


How to set up a WhatsApp Payment node?

Ensure that your bot is deployed on WhatsApp using 360dialog as the provider by following these steps: Navigate to Configure > Deployment > WhatsApp > Provider, and select 360Dialog.

Compliance Check for Businesses in India:

If your business is based out of India and while you're deploying the bot on WhatsApp, it's important to complete a compliance check with the necessary details. This check ensures that your business meets the necessary regulatory requirements for conducting transactions through WhatsApp.

Document image

Document image


To locate the node, go to Bot Builder > Select Path > Add Node > Integrations > WhatsApp Payment.

Document image


If an account has been configured, all the accounts will be displayed for you to select.

Document image

  1. WhatsApp Details:

a. Response Text - Message to be sent along with the payment request

b. Footer - Message to be sent in the footer along with the payment request

c. Expire by - Time duration up to which the payment request will be valid.

d. Expiration Description - Message shown to the customers after the payment request expires.

Document image


2. If WhatsApp commerce is enabled, the “Order Details” section of the "Action" tab is automatically populated from the backend. In case WhatsApp commerce is not enabled, manually input the necessary details.

Order Details:

a) Catalog ID - CatalogID of the Order created for the transaction

b) Items - Items for which payment is being made in the transaction.

Document image


You can define attribute values for dynamic fields to retrieve dynamic values according to your specific use case.

Document image

JS


Add a 'Notes' Section in Node Configuration

This feature allows users to add a "Notes" section under the Order Details in the WhatsApp Payment Node. The section is optional and enables passing additional information to the payment gateway as comments.

Document image




  • Purpose: Allows users to include supplementary information to be sent to the payment gateway.
  • Info Icon: Provides context on the purpose of the field, stating: Any additional details that are to be passed to the payment gateway as comments.

Key Benefits

  • Enhance the flexibility of payment-related communications.
  • Ensure seamless integration with Razorpay for managing custom notes tied to payment orders.

3. Configure response paths with custom messages for both successful and failed payment transactions.

Document image


4. The Discount Details section allows you to specify the percentage discount to be applied to the transaction. Additionally, you have the option to enter a description to provide further clarification on how the discount is calculated for your customers' reference.

Document image


5. The Shipping section allows you to specify the total shipping amount for the transaction, added to the total cost of the items in the cart to determine the final transaction amount. Additionally, you can include a description to provide customers with details about how the shipping cost is calculated.

Document image


6. The Error tab allows you to customize the message that will be displayed when this node encounters an error from the external API call. This message serves as a notification to inform users about the encountered error and can be tailored to provide relevant information or instructions on how to proceed.

Document image


The payment workflow on WhatsApp

When the WhatsApp Payment node is encountered:

Document image

Document image

Document image

Document image

Document image




Payment Logs

All the payments will be captured in the Payment Logs:

Document image


If you face any issues or queries please reach out to us at support@engati.com