Aller au contenu

ADR : Basculer le dernier flow CB sur Checkout plutôt que migrer la page de paiement Lemonway

Contexte

Lemonway impose un changement technique sur sa page de paiement hébergée (nouveau parcours 3DS qui sort de l'app puis y redirige), avec une deadline annoncée au 22 juillet (BRI-1444). Le breaking change a été communiqué tardivement (mail automatique reçu ~24 h après la relance de Romain, alors que Lemonway doit prévenir 30 j avant) (transcript #L178). Le paiement Lemonway ne fonctionne déjà plus sur l'environnement de dev, ce qui laisse penser que le changement est entièrement breaking (BRI-1444). Le flow concerné (achat de bricks + carte cadeau) est le dernier encore sur la page Lemonway : tout le reste des paiements est déjà passé sur Checkout.

Options envisagées

Option A : Migrer la page de paiement Lemonway (subir le changement)

  • Description : adapter l'intégration à la nouvelle page hébergée Lemonway avant le 22/07.
  • Avantages : reste sur le provider en place pour ce flow.
  • Inconvénients : forte zone d'ombre (parcours, messages d'erreur, debug inconnus) → analyse à faire from scratch, temps « perdu » à comprendre un système qu'on abandonnera ; maintient deux providers en parallèle (transcript #L284, #L290).
  • Coût estimé : non chiffré (jugé difficilement gagnant vs Checkout).

Option B : Basculer ce flow sur Checkout

  • Description : migrer l'achat de bricks et la carte cadeau sur Checkout, comme le reste des paiements.
  • Avantages : Checkout déjà en prod et maîtrisé (logs, debug, redirection 3DS déjà gérée sur le top-up) ; un seul provider ; travail non jetable (transcript #L274).
  • Inconvénients : ~2 à 3 semaines de dev, la subtilité étant la réservation à gérer à l'achat en plus du 3DS ; la carte cadeau est dans le legacy (pas de composants Checkout réutilisables) (transcript #L151, #L209).
  • Coût estimé : 2 sem (optimiste) / 3 sem (réaliste) — Vincent (transcript #L209).

Décision

Option retenue : B — basculer sur Checkout.

Que la bascule se fasse maintenant ou en fin de trimestre, elle est de toute façon nécessaire ; autant la faire maintenant sous la contrainte Lemonway, sur un socle connu, plutôt que d'investir dans une page qu'on abandonnera et de maintenir deux providers (transcript #L119, #L302).

Conséquences

Positives attendues

  • Provider de paiement CB unifié (Checkout) sur tous les flows (transcript #L293).
  • Réutilisation du socle Checkout existant (redirection 3DS déjà gérée sur le top-up) (transcript #L209).

Négatives acceptées

  • ~3 semaines de dev qui décalent d'autant les autres sujets de Vincent (transcript #L250).
  • Refonte de la page carte cadeau (legacy) sans composants réutilisables (transcript #L151).

Reversibilité

  • Coût d'annulation : moyen — une fois migré sur Checkout, revenir sur la page Lemonway n'aurait pas de sens (sens de la migration = suppression du dernier flow Lemonway CB).

Plan d'implémentation

Porté par le projet Linear Bascule du dernier flow CB Lemonway → Checkout (target 22/07, lead Romain), découpé en 2 livrables (owner Vincent Besnier) : - BRI-1444 — achat de bricks (monorepo), MVP à faire en premier. - BRI-1450 — carte cadeau (legacy, page à refaire), après l'achat. - Vincent démarre l'analyse semaine du 07/07 (transcript #L266). - En parallèle, relance Lemonway pour obtenir un délai ou une période de cohabitation au-delà du 22/07. - Répercuter le décalage ~3 semaines sur les autres tickets de Vincent.

Métriques de succès

  • Aucune coupure de paiement à l'achat après le 22/07. Sinon : à définir.

Sources

Révisions

  • 2026-07-03 : auto-générée (status: proposed) depuis la synchro Leexi du 03/07. À valider par Romain.
  • 2026-07-06 : prémisse invalidée — bascule Checkout dépriorisée. Au weekly du 06/07 (fiche, transcript #L341), après démarrage de l'analyse le matin même, il ressort que le changement Lemonway n'est pas entièrement breaking : la nouvelle page V2 fonctionne, le paiement passe, et rien n'est à toucher côté API (même URL de redirection ; c'est Lemonway qui affiche sa nouvelle page au lieu de Mercanet). Il ne reste qu'un bug de redirection en fin de paiement (retour sur la page d'accueil au lieu de la modale de confirmation), jugé simple à corriger. Conséquence : la deadline du 22/07 n'est plus un breaking change, donc la bascule Checkout — qui n'aurait pas été priorisée sans l'alerte initiale — repasse en backlog (à faire, mais sans pression de date). Fallback : si le bug de redirection résiste, on bascule sur Checkout. La décision de fond (Checkout = cible à terme pour ce dernier flow CB) reste valable ; seule l'urgence tombe. Validée par Romain → accepted (la direction Checkout est actée ; la révision ne fait que retirer la pression de date). Owner du chantier : Vincent Besnier (BRI-1444).
  • 2026-07-15 : signal partenaire — orchestration Lemonway Q3 2026. Call AM Stéphane Cavarlé (fiche) : Lemonway présente une roadmap d'orchestration multi-gateway (cible ~octobre) + APM (Apple/Google Pay, moyens locaux), sans surcoût annoncé sur la grille actuelle. Romain pose les leviers de comparaison (diversité des moyens + taux d'acceptation) ; aucune décision de rebascule. La direction Checkout de cette ADR reste la référence opérationnelle tant que les données de perf LW ne sont pas reçues et évaluées. Détail confidentiel (stack, slides) → concepts/lemonway (local).