Skip to main content
LTV.ai integrates with Shopify as an embedded app, enabling customer data sync and product catalog integration for email marketing campaigns.

​
Installation Flow

1

Merchant initiates install

The merchant clicks “Install” on the Shopify App Store or a direct install link. This triggers GET /shopify/auth.
2

OAuth authorization

Shopify redirects the merchant to authorize the app. Upon approval, Shopify calls GET /shopify/callback with an authorization code.
3

Token exchange

The backend exchanges the authorization code for permanent access tokens and stores them with the retailer record.
4

Webhook registration

The app registers webhooks for orders, customers, and products.

​
Data Sync

​
Orders

Shopify order webhooks feed customer purchase data into the segmentation engine:
  • orders/create - Track new customer purchases
  • orders/updated - Update order data
  • orders/cancelled - Handle cancellations
  • refunds/create - Track refunds

​
Customers

Customer data is synced for email marketing targeting:
  • customers/create - Create customer profile
  • customers/update - Update customer metadata

​
Products

Product catalog sync (products/update) keeps the internal catalog in sync for email marketing product recommendations and product grid generation.

​
Customer SSO

Shopify customers are authenticated via Multipass: 
Shopify Storefront → Multipass Token → POST /shopify/customer/sso
    → Validate Multipass → Issue LTV.ai JWT

​
Configuration

VariableDescription
SHOPIFY_API_KEYApp API key from Shopify Partners
SHOPIFY_API_SECRET_KEYApp secret for HMAC verification