Skip to main content
LTV.ai integrates with BigCommerce as a single-click app, providing customer data sync and ecommerce integration for email marketing campaigns.

​
Installation Flow

1

Merchant installs app

Merchant clicks install from BigCommerce App Marketplace. This triggers GET /big-commerce/auth.
2

OAuth flow

BigCommerce redirects to the authorization page. Upon approval, the OAuth callback exchanges codes for access tokens.
3

App load callback

When the merchant opens the app, BigCommerce calls GET /big-commerce/load with a signed payload. The backend validates the payload and redirects to the retailer dashboard.
4

Webhook registration

Webhooks are registered for order status changes and customer events.

​
Order Processing

BigCommerce order webhooks are processed via POST /big-commerce/webhook/order-status and feed customer purchase data into the segmentation engine for targeted email campaigns.

​
Customer SSO

BigCommerce customers are authenticated via the platform’s customer login API: 
BigCommerce Store → Customer Login Token → POST /big-commerce/customer/sso
    → Validate token → Issue LTV.ai JWT

​
Billing

BigCommerce retailers use Braintree for subscription billing, managed through the RetailerBillingConfiguration entity.

​
App Lifecycle

EventEndpointDescription
InstallGET /big-commerce/authOAuth installation
LoadGET /big-commerce/loadApp loaded in admin
UninstallGET /big-commerce/uninstallApp removal cleanup

​
Configuration

VariableDescription
BIGCOMMERCE_CLIENT_IDBigCommerce app client ID
BIGCOMMERCE_CLIENT_SECRETBigCommerce app client secret