Endpoints for the Shopify app integration including OAuth installation flow, webhook processing, and customer data sync.
OAuth & Installation
Start OAuth
GET /shopify/auth
Initiates the Shopify OAuth flow for app installation. Redirects the merchant to Shopify’s authorization page.
OAuth Callback
GET /shopify/callback
Handles the OAuth callback from Shopify after the merchant approves the app installation. Exchanges the authorization code for access tokens.
Admin SSO
GET /shopify/admin-sso/{id}
Redirects an admin user to the merchant’s Shopify admin panel via SSO.
Webhooks
POST /shopify/webhooks
Receives and processes Shopify webhooks. Verified using HMAC signature validation.
Supported Webhook Topics
| Topic | Description |
|---|
orders/create | New order placed |
orders/updated | Order status changed |
orders/cancelled | Order cancelled |
customers/create | New customer registered |
customers/update | Customer profile updated |
app/uninstalled | App uninstalled by merchant |
products/update | Product catalog changes |
refunds/create | Refund issued |
Customer Endpoints
Customer SSO
POST /shopify/customer/sso
Authenticates a customer via Shopify Multipass and issues LTV.ai tokens.
Subscriptions
Get Subscriptions
GET /shopify/subscriptions
Returns the retailer’s current Shopify billing subscriptions. 
