Skip to main content

​
Set Commerce Settings

Updated: Nov 14, 2025 You can enable or disable the shopping cart and the product catalog on a per-business phone number basis. By default, the shopping cart is enabled and the storefront icon is hidden for all business phone numbers associated with a WhatsApp Business Account.

​
Requirements

A system token or user token. The whatsapp_business_management permission. If using a system token, the system user must be granted full controll over the WhatsApp Business Account. Businesses based in India must comply with all online selling laws.

​
Get Business Phone Numbers

Use the WhatsApp Business Account > Phone Numbers endpoint to get a list of all business phone numbers associated with a WhatsApp Business Account.

​
Enable/Disable Cart

Use the Business Phone Number > WhatsApp Commerce Settings endpoint to enable or disable the shopping cart for a specific business phone number. When enabled, cart-related buttons appear in the chat, catalog, and product details views: Three WhatsApp messenger screenshots with callout of various cart UI components displayed When the cart is disabled, customers can see products and their details, but all cart related buttons will not appear in any view.

​
Request Syntax

POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_cart_enabled=<IS_CART_ENABLED>

​
Parameters

PlaceholderSample ValueDescription
<BUSINESS_PHONE_NUMBER_ID>106850078877666Business phone number ID.
<IS_CART_ENABLED>trueBoolean. Set to true to enable cart or false to disable it. Default value is true.

​
Sample Request

curl -X POST 'https://graph.facebook.com/v24.0/106850078877666/whatsapp_commerce_settings?is_cart_enabled=true' \
-H 'Authorization: Bearer EAAJB...'

​
Sample Response

\{
  "success": true
}

​
Enable/Disable Catalog

Use the Business Phone Number > WhatsApp Commerce Settings endpoint to enable or disable the product catalog for a specific business phone number. When enabled, the catalog storefront icon and catalog-related buttons appear in chat views and business profile views: Two WhatsApp messenger screenshots with callout of various catalog UI components displayed When the catalog is disabled, the storefront icon and catalog-related buttons will not appear in any views and the catalog preview with thumbnails will not appear in the business profile view. If you disable the catalog, wa.me links to your catalog, as well as the View catalog button that appears when you send your catalog link in a message will display an Invalid catalog link warning when tapped.

​
Request Syntax

POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_catalog_visible=<IS_CATALOG_VISIBLE>

​
Parameters

PlaceholderSample ValueDescription
<BUSINESS_PHONE_NUMBER_ID>106850078877666Business phone number ID.
<IS_CATALOG_VISIBLE>trueBoolean. Set to true to show catalog storefront icon or false to hide it. Default value is false.

​
Sample Request

curl -X POST 'https://graph.facebook.com/v24.0/106850078877666/whatsapp_commerce_settings?is_catalog_visible=true' \
-H 'Authorization: Bearer EAAJB...'

​
Sample Response

\{
  "success": true
}

​
Get Commerce Settings

Use the Business Phone Number > WhatsApp Commerce Settings endpoint to get an individual business phone number’s commerce settings.

​
Request Syntax

GET /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings

​
Parameters

PlaceholderSample ValueDescription
<BUSINESS_PHONE_NUMBER_ID>106850078877666Business phone number ID.

​
Sample Request

curl -X GET 'https://graph.facebook.com/v24.0/106850078877666/whatsapp_commerce_settings' \
-H 'Authorization: Bearer EAAJB...'

​
Sample Response

\{
  "data": [\
    {\
      "is_cart_enabled": true,\
      "is_catalog_visible": true,\
      "id": "727705352028726"\
    }\
  ]
}
Did you find this page helpful? Thumbs up icon Thumbs down icon ON THIS PAGE Requirements Get Business Phone Numbers Enable/Disable Cart Request Syntax Parameters Sample Request Sample Response Enable/Disable Catalog Request Syntax Parameters Sample Request Sample Response Get Commerce Settings Request Syntax Parameters Sample Request Sample Response