> For the complete documentation index, see [llms.txt](https://docs.ownchat.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ownchat.app/bot/connections/advanced-payment.md).

# Advanced Payment

The **Advanced Payment** action allows chatbot builders to create highly customizable payment workflows inside Ownchat using WhatsApp Payment integrations.

Unlike standard payment actions, Advanced Payment supports:

* Dynamic reference IDs
* Expiration controls
* Tax configuration
* Catalog visibility
* Product-level customization
* Media uploads
* Static and dynamic product data

This connection action helps businesses create flexible payment experiences for both physical and digital products directly inside chatbot conversations.

The walkthrough demonstrates configuring WhatsApp Payment connections, dynamic variables, catalog settings, payment expiration, tax information, product catalogs, and payment response storage.

{% embed url="<https://app.supademo.com/demo/cmn5u36dh3zlpz3qm1pnuk3ac?utm_source=link>" %}

### When to Use Advanced Payment &#x20;

Use the **Advanced Payment** action when your chatbot requires detailed payment configuration and customizable product-based payment workflows.

### Common Use Cases &#x20;

* E-commerce checkout
* Subscription invoices
* Product catalog payments
* Digital product sales
* Restaurant ordering systems
* Multi-product billing workflows

**Example Interaction** &#x20;

Bot: Your payment request is ready.\
\
Please complete the payment to activate your plan.

The chatbot dynamically generates an advanced payment request with configurable product and billing details.

### Prerequisites &#x20;

Before configuring the Advanced Payment action:

* WhatsApp Payment integration must already be connected.
* API responses or order variables should already exist if dynamic references are required.

The walkthrough specifically notes:

The ID is stored in the store response variable in the API action.

### How to Add Advanced Payment &#x20;

Follow these steps to add the **Advanced Payment** action to your bot workflow.

1. Open **Bot Builder**
2. Click the **Add Node** button
3. Open the **Connections** tab
4. Select **Payments**
5. Click Advanced Payment
6. Configure the payment settings
7. Configure catalog and product details
8. Configure response variables
9. Click **Create**
10. Click **Publish** to deploy the workflow

The walkthrough demonstrates selecting Advanced Payment from the Payments section.

### Accessing the Connections Section &#x20;

To access the Advanced Payment action:

1. Click **Add Node**
2. Open the action panel
3. Click the **Connections** tab

{% embed url="<https://app.supademo.com/demo/cmpc8ulye0cs2z70j1kagz4r6?utm_source=link>" %}

The walkthrough specifically states:

To create an advance payment in WhatsApp Payment, you need to connect the app first and proceed.

### Selecting Advanced Payment &#x20;

Inside the Payments section:

1. Locate **Advanced Payment**<br>

{% embed url="<https://app.supademo.com/demo/cmpc8wen00d2txa0jtglfvfih?utm_source=link>" %}

2. Click the action to open the configuration panel

The walkthrough specifically notes:

Select Advanced Payment to connect it with the API call.

### Advanced Payment Configuration &#x20;

When configuring the **Advanced Payment** action, several fields must be completed.

#### Action Name &#x20;

The **Action Name** identifies the payment workflow inside the bot builder.

This name is visible only within the workflow editor.<br>

{% embed url="<https://app.supademo.com/demo/cmpc8xehw0d2vxa0jb1o2mly2?utm_source=link>" %}

**Example** &#x20;

Advanced Subscription Payment\
Premium Checkout\
WhatsApp Product Payment

The walkthrough demonstrates renaming the default value to:

Advance payment

before saving the configuration.

#### Body Text &#x20;

The **Body Text** field contains the payment request message displayed to the customer.<br>

{% embed url="<https://app.supademo.com/demo/cmpc8y8b10001wv0id8ifji6z?utm_source=link>" %}

**Example** &#x20;

Awesome! We've received your details ✅\
\
To activate your plan, please click the "Pay Now" button below.

The walkthrough demonstrates configuring a payment message with activation instructions.

### Connection ID &#x20;

The **Connection ID** field allows you to select the configured WhatsApp Payment integration.<br>

{% embed url="<https://app.supademo.com/demo/cmpc908qa02zjv70jg55bib6q?utm_source=link>" %}

To configure:

1. Open the dropdown
2. Select the connected payment account

The walkthrough specifically selects:

**OwnchatWhatsappPay** live final

from the available connections list.<br>

{% embed url="<https://app.supademo.com/demo/cmpc91kro0d2xxa0jl7qy3cj1?utm_source=link>" %}

### Reference ID &#x20;

The **Reference ID** field stores the order or transaction identifier associated with the payment.

To configure:

1. Click **Add Variable**

{% embed url="<https://app.supademo.com/demo/cmpc92fcn000awv0i9ynefbbj?utm_source=link>" %}

2. Select the API response variable

{% embed url="<https://app.supademo.com/demo/cmpc93hf3000owv0if0uaa8dd?utm_source=link>" %}

3. Append the required response path

The walkthrough demonstrates selecting:

id

from the stored API response variables.

The walkthrough then appends:

.data

to access the correct API response value.

Final example:

{{variables.id.data}}

{% embed url="<https://app.supademo.com/demo/cmpc94sz10ct8z70jvmwymqhr?utm_source=link>" %}

### Goods Type &#x20;

The Goods Type field specifies the type of product or service associated with the payment.

Available options shown include:

* Digital Goods
* Physical Goods<br>

{% embed url="<https://app.supademo.com/demo/cmpc97aqh000uwv0i9xg1uffm?utm_source=link>" %}

### Digital Goods  <br>

{% embed url="<https://app.supademo.com/demo/cmpc98oyf0d3exa0juv22silz?utm_source=link>" %}

Used for:

* Subscription plans
* Software licenses
* Online services
* Digital downloads

### Physical Goods &#x20;

Used for:

* Food orders
* Product deliveries
* Retail purchases
* E-commerce items

The walkthrough specifically notes:

If a customer orders food via Petpooja, choose Physical Goods; if you send a subscription invoice, choose Digital Goods.

### Expiration Data Format &#x20;

The **Expiration Data Format** field defines the time unit for payment expiration.

Available options shown include:

* Minutes
* Hours

The walkthrough specifically selects:

Hours

as the expiration format.<br>

{% embed url="<https://app.supademo.com/demo/cmpc99yo70ctkz70jlnmknlpg?utm_source=link>" %}

### Expiration Data Value &#x20;

The **Expiration Data Value** field defines how long the payment request remains valid.<br>

{% embed url="<https://app.supademo.com/demo/cmpc9be560010wv0iviixboh0?utm_source=link>" %}

**Example** &#x20;

24

The walkthrough demonstrates setting the payment expiration to 24 hours.

### Expiration Description &#x20;

The **Expiration Description** field explains the expiration condition shown to the customer.<br>

{% embed url="<https://app.supademo.com/demo/cmpc9c91w0012wv0ijaqsi9f3?utm_source=link>" %}

**Example** &#x20;

Payment link expired

The walkthrough demonstrates entering a payment expiration description.

### Tax Value &#x20;

The **Tax Value** field specifies the tax amount applied to the transaction.<br>

{% embed url="<https://app.supademo.com/demo/cmpc9d6s60d3lxa0j4okswtfm?utm_source=link>" %}

**Example** &#x20;

1799.82

The walkthrough demonstrates entering a tax amount manually.

### Tax Description &#x20;

The **Tax Description** field explains the tax details applied to the payment.<br>

{% embed url="<https://app.supademo.com/demo/cmpc9fgvq0016wv0i0hxvkjc9?utm_source=link>" %}

Example &#x20;

18% GST

The walkthrough demonstrates configuring GST tax descriptions.

### Is Catalog Available &#x20;

The **Is Catalog Available** toggle controls whether customers can view products inside the payment workflow.

#### When Enabled &#x20;

{% embed url="<https://app.supademo.com/demo/cmpcab7np03hrv70j0kvou36v?utm_source=link>" %}

* Products become visible to customers
* Customers can browse available items

The walkthrough specifically notes:

If you enable the catalog, the items are shown in this action.<br>

{% embed url="<https://app.supademo.com/demo/cmpcacl0b000az40jynxzoiep?utm_source=link>" %}

#### When Disabled  <br>

{% embed url="<https://app.supademo.com/demo/cmpcafdrc000cz40jjlqjdyg6?utm_source=link>" %}

* Products remain hidden
* Customers cannot browse the catalog

The walkthrough specifically notes:

Catalog visibility is turned off, so customers cannot see or browse products.

### Catalog Type &#x20;

The **Catalog Type** field defines how product data should be managed.

Available options include:

* Static
* Dynamic<br>

{% embed url="<https://app.supademo.com/demo/cmpcaglsk000ez40jvj6g56ut?utm_source=link>" %}

### Static Catalog &#x20;

Uses manually entered product details.

### Dynamic Catalog &#x20;

Automatically retrieves product information from real-time data sources.

The walkthrough specifically notes:

Static means fixed values, while Dynamic updates automatically based on real-time data.

#### Product Name &#x20;

The **Product Name** field specifies the name of the product shown in the payment request.<br>

{% embed url="<https://app.supademo.com/demo/cmpcahus90djbxa0juzisbv11?utm_source=link>" %}

**Example** &#x20;

Premium Subscription

The walkthrough demonstrates manually entering product names.

### Product Media Upload &#x20;

The **Upload Media** option allows product images or media files to be attached to the payment request.

To configure:

1. Click **Upload Media**<br>

{% embed url="<https://app.supademo.com/demo/cmpcawwug0cwoz70jubayukcz?utm_source=link>" %}

2. Select the media file
3. Click **Send Selected Files**<br>

{% embed url="<https://app.supademo.com/demo/cmpcaxraa0cwrz70js4ry4c69?utm_source=link>" %}

The walkthrough demonstrates uploading product media files successfully.

### Product Price &#x20;

The **Price** field specifies the product cost.

{% embed url="<https://app.supademo.com/demo/cmpcayomu0cwtz70jb16cai6d?utm_source=link>" %}

Example &#x20;

999

The walkthrough demonstrates entering product pricing manually.

### Product Quantity &#x20;

The **Quantity** field specifies the number of product units included in the payment.

**Example** &#x20;

1

This field supports multi-product payment configurations.

#### Notes Section &#x20;

The **Notes** section allows additional metadata to be attached to the payment request.

This is commonly used for:

* Order IDs
* Customer references
* Internal tracking

#### Note Key &#x20;

The **Note Key** field defines the metadata label.<br>

{% embed url="<https://app.supademo.com/demo/cmpcb1jtq0cwzz70jpzfac7hw?utm_source=link>" %}

Example &#x20;

order\_id

The walkthrough demonstrates adding multiple payment notes.

#### Note Value &#x20;

The **Note Value** field contains the associated value or variable.

The walkthrough demonstrates:

1. Clicking **Add Variable**<br>

{% embed url="<https://app.supademo.com/demo/cmpcb34om007ewv0ieuq4y1j3?utm_source=link>" %}

2. Selecting the stored response variable
3. Appending:

.data\
to retrieve the required value.<br>

{% embed url="<https://app.supademo.com/demo/cmpcb48ea0cx1z70j3oiw0udw?utm_source=link>" %}

### Store Response Variable &#x20;

The Store Response Variable field defines where the payment response should be stored.

The walkthrough demonstrates creating:

payment\_advance

as the response storage variable.<br>

{% embed url="<https://app.supademo.com/demo/cmpcb6juz0dtvxa0jus5ngopj?utm_source=link>" %}

### Creating the Advanced Payment Action &#x20;

After configuring all payment settings:

1. Review the workflow configuration
2. Click the **Create** button<br>

{% embed url="<https://app.supademo.com/demo/cmpcb8czp007jwv0i5az4vmot?utm_source=link>" %}

The Advanced Payment node will now appear in the workflow canvas.

### Workflow Behavior &#x20;

Once triggered, the **Advanced Payment** action:

* Connects with WhatsApp Payment integrations
* Supports advanced product configuration
* Handles catalog-based product payments
* Supports expiration and tax controls
* Stores payment responses dynamically

The walkthrough demonstrates configuring a complete advanced WhatsApp payment workflow using API-connected references and catalog products.

### Example Workflow &#x20;

#### Example Chatbot Workflow &#x20;

Create Order via API\
&#x20;       ↓\
Advanced Payment\
&#x20;       ↓\
Generate Payment Request\
&#x20;       ↓\
Store Payment Response\
&#x20;       ↓\
Send Payment Confirmation

### Example Interaction &#x20;

Bot: Your payment request is ready.\
\
Plan: Premium Subscription\
Amount: ₹9,999\
Validity: 24 Hours

The chatbot dynamically generates a complete payment request with product and tax details.

### Publishing the Bot Changes &#x20;

After configuring the Advanced Payment workflow:

1. Review all payment settings
2. Click the **Publish** button
3. Deploy the updated workflow to production<br>

{% embed url="<https://app.supademo.com/demo/cmpcb9kad007twv0i8agxh7gx?utm_source=link>" %}

The walkthrough concludes by publishing the configured advanced payment workflow successfully.

### Best Practices &#x20;

Follow these recommendations when using **Advanced Payment.**

**Use dynamic references for orders** &#x20;

Link payment requests with API-generated order IDs.

**Configure catalog visibility carefully** &#x20;

Enable catalogs only when customers need product browsing.

**Use expiration controls** &#x20;

Prevent outdated payment requests from remaining active.

**Upload optimized product media** &#x20;

Use clear and properly sized product images.

**Test complete payment flows before publishing** &#x20;

Validate product, payment, tax, and expiration configurations.

### Summary &#x20;

The **Advanced Payment** action allows chatbot builders to create **fully customizable WhatsApp payment workflows inside Ownchat.**

With **Advanced Payment**, you can:

* Configure advanced payment workflows
* Handle physical and digital goods
* Use catalog-based product payments
* Configure taxes and expiration rules
* Upload product media and pricing details
* Store payment responses dynamically

This connection action helps businesses create **powerful commerce automation and advanced WhatsApp payment experiences within Ownchat.**