Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.digifist.com/llms.txt

Use this file to discover all available pages before exploring further.

The Shopify integration is the data foundation of Galantis. Every customer profile, order record, product, collection, and consent state in Galantis originates from Shopify and is kept current through a combination of real-time webhooks and periodic polling. The integration is established during app installation and maintained automatically — but understanding its structure helps diagnose data issues and configure features correctly.

​
What the Shopify integration provides

  • Customer data — contact profiles, phone numbers, tags, marketing consent, and order history, synced via webhooks and an initial import at installation
  • Order data — order creation, cancellation, and fulfillment events that power automation triggers and segment rules
  • Product and collection data — the full product catalog synced into Galantis for Back-in-Stock, segment rules, and catalog message formats
  • Abandoned checkout data — polled every 10 minutes via the Shopify Admin GraphQL API
  • Marketing consent — marketing_state updates synced via the customers/marketing_consent_updated webhook
  • App billing — subscription and plan management handled through Shopify’s billing system via app_subscriptions/update
  • GDPR compliance — data deletion requests handled via customers/redact and shop/redact webhooks

​
Guides in this section

Permissions

All Shopify permissions required by Galantis and what each enables.

Webhooks

Complete webhook topic reference — every registered webhook and its handler job.

Abandoned Checkout

How the polling mechanism works and its timing implications for automation.

​
Authentication

The Shopify integration uses OAuth token exchange. When Galantis is installed from the Shopify App Store, the installation initiates the OAuth flow via ShopifyTokenExchangeService. The resulting access token is stored encrypted per tenant and used for all subsequent Shopify Admin GraphQL API calls via ShopifySdkService. The access token remains valid as long as the Galantis app is installed on the Shopify store. Uninstalling the app revokes the token and triggers the app/uninstalled webhook, which deactivates the Galantis tenant workspace.

​
Multi-tenant architecture

Galantis uses Stancl/Tenancy to provide complete isolation between merchant workspaces. Each installed store has its own isolated database schema — customer data, automation configurations, campaign history, and integration tokens are never shared across tenants. The Shopify access token for one store cannot access or affect any other store’s data in Galantis.