# E-commerce
L’intégration e-commerce est généralement une **omnicanal** sujet. L’objectif est de permettre aux clients d’utiliser le même compte en ligne et en magasin, sans nécessiter d’application mobile. Une Carte Wallet agit comme une identité persistante et scannable qui relie l’identité e-commerce aux systèmes en magasin via l’intégration POS.
Cette approche réduit la dépendance aux e-mails de paiement et aux connexions au compte au moment de l’achat. Elle simplifie également la reconnaissance client, l’attribution de fidélité et l’utilisation des avantages sur tous les canaux.
Exemples concrets
* Fidélité retail : une Carte de fidélité est ajoutée depuis la page du compte e-commerce, puis scannée en magasin pour rattacher les achats au profil.
* Clienteling : un code-barres de Carte d’adhésion est scanné pour récupérer le niveau et les avantages dans le POS ou les outils de clienteling.
* Cartes-cadeaux : une Carte-cadeau Wallet est ajoutée depuis l’espace compte, puis mise à jour à mesure que le solde change après les utilisations.
* Click & collect : une Carte de retrait est émise pour le flux de collecte, puis scannée en magasin pour libérer la commande.
## Cas d’usage omnicanaux principaux
Dans la plupart des programmes retail, les Cartes Wallet distribuées depuis l’e-commerce sont **liées au compte**, et non **liées à la commande**. La Carte représente une relation continue (fidélité, adhésion, valeur stockée). Elle reste stable dans le temps et se met à jour lorsque le profil client change.
Schémas courants :
* **Carte de fidélité / d’adhésion**: identifiant client + points + niveau + avantages.
* **Carte-cadeau Wallet**: valeur stockée + code-barres/QR pour l’utilisation + mises à jour du solde.
* **Reconnaissance client au POS**: identifiant scannable qui permet la recherche du profil et l’attribution omnicanale.
* **Carte de retrait (pick & collect)**: liée à la commande, utilisée lorsqu’un scan en magasin est nécessaire pour libérer une commande préparée.
## Où placer « Add to Wallet » dans l’e-commerce
Le placement doit correspondre au moment où la Carte devient utile en tant qu’identifiant de compte. En pratique, c’est généralement lorsque le client est authentifié ou lorsque l’inscription est terminée.
{% stepper %}
{% step %}
#### Mon compte / espace profil (principal)
L’espace compte est le placement le plus stable. Il fonctionne pour la fidélité et l’adhésion, prend en charge les flux de réinstallation et évite de lier le cycle de vie de la Carte à une seule commande.
{% endstep %}
{% step %}
#### Moments post-inscription / post-connexion (secondaire)
Après une inscription ou une connexion, un CTA « Add to Wallet » peut être affiché dans le cadre de l’onboarding. C’est souvent le moment où l’intention est la plus forte pour les nouveaux membres du programme.
{% endstep %}
{% step %}
#### E-mail transactionnel (solution de secours)
L’e-mail est utile comme canal de récupération. Il aide lorsque le CTA web a été manqué, lorsque l’achat est finalisé sur ordinateur ou lorsque le client change d’appareil.
{% endstep %}
{% step %}
#### Pages pick & collect (exception liée à la commande)
Lorsque la Carte est utilisée comme jeton de retrait, le meilleur emplacement est dans le flux pick & collect (page de confirmation et/ou page de retrait dédiée). Cela limite les Cartes liées à la commande aux cas où un scan en magasin est nécessaire pour des raisons opérationnelles.
{% endstep %}
{% endstepper %}
## Mises à jour et cycle de vie (événements de profil → mises à jour de la Carte)
Lorsque les données de profil changent, la Carte peut être mise à jour. Les apps Wallet peuvent afficher les mises à jour sous forme de notifications natives. Cela maintient la fiabilité de la Carte et réduit les frictions au point de vente.
Déclencheurs de mise à jour typiques dans une configuration omnicanale :
* Changements de points et de niveau après un achat (en ligne ou en magasin)
* Changements d’éligibilité aux avantages (nouveaux privilèges, privilèges expirés, statuts spéciaux)
* Changements de solde de la Carte-cadeau après utilisation ou rechargement
* Changements de préférence de magasin (magasin préféré, liste des magasins locaux)
* Changements de statut pick & collect (prêt, retardé, récupéré) lorsqu’une Carte de retrait est utilisée
{% hint style="info" %}
Les notifications Wallet sont liées à une Carte installée. Elles ne nécessitent pas l’installation d’une application mobile.
{% endhint %}
## Liste de vérification du contenu de la Carte (quoi inclure)
La Carte doit répondre à « quel est ce compte client » et « qu’est-ce qui est actuellement disponible ». Tout le reste doit se trouver derrière un lien vers des pages authentifiées.
Champs recommandés :
* Nom de la marque et contact support (e-mail/téléphone/URL)
* Identifiant d’adhésion / de fidélité (visible + code-barres/QR scannable si nécessaire)
* Solde de points, niveau et progression de niveau (le cas échéant)
* Résumé des avantages (ce qui peut être utilisé en magasin et en ligne)
* Liste des magasins ou lien profond vers le localisateur de magasins (si pertinent)
* Liens profonds (page de compte, tableau de bord fidélité, gestion de Carte-cadeau, service client)
Si une Carte pick & collect est mise en œuvre, la Carte ajoute généralement :
* Référence de retrait (pas la commande complète)
* Lieu et créneau de retrait
* QR/code-barres de retrait utilisé par le personnel
## Mise en œuvre avec The Wallet Crew
L’intégration e-commerce combine généralement la distribution, la liaison au profil et le scan en magasin :
1. Créez (ou récupérez) la Carte à partir d’un identifiant client stable (ID CRM, ID fidélité, ID client e-commerce).
2. Exposez un CTA « Add to Wallet » dans le parcours de compte e-commerce.
3. Connectez le scan POS afin que la Carte puisse servir à l’identification et à l’utilisation en magasin.
4. Envoyez les événements de profil à The Wallet Crew afin que la Carte reste à jour (points, niveau, soldes, avantages).
Pour une mise en œuvre du CTA centrée sur le site web, voir [Sur votre site web](https://github.com/TheWalletCrew/docs/blob/main/enroll/on-your-website.md). Cela couvre la détection d’appareil (Apple/Google) et une solution de repli sur ordinateur.
Le même bouton « Add to Wallet » peut être intégré sur n’importe quelle page du site contrôlée par la Marque, à condition que la page puisse charger le SDK cinto (par exemple : espace compte, confirmation de commande, historique des commandes, pages de Carte-cadeau ou portails de clienteling).
### Intégration POS (ce qui complète la boucle omnicanale)
Une Carte Wallet devient le « maillon manquant » entre les canaux en ligne et physiques lorsqu’elle est scannable au point de vente.
Le schéma courant est :
* la Carte encode un identifiant stable dans un code-barres/QR (ou un jeton sécurisé résolu côté serveur)
* le personnel scanne la Carte à la caisse
* le POS (ou une couche fidélité/CRM connectée) utilise cet identifiant pour récupérer le profil client, appliquer les avantages et attribuer la transaction
Les intégrations POS sont documentées sous [POS](/connectors/fr/pos.md).
## Guides de plateforme e-commerce
Utilisez les guides spécifiques à la plateforme ci-dessous lorsqu’une intégration de la boutique est requise (généralement sur les pages de compte ou dans les zones authentifiées).
* [Salesforce Commerce Cloud (SFCC)](/connectors/fr/e-commerce/salesforce-commerce-cloud.md)
* [Shopify](https://github.com/TheWalletCrew/docs/blob/main/connect/e-commerce/shopify.md)
* [Adobe Commerce (Magento)](https://github.com/TheWalletCrew/docs/blob/main/connect/e-commerce/adobe-commerce-magento.md)
* [Prestashop](/connectors/fr/e-commerce/prestashop.md)
Pour toute autre pile e-commerce (ou un site web personnalisé), utilisez [Sur votre site web](https://github.com/TheWalletCrew/docs/blob/main/enroll/on-your-website.md). Le même bouton peut être intégré sur n’importe quelle page, à condition que le SDK cinto puisse être chargé et qu’un identifiant stable (ou `passId`) soit disponible côté serveur.
## FAQ
« Add to Wallet » est-il seulement pertinent pour les billets ou les cartes d’embarquement ?
Non. Les Cartes Wallet fonctionnent bien comme justificatifs client. Les exemples courants incluent les cartes de fidélité et d’adhésion, les cartes-cadeaux Wallet, les confirmations de retrait et les réservations de service.
Une application mobile est-elle nécessaire pour utiliser les Cartes Wallet ?
Non. Les Cartes Wallet fonctionnent indépendamment d’une application mobile. Cela réduit la friction d’adoption pour les acheteurs ponctuels ou occasionnels.
Une Carte peut-elle être mise à jour après son ajout ?
Oui. Les données de la Carte peuvent être mises à jour après l’installation. Les clients peuvent également recevoir une notification Wallet lorsqu’une mise à jour survient, selon le comportement de la plateforme et la configuration.
Est-ce compatible avec les appareils Apple et Google ?
Oui. The Wallet Crew prend en charge Apple Wallet et Google Wallet. Les flux de distribution et de mise à jour sont unifiés au niveau de la plateforme.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.thewalletcrew.io/connectors/fr/e-commerce.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.