# E-commerce

L'intégration e‑commerce est généralement un **omnichannel** 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 un identifiant persistant et scannable qui relie l'identité e‑commerce aux systèmes en magasin via l'intégration POS.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FW912E8OEzCaLVZj5sOnp%2Fimage.png?alt=media&#x26;token=f0f48c8f-fe1e-4742-beb5-c38728a758e9" alt="E-commerce “Add to Wallet” distribution flow for Apple Wallet and Google Wallet"><figcaption></figcaption></figure>

Cette approche réduit la dépendance aux e‑mails de confirmation et aux connexions aux comptes au point de vente. Elle simplifie également la reconnaissance des clients, l'attribution de fidélité et la rédemption des avantages à travers les canaux.

<details>

<summary><strong>Exemples concrets</strong></summary>

* Fidélité retail : une carte de fidélité est ajoutée depuis la page de compte e‑commerce, puis scannée en magasin pour rattacher les achats au profil.
* Clienteling : le code‑barres d'une Carte de membre est scanné pour récupérer le niveau et les avantages dans les outils POS ou de clienteling.
* Cartes cadeau : une carte cadeau Wallet est ajoutée depuis l'espace compte, puis mise à jour au fur et à mesure des changements de solde après les rédemptions.
* Click & collect : une Carte de retrait est émise pour le flux de collecte, puis scannée en magasin pour libérer la commande.

</details>

## Cas d'utilisation omnicanal principaux

Dans la plupart des programmes retail, les Cartes Wallet distribuées depuis l'e‑commerce sont **liées au compte**, pas **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 la rédemption + mises à jour du solde.
* **Reconnaissance client au POS**: identifiant scannable qui permet la recherche de profil et l'attribution omnicanal.
* **Carte de retrait (pick & collect)**: liée à la commande, utilisée lorsqu'un scan en magasin est requis pour libérer une commande préparée.

## Où placer “Ajouter à Wallet” dans l'e‑commerce

Le placement doit correspondre au moment où la carte devient utile comme 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 / zone profil (principal)

La zone compte est l'emplacement le plus stable. Elle convient 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 commande unique.
{% endstep %}

{% step %}

#### Moments post‑inscription / post‑connexion (secondaire)

Après une inscription ou une connexion, un CTA “Ajouter à Wallet” peut être affiché dans le cadre de l'onboarding. C'est souvent le moment de la plus forte intention pour les nouveaux membres du programme.
{% endstep %}

{% step %}

#### E‑mail transactionnel (solution de repli)

L'e‑mail est utile comme canal de récupération. Il aide lorsque le CTA web est manqué, lorsque l'achat est effectué sur un ordinateur de bureau, ou lorsque le client change d'appareil.
{% endstep %}

{% step %}

#### Pages de 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 dédiée au retrait). Cela limite les cartes liées à la commande aux cas où un scan en magasin est requis opérationnellement.
{% endstep %}
{% endstepper %}

## Mises à jour et cycle de vie (événements profil → mises à jour de la carte)

Lorsque les données du profil changent, la carte peut être mise à jour. Les applications Wallet peuvent afficher les mises à jour sous forme de notifications natives. Cela maintient la carte fiable et réduit les frictions au point de vente.

Déclencheurs de mise à jour typiques dans une configuration omnicanal :

* Changements de points et de niveau après 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 rédemption ou recharge
* Changements de préférence de magasin (magasin préféré, liste de magasins locaux)
* Changements de statut pick & collect (prêt, retardé, collecté) 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 %}

## Checklist du contenu de la carte (quoi inclure)

La carte doit répondre à “qui est ce compte client” et “ce qui est actuellement disponible”. Tout le reste appartient à 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 de magasins ou lien profond vers le localisateur de magasins (le cas échéant)
* Liens profonds (page compte, tableau de bord fidélité, gestion des cartes cadeau, service client)

Si une Carte de retrait est implémentée, la carte ajoute typiquement :

* Référence de retrait (pas la commande complète)
* Lieu et plage horaire de retrait
* QR/code‑barres de retrait utilisé par le personnel

## Implémentation avec The Wallet Crew

L'intégration e‑commerce combine typiquement distribution, liaison de profil et scan en magasin :

1. Créer (ou récupérer) la carte à partir d'un identifiant client stable (id CRM, id fidélité, id client e‑commerce).
2. Afficher un CTA “Ajouter à Wallet” dans le parcours compte e‑commerce.
3. Connecter le scan POS afin que la carte puisse être utilisée pour l'identification et la rédemption en magasin.
4. Envoyer les événements de profil à The Wallet Crew pour que la carte reste à jour (points, niveau, soldes, avantages).

Pour une implémentation du CTA prioritairement orientée site web, voir [Sur votre site web](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/enroll/on-your-website). Il couvre la détection d'appareil (Apple/Google) et une solution de repli pour desktop.

Le même bouton “Ajouter à Wallet” peut être intégré sur n'importe quelle page du site contrôlée par la Marque, tant que la page peut charger le SDK cinto (par exemple : espace compte, confirmation de commande, historique de commandes, pages de cartes cadeau ou portails de clienteling).

### Intégration POS (ce qui complète la boucle omnicanal)

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](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/pos).

## Guides plateformes e‑commerce

Utilisez les guides spécifiques à la plateforme ci‑dessous lorsqu'une intégration vitrine est requise (généralement dans les pages de compte ou les zones authentifiées).

* [Salesforce Commerce Cloud (SFCC)](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/e-commerce/salesforce-commerce-cloud)
* [Shopify](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/e-commerce/shopify)
* [Adobe Commerce (Magento)](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/e-commerce/adobe-commerce-magento)
* [Prestashop](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/e-commerce/prestashop)

Pour toute autre pile e‑commerce (ou un site personnalisé), utilisez [Sur votre site web](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/enroll/on-your-website). Le même bouton peut être intégré sur n'importe quelle page, tant que le SDK cinto peut être chargé et qu'un identifiant stable (ou `passId`) est disponible côté serveur.

## FAQ

<details>

<summary><strong>“Ajouter à Wallet” est‑il uniquement pertinent pour les billets ou les cartes d'embarquement ?</strong></summary>

Non. Les Cartes Wallet fonctionnent bien comme identifiants clients. Les exemples courants incluent les cartes de fidélité et d'adhésion, les cartes cadeau Wallet, les confirmations de retrait et les réservations de service.

</details>

<details>

<summary><strong>Une application mobile est‑elle requise pour utiliser les Cartes Wallet ?</strong></summary>

Non. Les Cartes Wallet fonctionnent indépendamment d'une application mobile. Cela réduit les frictions d'adoption pour les acheteurs occasionnels ou ponctuels.

</details>

<details>

<summary><strong>Une carte peut‑elle être mise à jour après son ajout ?</strong></summary>

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 se produit, en fonction du comportement et de la configuration de la plateforme.

</details>

<details>

<summary><strong>Est‑ce compatible avec les appareils Apple et Google ?</strong></summary>

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.

</details>