This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Point de vente (POS)

Connectez les systèmes POS à The Wallet Crew afin que les cartes Wallet puissent être identifiées, validées et mises à jour à partir des flux de paiement et de remboursement.

Les systèmes POS sont la source opérationnelle des événements de passage en caisse et de rédemption. L’équipe Wallet relie ces systèmes à Apple Wallet et Google Wallet afin que les Cartes restent utilisables au moment de la transaction.

Cela compte, car Wallet n’est pas seulement un canal de distribution. Au point de vente, la Carte doit être lisible, reconnue et alignée sur les dernières règles métier.

Comment fonctionnent les intégrations POS

Dans une intégration POS :

  1. Le POS reste la source de vérité pour les données de transaction et de rédemption.

  2. L’équipe Wallet associe les identifiants et les données de la Carte à des charges utiles compatibles avec Wallet.

  3. Les mises à jour Wallet reflètent les changements d’état qui comptent au moment du passage en caisse ou après la rédemption.

Cela conserve la logique opérationnelle dans les systèmes existants tout en rendant les Cartes Wallet fiables en magasin.

Exemples réels
  • Un détaillant scanne une Carte de fidélité à la caisse, puis actualise le solde de points.

  • L’utilisation d’une carte-cadeau met à jour immédiatement le solde de la Carte après le paiement.

  • Un comptoir de service valide une Carte d’adhésion avant d’en appliquer les avantages.

Ce que couvrent généralement les intégrations POS

Les intégrations POS typiques comprennent :

  • identification de la Carte à la caisse ou au comptoir de service

  • événements de rédemption et mises à jour d’état après rédemption

  • synchronisation optionnelle des soldes, de l’éligibilité ou des compteurs d’utilisation

Connecteurs POS disponibles

Les guides des connecteurs disponibles couvrent les plateformes POS suivantes :

Chaque guide documente la configuration spécifique à la plateforme et le comportement pris en charge.

Systèmes POS non répertoriés

Un POS non répertorié peut devenir un connecteur standard. L’équipe Wallet et le partenaire POS définissent conjointement ce périmètre lorsque l’intégration peut prendre en charge plusieurs marques.

Pour un POS propre à un tenant, utilisez un connecteur personnalisé. Le scripting du tenant peut appeler des API privées et appliquer des règles de mappage propriétaires. Définissez l’identifiant, le contrat API, le modèle de déclenchement et le responsable opérationnel avant l’implémentation.

Responsabilités

Domaine de responsabilité
POS ou système partenaire
L'équipe Wallet

Vérité des transactions et des rédemptions

Possède les enregistrements opérationnels et les règles de validation métier

Ne remplace pas la logique métier du POS

Gouvernance des identifiants

Définit les identifiants stables utilisés au moment du scan ou de la recherche

Utilise les identifiants pour résoudre et mettre à jour les Cartes

Cycle de vie de la charge utile Wallet

Fournit les entrées d’événements/de données

Génère et met à jour les charges utiles pour Apple Wallet et Google Wallet

Logique personnalisée optionnelle

Implémente des flux propriétaires spécifiques au POS

Fournit des points d’ancrage d’exécution et l’orchestration Wallet

FAQ

Le POS reste-t-il la source de vérité ?

Oui. L’équipe Wallet étend les données POS aux expériences Wallet, mais la logique de transaction et l’autorité de rédemption restent dans la pile POS.

L’intégration est-elle possible lorsque le POS n’est pas documenté ici ?

Oui. L’équipe Wallet et le partenaire POS peuvent définir le périmètre d’un connecteur standard. Pour les flux spécifiques au projet, utilisez un connecteur personnalisé.

Que faut-il valider avant un déploiement POS ?

Validez l’identifiant de la Carte, le chemin de scan, l’autorité de rédemption et le déclencheur de mise à jour de la Carte. Testez le flux avec le matériel de scanner de production avant le déploiement.

Que faut-il décider en premier dans un projet POS ?

Commencez par la stratégie d’identifiant, la responsabilité du flux de rédemption et les déclencheurs de mise à jour. Ces trois décisions définissent la majeure partie de la forme de l’implémentation.

Mis à jour