> ## 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.

# Shopify Integration

> How Galantis connects to Shopify — data synced, authentication, webhook infrastructure, and the abandoned checkout polling mechanism.

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

<CardGroup cols={2}>
  <Card title="Permissions" icon="lock" href="./permissions">
    All Shopify permissions required by Galantis and what each enables.
  </Card>

  <Card title="Webhooks" icon="webhook" href="./webhooks">
    Complete webhook topic reference — every registered webhook and its handler job.
  </Card>

  <Card title="Abandoned Checkout" icon="cart-shopping" href="./abandoned-checkout">
    How the polling mechanism works and its timing implications for automation.
  </Card>
</CardGroup>

## Authentication

The Shopify integration uses OAuth token exchange. When Galantis is installed from the Shopify App Store, the installation initiates the OAuth flow and the resulting access token is stored encrypted per tenant and used for all subsequent Shopify Admin GraphQL API calls.

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 provides complete isolation between merchant workspaces. Each installed store's data — customer records, automation configurations, campaign history, and integration tokens — is never shared across tenants. The Shopify access token for one store cannot access or affect any other store's data in Galantis.

## Related guides

* [Getting Started — Shopify Installation](/whatsapp/getting-started/shopify-installation) — Installation walkthrough and permission grant steps
* [Audience — Contacts](/whatsapp/audience/contacts) — How synced Shopify data populates customer profiles
* [Catalog — Shopify Sync](/whatsapp/catalog/shopify-sync) — How product and collection data syncs from Shopify