Documentation Shopify

Connectez votre boutique Shopify à CartBack en moins de 5 minutes

Activez vos webhooks Shopify, liez votre identifiant marchand CartBack et vérifiez immédiatement que vos sessions remontent dans le tableau de bord.

Détection

Paniers abandonnés

Checkout créé ou mis à jour sans conversion.

Détection

Échecs de paiement

Refus CB, BNPL ou incident au moment du paiement.

Temps estimé

5 minutes

Aucun développement nécessaire pour un premier test.

Ressource SEO

Vous cherchez une vue orientée conversion sur les paniers abandonnés Shopify ? Cette page détaille le problème, la séquence Email + SMS + Appel IA et le taux de récupération moyen observé.

Checklist express

URL de webhook : https://replyup.nanocorp.app/api/webhooks/shopify

Événements : checkouts/create, checkouts/update, orders/payment_failure

En-tête recommandé : X-CartBack-Key = votre merchant_id

Validation finale via le bouton de test de votre tableau de bord

Vue d'ensemble

Ce que CartBack détecte automatiquement

Dès que Shopify envoie les événements clés, CartBack crée une session de récupération, prépare la séquence de relance et attribue ensuite les conversions dans votre tableau de bord.

Paniers abandonnés

Les événements checkouts/create et checkouts/update alimentent la détection des checkouts non finalisés.

Échecs de paiement

L’événement orders/payment_failure permet de distinguer les ventes perdues au moment du paiement pour déclencher une séquence adaptée.

Étape 1

Installer le webhook Shopify

Dans Shopify Admin, ouvrez Settings, puis Notifications, puis Webhooks. Créez ensuite un webhook par événement au format JSON vers l’URL CartBack.

Configuration à utiliser

URL : https://replyup.nanocorp.app/api/webhooks/shopify

Format : JSON

checkouts/createcheckouts/updateorders/payment_failure

Ordre recommandé

Commencez par checkouts/create, ajoutez checkouts/update, puis activez orders/payment_failure.

Placeholder capture

Shopify Admin

Settings → Notifications → Webhooks → Add webhook

Événement : choisissez un des 3 événements ci-contre

Format : JSON

URL : collez l'adresse CartBack

Étape 2

Configurer votre clé API

Chaque boutique possède un identifiant marchand unique. Il permet d’associer explicitement les événements Shopify à votre compte CartBack.

Point 1

Copiez le merchant_id depuis votre tableau de bord CartBack.

Point 2

Ajoutez-le comme en-tête X-CartBack-Key dans votre configuration de webhook Shopify.

Point 3

L’app Shopify CartBack automatisera cette étape prochainement.

Note pratique

Si vous ne pouvez pas injecter un en-tête personnalisé immédiatement, CartBack peut aussi reconnaître votre boutique via le domaine Shopify envoyé dans les en-têtes natifs.

En-tête recommandéJSON

X-CartBack-Key: merchant_boutique_demo

Source de la cléJSON

Tableau de bord CartBack > Merchant ID

Étape 3

Tester l’intégration

Une fois le webhook en place, validez la chaîne complète avec le bouton de test intégré à votre espace marchand. L’objectif est de voir une session de récupération apparaître dans le tableau de bord.

Checklist de validation

1. Ouvrez votre tableau de bord marchand.
2. Cliquez sur le bouton de test webhook intégré à la page.
3. Vérifiez qu’une session remonte ensuite dans le tableau de bord.

Ce que vous devez voir

Une nouvelle session avec le montant du panier, les coordonnées client disponibles et la séquence de relance planifiée.

Raccourcis

Ouvrir l'espace marchand Vérifier le tableau de bord

Étape 4

Personnaliser les relances

Une fois l’intégration validée, vous pouvez ajuster le timing des séquences selon votre cycle d’achat et votre panier moyen.

SMS

30 min

Premier contact rapide après l’abandon.

1 h

Relance plus détaillée avec contenu panier.

Appel

24 h

Escalade pour les paniers à forte valeur.

Templates

Les modèles e-mail et SMS personnalisables arrivent prochainement. En attendant, CartBack applique des modèles optimisés par défaut pour les paniers abandonnés et les paiements échoués.

Exemple JSON

Exemple de webhook Shopify

Cet exemple correspond au format attendu par CartBack pour un checkout Shopify abandonné ou mis à jour.

Webhook ShopifyJSON

{
  "id": 987654321,
  "token": "chk_live_987654321",
  "checkout_token": "chk_live_987654321",
  "created_at": "2026-05-06T10:12:00.000Z",
  "updated_at": "2026-05-06T10:13:00.000Z",
  "currency": "EUR",
  "email": "client@example.com",
  "phone": "+33612345678",
  "total_price": "149.90",
  "subtotal_price": "149.90",
  "abandoned_checkout_url": "https://ma-boutique.myshopify.com/cart/c/chk_live_987654321",
  "payment_gateway_names": ["shopify_payments"],
  "gateway": "shopify_payments",
  "line_items": [
    {
      "title": "Pack CartBack",
      "quantity": 1,
      "price": "149.90",
      "sku": "CB-STARTER"
    }
  ],
  "customer": {
    "first_name": "Jeanne",
    "last_name": "Martin",
    "email": "client@example.com",
    "phone": "+33612345678"
  },
  "billing_address": {
    "first_name": "Jeanne",
    "last_name": "Martin"
  }
}

Assistance

Besoin d’un coup de main ?

Si un événement n’apparaît pas ou si vous voulez valider votre configuration avant mise en production, utilisez les accès ci-dessous.

contact@cartback.io

Pour toute question d’intégration Shopify.

Tableau de bord

Ouvrir CartBack

Retrouvez votre merchant_id, vos tests et vos sessions détectées.

{ "id": 987654321, "token": "chk_live_987654321", "checkout_token": "chk_live_987654321", "created_at": "2026-05-06T10:12:00.000Z", "updated_at": "2026-05-06T10:13:00.000Z", "currency": "EUR", "email": "client@example.com", "phone": "+33612345678", "total_price": "149.90", "subtotal_price": "149.90", "abandoned_checkout_url": "https://ma-boutique.myshopify.com/cart/c/chk_live_987654321", "payment_gateway_names": ["shopify_payments"], "gateway": "shopify_payments", "line_items": [ { "title": "Pack CartBack", "quantity": 1, "price": "149.90", "sku": "CB-STARTER" } ], "customer": { "first_name": "Jeanne", "last_name": "Martin", "email": "client@example.com", "phone": "+33612345678" }, "billing_address": { "first_name": "Jeanne", "last_name": "Martin" } }