Erreurs

Ce qui passe sur le fil

• Où elles se situent

  Sur la réponse à un appel et sur l’événement qui signale un échec ultérieur. Le même vocabulaire de codes sert aux deux : un refus capté sur-le-champ et un renouvellement échoué la nuit passent par une seule table.

• Ce qui revient

  Un code HTTP qui classe l’échec, et dans le corps un code typé, un message destiné à un lecteur humain et un identifiant de requête. La référence énumère les codes; le texte du message ne fait pas partie du contrat.

• Ce que vous en faites

  Associez chaque code à une action, une seule fois et à un seul endroit : échouer, relancer, demander un autre moyen de paiement ou escalader. Aiguiller sur le texte casse à la première reformulation.

Quand l’utiliser

• Gérer les refus

  Aiguillez sur le code, pas sur le message, qui est écrit pour des humains et peut changer sans préavis.

• Récupérer des débits récurrents

  Les refus temporaires alimentent le calendrier de relance; les refus définitifs doivent l’arrêter et mener à demander une nouvelle carte plutôt qu’à brûler des tentatives.

• Décider quoi montrer au client

  Certains codes portent une information exploitable par le titulaire, d’autres une information que l’émetteur s’attend à ne pas voir divulguée. La table décide du message affiché.

Mettre en œuvre Erreurs

Ce qui échoue, et comment vous l’apprenez

• Relancer un refus définitif

  Cela ne peut pas réussir, et les tentatives répétées sur un compte fermé ou bloqué sont visibles par l’émetteur. La sortie est un nouveau moyen de paiement, pas une nouvelle tentative.

• Relancer sans la clé d’idempotence

  Une relance sans la clé est une nouvelle requête. Si la première a abouti, le client est débité deux fois et le doublon se découvre au rapprochement plutôt qu’à la caisse.

• Montrer le message brut au client

  Le texte du processeur s’adresse à un opérateur, pas à un titulaire de carte. L’afficher donne un checkout qui invite les gens à joindre une banque qui n’est pas la leur.

• Des codes inconnus qui passent au travers

  Un code non associé doit échouer et alerter, pas tomber par défaut dans la branche de relance. De nouveaux codes apparaissent, et le journal des modifications est l’endroit où ils sont annoncés.

Sandbox par rapport à la production

• Vous choisissez l’erreur

  Les refus de production dépendent de l’émetteur et ne se convoquent pas. En sandbox, une carte test documentée produit le même code à chaque fois : c’est la seule façon d’écrire un test qui l’affirme.

• Les échecs de plateforme aussi

  Les dépassements de délai et les échecs relançables se provoquent volontairement : le chemin d’idempotence s’exerce au lieu d’être présumé. C’est le chemin que personne ne teste avant qu’il coûte un double débit.

• Le vocabulaire est identique

  Le sandbox n’utilise pas un jeu de codes réduit. Une table bâtie sur les codes sandbox est celle dont la production a besoin : l’exercice vaut donc la peine avant la bascule.