# Relier un site de réservation Le module `appointment-confirmed.mjs` s’utilise dans le serveur de réservation avec Node.js 22 ou ultérieur. Dans l’espace gérant, ouvre **Connecter un site**, choisis le programme et génère ses paramètres. Renseigne `LOYALTY_WEBHOOK_URL` et `LOYALTY_API_KEY` dans les variables secrètes de ce serveur. Les deux adresses du portefeuille utilisent les mêmes programmes et la même clé par programme. Tant que le nouveau domaine n’a pas été validé en HTTPS, utilise `https://portefeuille-fidelite.autumnalivy.chatgpt.site`. Après validation, `https://fidelwallet.fr` peut aussi servir pour les deux routes serveur. | Variable du site de réservation | Valeur | | --- | --- | | `LOYALTY_WEBHOOK_URL` | Adresse du portefeuille suivie de `/api/integrations/appointments`. | | `LOYALTY_API_KEY` | Clé du programme, réservée au serveur de réservation. | | `LOYALTY_WALLET_ORIGIN` | Facultatif, adresse du portefeuille sans chemin pour `site-wallet-login.mjs`. Par défaut, le module utilise l’adresse Sites existante. | Ajoute au formulaire une case d’adhésion facultative, décochée par défaut. Enregistre ce choix avec la réservation. Transmets une seule coordonnée, e-mail ou téléphone au format international, uniquement pour les réservations où le client a donné son accord. Le client doit vérifier cette coordonnée dans le portefeuille. Le gérant approuve sa demande avant que la carte soit disponible. Envoie les changements d’état après validation de la transaction de réservation. Pour un même rendez-vous, garde l’identifiant `id` et incrémente `revision` à chaque changement. Une relance réseau doit garder la même révision et le même contenu. Une file d’envoi persistée avec la réservation permet de reprendre après une interruption. Sur une erreur `retryable`, réessaie avec un délai croissant et respecte `retryAfterMs` s’il est renseigné. | État | Effet côté fidélité | | --- | --- | | `confirmed` | Enregistre le rendez-vous. Une confirmation seule ne crédite aucun point. | | `completed` | Rend le rendez-vous admissible après sa fin. En mode automatique, le crédit est appliqué dès que la carte est approuvée. En mode manuel, le gérant identifie la carte puis confirme le crédit du rendez-vous. | | `rescheduled` | Suspend le crédit. Envoie ensuite `confirmed` avec la nouvelle fin et une révision supérieure, puis `completed` après le nouveau rendez-vous. | | `cancelled` | Ferme ce rendez-vous sans crédit. Pour une nouvelle réservation, utilise une nouvelle référence. | Les anciennes révisions et les relances identiques ne créditent pas une deuxième fois. Après crédit, un rendez-vous est définitif dans l’historique de fidélité. Une nouvelle annulation ou un nouveau report reçoit alors une réponse HTTP 409 et laisse les points déjà comptabilisés intacts. ```js import { loyaltyEventForAppointment, sendLoyaltyAppointment } from './appointment-confirmed.mjs'; // Exemple d’événement construit avec les données du rendez-vous terminé. const événement = loyaltyEventForAppointment({ id: 'reservation-8345', revision: 4, status: 'completed', endsAt: '2026-01-16T16:30:00+01:00', loyaltyOptIn: true, contact: { email: 'cliente@exemple.fr' }, }); if (événement) await sendLoyaltyAppointment(événement); ``` Utilise une date ISO avec fuseau pour `endsAt`. N’envoie `completed` qu’après la fin enregistrée par le système de réservation. Sur une annulation ou un report, transmets l’accord conservé dans la réservation. La coordonnée peut être omise pour ces deux événements. L’ancien format `confirmed` sans `revision` ni `endsAt` reste accepté et ne déclenche aucun crédit. Une confirmation historique en attente ne devient admissible qu’à réception d’un événement de fin conforme. Les anciennes confirmations expirées et les points déjà comptabilisés restent dans leur état historique. Pour un programme manuel sans connecteur, le gérant peut aussi attester un rendez-vous en caisse. Il identifie une carte approuvée, saisit la référence de la réservation et une date de fin passée, puis confirme l’attribution. ## Ouvrir le Wallet depuis le compte fidélité de l’enseigne 1. Dans les réglages du programme, renseigne l’URL HTTPS qui ouvre le parcours sur ton site, par exemple `https://exemple.fr/fidelite/ouverture-wallet`. Utilise la clé du programme générée dans **Connecter un site** et stocke-la uniquement sur ton serveur. 2. Sur ton site, ajoute le lien Wallet fourni dans **Connecter un site**. Il redirige vers l’adresse configurée en ajoutant `wallet_challenge` à l’URL. Conserve ce paramètre côté serveur pendant ta propre connexion et contrôle son délai. Ton site authentifie le client avec un identifiant Snapchat géré par ton site, un e-mail ou un téléphone et son mot de passe habituel. Le mot de passe reste sur ton site. Pour connecter le compte Snapchat lui-même, utilise son parcours d’autorisation officiel. 3. Après avoir authentifié le client et obtenu son accord fidélité, appelle le module ci-dessous depuis ton serveur. Utilise l’identifiant interne stable de la session, jamais une valeur fournie par le navigateur. Une coordonnée est facultative et sert à associer les rendez-vous du programme. Envoie-la seulement si ton site a déjà vérifié qu’elle appartient au client. 4. Redirige le navigateur avec une réponse HTTP 303 vers le lien de retour. Le lien est temporaire et lié au navigateur où le client a commencé le parcours. Le Wallet enregistre la demande de carte au premier accès. Le gérant approuve la carte, puis le client peut configurer une clé d’accès pour les connexions suivantes. Conserve le lien de retour tel que l’API le renvoie. Même si le serveur de l’enseigne envoie l’approbation à l’autre domaine, le client revient au domaine du portefeuille sur lequel il a commencé. Les deux domaines ont chacun leur cookie de session et leurs propres clés d’accès. Après un changement d’adresse, une reconnexion puis la création d’une clé d’accès sur la nouvelle adresse sont nécessaires. ```js import { openCustomerWallet } from './site-wallet-login.mjs'; const returnUrl = await openCustomerWallet({ challenge: walletChallengeEnSession, customerId: clientAuthentifie.id, consent: clientAuthentifie.aAccepteLaFidelite, contact: { email: clientAuthentifie.emailVerifie }, // Omets le champ sans contact vérifié. }); return new Response(null, { status: 303, headers: { Location: returnUrl } }); ``` La même clé fonctionne pour transmettre les événements de rendez-vous et ouvrir une session Wallet pour ce programme. Un identifiant identique utilisé dans deux enseignes représente deux comptes séparés. Les points des programmes restent enregistrés dans le Wallet.