Guide Shopify pas à pas
De la connexion de votre boutique à une carte de fidélité dans l'Apple Wallet et le Google Wallet de vos clients : paiement en ligne, pages de commande et Shopify POS. Mis à jour le 2026-11-19. Aussi en anglais et en portugais.
Ce que vous aurez à la fin
- Votre boutique Shopify connectée à Pass Studio : les commandes payées arrivent automatiquement dans Pass Studio.
- Une carte de fidélité (tampons, points, points et paliers, ou crédits prépayés) que vos clients gardent dans Apple Wallet ou Google Wallet, et qui se met à jour sur leur téléphone quand ils cumulent.
- La carte proposée sur la page que le client voit juste après le paiement (la page Thank you de Shopify) et sur la page Order status.
- En caisse (Shopify POS) : une tuile Pass Studio qui scanne la carte d'un client, et une ligne Display QR Code après une vente qui montre le QR de la carte au client.
Ce qu'il vous faut : une boutique Shopify, un compte Pass Studio (gratuit, sur www.thepassstudio.com) et, pour l'étape 4, Shopify POS avec n'importe quel abonnement (POS Lite ou POS Pro). Les libellés de l'admin Shopify sont cités en anglais ; si votre admin Shopify est en français, les mêmes éléments sont aux mêmes endroits, traduits par Shopify.
Étape 1. Connecter votre boutique
- Connectez-vous à Pass Studio sur www.thepassstudio.com.
- Cliquez sur votre avatar (en haut à droite), puis Réglages, puis Intégrations dans la barre latérale.
- Cliquez sur la ligne Shopify pour l'ouvrir.
- Saisissez le domaine de votre boutique, par exemple
maboutique.myshopify.com(il figure dans la barre d'adresse de votre admin Shopify). - Cliquez sur Connecter avec Shopify. Shopify s'ouvre et vous demande d'approuver l'application : cliquez sur Install app.
- Vous revenez dans Pass Studio. La ligne Shopify montre votre boutique avec un badge vert Connectée et, sous Ce qui est activé, ✓ Émission automatique des cartes à l'achat (webhook actif).
- Rien à copier : aucun jeton d'API, aucun webhook à créer. La connexion enregistre pour vous le webhook
orders/paidde Shopify. - L'installation depuis le Shopify App Store fonctionne aussi : cliquez sur Install sur la fiche Pass Studio ; sans compte Pass Studio, vous arrivez sur la page d'inscription, et la boutique se connecte dès que le compte existe.
- Une boutique, un compte : une boutique est connectée à un seul compte Pass Studio à la fois. Si elle appartient déjà à un autre compte, les Réglages indiquent son titulaire actuel, et la boutique ne change de compte qu'après un clic sur Reprendre cette boutique.
- Équipes : la boutique appartient au contexte choisi dans le sélecteur d'équipe au moment de la connexion. Connectez-la avec votre équipe sélectionnée pour que tous les membres la voient et que les commandes soient facturées au portefeuille de l'équipe.
- Si vous voyez un panneau Set up auto-issue on purchase à la place de la ligne ✓, l'enregistrement automatique n'a pas abouti : suivez le panneau, ou les étapes manuelles de la page Shopify Setup (en anglais), puis cliquez sur Actualiser.
Étape 2. Créer la carte de fidélité
- Ouvrez Fidélité dans le menu de Pass Studio et cliquez sur + Nouveau programme. (Le même assistant s'ouvre depuis Cartes → + Nouvelle carte → Fidélité / Membre, une fois la carte nommée.)
- Première question : D'abord, précisons le type de pass à créer. Choisissez Créer un programme de fidélité. (Carte de membre crée une carte de membre avec paliers et points facultatifs ; J'ai déjà un programme de fidélité s'adresse à Smile, Yotpo, LoyaltyLion ou à votre propre système, qui gardent le solde.)
- Quel type de programme avez-vous en tête ? Choisissez :
- Carte à tampons : un tampon par visite, une récompense quand la carte est pleine.
- Points : des points par visite ou par montant dépensé, une récompense à un seuil.
- Points et paliers : des points et des niveaux comme Argent et Or.
- Crédits prépayés : le client achète un forfait et l'utilise (lavages, cours, pizzas, boissons).
- Répondez aux autres questions courtes. Pour les points : Comment vos membres gagnent-ils des points ? Par visite ou Par montant dépensé ; puis le bonus de bienvenue et La photo du membre sur la carte ?
- Envoyer la carte automatiquement après un achat ? Choisissez Oui. C'est ce qui fait qu'une commande Shopify payée émet la carte. L'assistant demande ensuite quelles commandes : toutes, ou seulement celles qui contiennent les produits choisis, et s'il faut inviter par e-mail les clients existants de la boutique quand la carte est publiée.
- Parcourez les étapes de détail (règle de cumul, récompense et, pour les crédits prépayés, les forfaits et les produits Shopify qui les vendent) et le récapitulatif, puis créez le programme.
- L'assistant affiche Votre programme est prêt. Dessinez la carte, puis publiez-la. Cliquez sur Aller à la carte, ajoutez votre logo et vos couleurs dans le Studio, puis cliquez sur Publier. Les brouillons sont gratuits. La publication coûte 10 crédits.
- Modifier plus tard les commandes qui émettent la carte : Réglages → Intégrations → Shopify → Configurer ou modifier l'émission automatique, ou sur la carte : Studio → Parcours & distribution → onglet Partager → Envoi automatique à l'achat (interrupteur Envoyer cette carte automatiquement par e-mail à l'achat et champ Rechercher vos produits…). Aucun produit choisi : toutes les commandes payées.
- L'e-mail d'invitation : quand une commande payée correspond à la carte, un client qui n'a pas encore de carte reçoit un e-mail de Pass Studio pour s'y inscrire ; un client qui a déjà une carte active n'en reçoit pas une deuxième. L'adresse utilisée est l'e-mail de la commande, sinon son e-mail de contact, sinon l'e-mail du client rattaché à la commande.
- Une carte par client : un client a une seule carte de fidélité active par boutique. Une commande ne propose jamais une deuxième carte de fidélité à quelqu'un qui en a déjà une.
- La récompense au paiement : une récompense débloquée s'applique d'elle-même à la commande d'un client connu (interrupteur Appliquer la récompense automatiquement quand le client est connu, activé par défaut). Détails dans Automatic loyalty reward (en anglais).
Étape 3. Afficher la carte sur les pages de commande
Cette étape place le bloc Pass Studio wallet buttons sur la page Thank you de Shopify (juste après le paiement) et sur la page Order status (la commande dans le compte client). Shopify laisse la mise en page du paiement au marchand : une application ne peut pas le placer pour vous. Cela prend deux minutes, une seule fois.
- Dans l'admin Shopify, allez dans Settings → Checkout.
- Sous Configurations, cliquez sur Edit sur la configuration de votre boutique. L'éditeur de paiement s'ouvre sur la page Checkout.
- Dans le sélecteur de page en haut de l'éditeur, choisissez Thank you.
- Sous la section Order summary, cliquez sur Add block et choisissez Pass Studio wallet buttons.
- Dans le même sélecteur, choisissez Order status. Sous Main, cliquez sur Add block et choisissez Pass Studio wallet buttons.
- Cliquez sur Save. Les blocs ne sont pas en ligne avant l'enregistrement.
Ce que voit votre client, sous le titre Your purchase comes with a card :
- Un client sans carte voit Add your card to your wallet. Le bouton ouvre le formulaire d'inscription de la carte, avec l'e-mail et le téléphone de la commande déjà remplis et non modifiables ; la carte est rattachée à ce client Shopify.
- Un client qui a la carte voit Add to Apple Wallet et Save to Google Wallet pour cette carte, sur chaque commande : une carte jamais ajoutée, ou retirée du téléphone, peut être ajoutée à nouveau.
- La première commande compte : quand la carte cumule des points sur les commandes, la commande depuis laquelle le client s'inscrit est créditée sur la nouvelle carte, une seule fois. Utiliser l'e-mail et le bouton ne la compte jamais deux fois.
- Les commandes concernées : les commandes avec un produit d'un forfait prépayé ; les commandes qui correspondent à une carte en émission automatique (étape 2) ; les commandes qui ont émis leur propre carte, comme un coupon ou un billet. Toute autre commande montre les boutons de la carte que le client a déjà, et rien à un client sans carte.
- Délai : juste après le paiement, le bloc affiche Preparing your wallet card… jusqu'à 30 secondes, le temps que Shopify termine la commande.
- Dans l'aperçu de l'éditeur, le bloc affiche une ligne d'attente : la commande d'exemple n'est pas une vraie commande. Vérifiez avec une vraie commande de test (étape 5).
- Langue : le titre et le bouton du bloc sont en anglais.
Étape 4. Configurer Shopify POS
Deux réglages, tous deux dans l'admin Shopify (pas sur l'appareil POS), une fois par boutique. Ils fonctionnent avec POS Lite et POS Pro.
4a. Ajouter la tuile Pass Studio (scanner une carte en caisse)
- Dans l'admin Shopify, ouvrez le canal de vente Point of Sale → Customize your POS experience → Open editor.
- Dans la grille, cliquez sur Add tile sur une page et choisissez Pass Studio (cherchez ou faites défiler s'il est plus bas dans la liste).
- Cliquez sur Save. La disposition se synchronise sur tous les appareils POS du point de vente ; si la tuile n'apparaît pas au bout d'une minute, déconnectez-vous de l'app POS puis reconnectez-vous.
4b. Activer le QR après une vente
- Dans le même éditeur POS, ouvrez l'icône Apps → Pass Studio.
- Activez Activate on: Post-purchase.
- Cliquez sur Save. Sans cela, la ligne Display QR Code n'apparaît pas après une vente.
En caisse
- Un client présente sa carte : touchez la tuile Pass Studio, scannez la carte (ou saisissez le code membre), puis touchez Attach & apply discount. Le client est rattaché à la vente et son code de récompense ou de coupon est appliqué ; terminez la vente normalement et les points arrivent sur la carte.
- Aucun client sur la vente : quand le panier contient des articles et aucun client, la tuile est mise en évidence et affiche No customer on this sale · Add the customer. Une vente ne crédite que si un client y est rattaché : scannez la carte, ou rattachez le client avec la recherche client de Shopify.
- Après une vente avec un forfait prépayé : touchez Display QR Code sur l'écran de fin de vente. L'écran montre le nom de la carte, les crédits achetés et un code QR. Le client le scanne avec l'appareil photo de son téléphone et reçoit la carte avec les crédits. Le même QR reste disponible sur la commande : POS → Orders → la commande → Display QR Code ; un QR scanné deux fois n'ajoute jamais les crédits deux fois.
- Après toute autre vente, le même QR permet à un client de passage d'adhérer. Quand la vente ne contient aucun forfait prépayé et correspond à une carte de fidélité en émission automatique (étape 2), Display QR Code affiche un QR pour cette carte, avec ou sans client rattaché à la vente. Sans client rattaché : le client scanne le QR avec l'appareil photo de son téléphone, remplit le formulaire d'inscription de la carte (seuls les champs que vous avez rendus obligatoires sont demandés) et ajoute la carte à son wallet. Si la carte cumule sur les commandes, les points ou le tampon de cette vente sont sur la nouvelle carte, comptés une seule fois, et le client figure désormais dans l'onglet Détenteurs de la carte. Quand la vente porte l'e-mail ou le téléphone du client, le formulaire s'ouvre avec ces informations déjà remplies.
- Un client qui a déjà une carte (la tuile l'a scannée pendant la vente, ou le client rattaché à la vente en possède une) reçoit le QR de cette carte : le scanner ouvre la carte, ou l'ajoute de nouveau au téléphone. Aucune deuxième carte n'est créée, et la vente a déjà crédité la carte.
- Quand il n'y a pas de QR : l'écran répond This sale has no package for a card. quand la vente ne contient aucun forfait prépayé et qu'aucune carte de fidélité n'est émise sur elle : l'émission automatique est désactivée pour la carte, ou la carte est limitée à des produits absents de la vente. Une vente qui n'est pas entièrement payée, ou qui a été remboursée, n'ajoute aucun point à l'inscription.
- Vérifier la configuration : Réglages → Intégrations → Shopify → Configurer le scan POS affiche POS non configuré, POS partiellement configuré ou POS configuré, d'après ce que signalent vos appareils POS. L'état se met à jour après l'ouverture du POS avec la tuile, ou après une vente où la ligne QR s'est affichée. Une boutique sans vente POS depuis 60 jours affiche POS non utilisé.
- La consultation d'une carte en caisse est gratuite. Les points et les utilisations sont comptés à partir de la commande payée, comme pour les commandes en ligne.
Étape 5. Tester
- En ligne : passez une commande dans votre boutique avec un e-mail que vous consultez, sur un produit qui correspond à la carte. Sur la page Thank you, le bloc affiche Your purchase comes with a card. Touchez le bouton, remplissez le formulaire et ajoutez la carte à votre wallet.
- Dans Pass Studio, ouvrez l'onglet Détenteurs de la carte : le nouveau détenteur y figure et, si la carte cumule sur les commandes, les points de la commande de test sont dessus.
- En caisse : commencez une vente, touchez la tuile Pass Studio et scannez la carte que vous venez d'ajouter. Le client est rattaché à la vente.
- Crédits prépayés : vendez un produit forfait sur le POS, touchez Display QR Code et scannez le QR avec un téléphone.
- Client de passage : encaissez une vente sur le POS sans client rattaché, sur un produit qui correspond à la carte. Touchez Display QR Code, scannez le QR avec un téléphone qui n'a pas encore la carte, et remplissez le formulaire. Le nouveau détenteur figure dans l'onglet Détenteurs de la carte, avec les points de la vente.
Questions fréquentes
- Dois-je créer un webhook dans Shopify ? Non. La connexion de la boutique l'enregistre. Seulement si les Réglages affichent le panneau Set up auto-issue on purchase, ajoutez-le à la main en suivant ce panneau.
- Le bloc n'est pas sur ma page Thank you. Il n'y est pas tant que vous ne l'avez pas ajouté et que vous n'avez pas cliqué sur Save dans l'éditeur de paiement (étape 3). Ajoutez-le sur les deux pages : Thank you et Order status.
- Le bloc affiche « Your card is not ready yet ». Shopify a mis plus de 30 secondes à terminer la commande. En rouvrant la page une minute plus tard, la carte s'affiche.
- La tuile Pass Studio n'est pas dans le POS. Ajoutez-la depuis l'admin Shopify (étape 4a), pas depuis la fenêtre Add tile de l'appareil, qui n'affiche souvent pas les nouvelles tuiles d'applications. Comptez quelques minutes après l'installation de l'application.
- Pas de Display QR Code après une vente. Activez Activate on: Post-purchase (étape 4b). Si la ligne est là et répond This sale has no package for a card., la vente ne contenait aucun produit forfait prépayé et ne correspondait à aucune carte de fidélité en émission automatique (étape 2).
- Un client a déjà une carte. En aura-t-il une deuxième ? Non. Un client a une seule carte de fidélité active par boutique ; les pages de commande montrent la carte qu'il a.
- Est-ce compatible avec Smile, Yotpo ou LoyaltyLion ? Oui : à l'étape 2, choisissez J'ai déjà un programme de fidélité. La carte identifie le client au paiement et votre application garde le solde. Voir Smile + Pass Studio.
- Combien ça coûte ? Publier une carte coûte 10 crédits ; chaque carte émise coûte 1 crédit ; le traitement des commandes est gratuit. Voir Facturation.
Pour aller plus loin
- Shopify Setup (en anglais) : comment l'émission décide, codes de réduction, récompense automatique, webhook manuel.
- Shopify Flow (en anglais) : neuf déclencheurs et cinq actions sur les événements de carte.
- Application caisse : scanner les cartes au comptoir sans Shopify POS.
Historique : 2026-11-19 — guide publié, en remplacement du guide PDF de 2026-06 ; couvre la connexion, l'assistant de fidélité, le bloc Pass Studio wallet buttons sur les pages Thank you et Order status (depuis le 2026-11-18 sur chaque commande où la boutique émet une carte), et Shopify POS (tuile, et QR après une vente pour les forfaits prépayés). 2026-11-19 — le QR après une vente sert aussi une carte de fidélité émise sur les commandes : un client de passage, sans client rattaché à la vente, le scanne, adhère, et les points de la vente sont sur la nouvelle carte.