# Shopify commerce actions

> Use authorized catalog, buyer-cart and customer-service actions with explicit privacy boundaries.

Canonical: https://valuechat.app/docs/shopify
Category: Integrations & API

## Before you start

Use a test channel or sample conversation first. Confirm the result before applying the setup to production traffic.

## How it works

1. Connect. Authorize the intended shop using its original myshopify.com domain. Shopify app configuration, distribution approval, protected customer-data access and granted scopes determine which capabilities actually work.

2. Catalog. Search/get products, list variants, inspect inventory and shop information. Use actual variant IDs, current prices and returned stock data; do not invent products or availability.

3. Buyer journey. Create/read a cart, add/update/remove lines, apply supported discounts and buyer details, and return the Shopify checkout URL. A cart or draft invoice is not a paid or completed order.

4. Buyer identity. Personal order/customer access uses the buyer-verification flow where supported. The buyer approves the email link; an email address, order number or confident prompt alone is not verified ownership. Never expose a verification link or customer records to another conversation.

5. Service and invoices. Supported customer/order lookup, tags and draft-order/invoice actions remain subject to their contract and permissions. Checkout/invoice links are private to that buyer conversation.

6. Financial controls. Cancellation and refund actions require separate administrator enablement and confirmation. Cancellation does not automatically refund; a refund transaction or pending cancellation job is not proof of settled money.

7. Limits. Public merchant rollout still depends on distribution/privacy compliance and approval. Unsupported fulfillment or payment-capture operations must not be advertised. An uncertain mutation must be checked in Shopify before another write.

## What to verify

- The expected channel, conversation, contact or execution is visible.
- The assignment matches the configured routing.
- No customer-facing message claims an action that failed.
- Activity or execution history explains the result.

## Need help?

support@valuechat.app. Never send API keys or passwords.