ZedCheckout

Intégrations e-commerce

Connectez Shopify à ZedCheckout via OAuth pour alimenter le scoring churn, et configurez les webhooks sortants.

Prérequis

  1. Clé API tenant : X-API-Key pour l'ingestion manuelle (POST /events). Les webhooks Shopify OAuth n'utilisent pas cette clé.
  2. Secret webhook sortant : POST /settings/webhook/secret (JWT) — pour les notifications ZedCheckout → votre SI, pas pour Shopify entrant.
  3. Base : https://zedcheckout.com/api/v1

Shopify OAuth (marchands)

La connexion Shopify se fait depuis le dashboard ZedCheckout (OAuth). Les marchands n'accèdent pas au Partner Dashboard Shopify.

Qui fait quoi

  • Éditeur ZedCheckout (une fois) : scopes dans la version d'app, formulaire Protected customer data et protection des données dans partners.shopify.com → Apps → ZedCheckout → Demandes d'accès à l'API.
  • Chaque marchand : ouvrir la page Intégrations, cliquer Connecter Shopify (ou Déconnecter puis Reconnecter si l'import initial échoue avec un message de scope).

URLs dashboard

Détail éditeur (scopes, webhooks, dépannage) : docs/integrations/shopify.md dans le monorepo.

Webhooks Shopify entrants

Après OAuth, Shopify envoie des POST signés ; ZedCheckout mappe vers des event_type normalisés (order_created, customer_created, etc.).

Shopify

Enregistrement automatique après connexion — remplacez {tenant_id} par l'identifiant tenant ZedCheckout.

Signature : X-Shopify-Hmac-SHA256 (secret d'app Shopify)

  • POSThttps://zedcheckout.com/api/v1/webhooks/shopify/t/{tenant_id}/orders
  • POSThttps://zedcheckout.com/api/v1/webhooks/shopify/t/{tenant_id}/customers

Détail des URLs et topics : Webhooks Shopify et docs/integrations/shopify.md.

Webhooks sortants

ZedCheckout notifie votre endpoint (HMAC X-ZedCheckout-Signature). Événement implémenté : retention.campaign.sent (campagnes canal webhook).

Slack (prévu)

Spécification : docs/integrations/slack-notifications.md dans le monorepo.