> For the complete documentation index, see [llms.txt](https://limechatai.gitbook.io/limechat-product-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://limechatai.gitbook.io/limechat-product-guide/whatsapp-marketing/flows/action-nodes/whatsapp-purchase-flow-start.md).

# Whatsapp Purchase Flow Start

#### Node Name

Whatsapp Purchase Flow: Start

***

#### What it does

Initiates a WhatsApp-based purchase journey for a user within the chat. It triggers the checkout/purchase flow using configured catalog, product details, and payment setup—helping convert high-intent users into completed orders.

***

#### When to Use

* When a user shows strong purchase intent during conversation<br>
* To directly push users into a WhatsApp-native checkout flow<br>
* In product recommendation flows where user selects an item<br>
* In campaigns offering discounts or limited-time offers<br>
* As a conversion step after product discovery or FAQs<br>

***

#### UI Inputs

* **Variants**
  * Type: List of text values (array)<br>
  * Required: No<br>
  * Description: Specific product variants (e.g., size, color, SKU) to include in the purchase flow<br>
  * Special Behavior: Multiple values can be added<br>
* **Catalog ID**
  * Type: Text<br>
  * Required: Yes<br>
  * Description: Identifier of the product catalog from which items will be fetched<br>
* **Goods Type**
  * Type: Dropdown (enum)<br>
  * Required: Yes<br>
  * Description: Defines the type of product being sold<br>
  * Options:
    * Physical Goods<br>
    * Digital Goods<br>
* **Message Body**
  * Type: Text<br>
  * Required: Yes<br>
  * Description: Message shown to the user along with the purchase flow (e.g., product pitch, CTA)<br>
* **Discount Percent**
  * Type: Number<br>
  * Required: Yes<br>
  * Description: Discount to be applied on the purchase (in percentage terms)<br>
* **Payment Configuration Name**
  * Type: Text<br>
  * Required: Yes<br>
  * Description: Name of the payment setup/configuration to be used for this transaction<br>

***

#### Outputs

* **successful**
  * Type: Boolean<br>
  * Meaning:
    * true → Purchase flow was successfully initiated<br>
    * false → Flow initiation failed<br>

***

#### Requirements

* **Supported Events:**
  * All (*all*)<br>
* **Required Integrations:**
  * None explicitly required (but depends on catalog + payment setup being configured in the system)<br>

***

#### Notes

* This node does not complete the purchase—it only initiates the flow inside WhatsApp<br>
* Ensure catalog, variants, and payment configuration are correctly set up beforehand<br>
* Discount is applied at the flow level—validate compatibility with backend pricing logic<br>
* Typically used as a **conversion-focused step** after user intent is established<br>
* Works best when paired with:
  * Product discovery flows<br>
  * Personalized recommendations<br>
  * Limited-time offers or nudges