Skip to Content
API ReferenceWhatsAppCommerce

Commerce

Two-part commerce surface:

  1. Settings — per-phone-number flags that turn the cart on/off and show/hide the catalog icon.
  2. Product messages — send interactive messages of type product / product_list that render an in-app product card.

The catalog itself lives in Meta Commerce Manager — link it to your WABA in Business Manager first; we only toggle visibility here.

1. Read commerce settings

GET /api/v25.0/{PHONE_NUMBER_ID}/whatsapp_commerce_settings
Authorization: Bearer pk_live_<your-key>

Response — 200

{
  "data": [
    {
      "is_cart_enabled":    true,
      "is_catalog_visible": true
    }
  ]
}

2. Enable / Disable Cart

POST /api/v25.0/{PHONE_NUMBER_ID}/whatsapp_commerce_settings?is_cart_enabled=true
Authorization: Bearer pk_live_<your-key>

Toggle flag goes in the query string, no body required.

ParamNotes
is_cart_enabledtrue to enable cart, false to disable

Response — 200

{ "success": true }

3. Enable / Disable Catalog

POST /api/v25.0/{PHONE_NUMBER_ID}/whatsapp_commerce_settings?is_catalog_visible=true
Authorization: Bearer pk_live_<your-key>
ParamNotes
is_catalog_visibletrue to show the catalog icon in the chat header, false to hide it

4. Send a single product message

Use Send Messages with type: "interactive" and interactive.type: "product":

{
  "messaging_product": "whatsapp",
  "to":                "+919999999999",
  "type":              "interactive",
  "interactive": {
    "type": "product",
    "body":   { "text": "Featured product" },
    "footer": { "text": "Free shipping on orders over ₹999" },
    "action": {
      "catalog_id":          "1234567890123456",
      "product_retailer_id": "SKU-ABC-123"
    }
  }
}

product_retailer_id is the SKU you set in Commerce Manager — not the Meta-internal product ID.

5. Send a product list

{
  "messaging_product": "whatsapp",
  "to":                "+919999999999",
  "type":              "interactive",
  "interactive": {
    "type": "product_list",
    "header": { "type": "text", "text": "Diwali picks" },
    "body":   { "text": "Hand-picked sweets for the week" },
    "footer": { "text": "Tap any item to view" },
    "action": {
      "catalog_id": "1234567890123456",
      "sections": [
        {
          "title": "Sweets",
          "product_items": [
            { "product_retailer_id": "SKU-001" },
            { "product_retailer_id": "SKU-002" }
          ]
        },
        {
          "title": "Savouries",
          "product_items": [
            { "product_retailer_id": "SKU-101" },
            { "product_retailer_id": "SKU-102" }
          ]
        }
      ]
    }
  }
}

Max 10 sections, 30 products per list.

6. Send a catalog message

{
  "messaging_product": "whatsapp",
  "to":                "+919999999999",
  "type":              "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": { "text": "Browse our full catalog" },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "SKU-001"
      }
    }
  }
}

7. Receive orders

When a customer submits a cart, Meta delivers a webhook with type: "order" to your configured webhook URL:

{
  "type": "order",
  "order": {
    "catalog_id":      "1234567890123456",
    "text":            "Add a note: please gift wrap",
    "product_items": [
      {
        "product_retailer_id": "SKU-001",
        "quantity":            2,
        "item_price":          499.0,
        "currency":            "INR"
      }
    ]
  }
}

Acknowledge and process server-side — Meta does not handle payment or fulfilment.

Errors

Same matrix as Phone Number Details. Product-message-specific errors:

BodyWhen
(#131009) Parameter value is not valid — product_retailer_id not in catalogSKU isn’t in the linked catalog, or catalog isn’t approved
(#100) Catalog is not visibleis_catalog_visible is false; flip it on first

cURL — toggle + send

# Enable cart
curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/whatsapp_commerce_settings?is_cart_enabled=true" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY"
 
# Show catalog icon
curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/whatsapp_commerce_settings?is_catalog_visible=true" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY"
 
# Send product
curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to":                "+919999999999",
    "type":              "interactive",
    "interactive": {
      "type": "product",
      "body": { "text": "Featured product" },
      "action": {
        "catalog_id":          "1234567890123456",
        "product_retailer_id": "SKU-ABC-123"
      }
    }
  }'
FlowsVoice Calling