Exemples de code

Ce qui passe sur le fil

• Ce que chaque exemple montre

  Un aller-retour complet : la requête telle qu’elle se construit, l’identifiant tel qu’il s’attache, le chemin de succès et au moins un chemin d’échec. Les noms de champs correspondent à la référence API.

• Ce qui en est volontairement absent

  Le stockage des secrets, la journalisation, la mise en file et le câblage du cadriciel. Cela appartient à votre application, et un exemple qui les devinerait serait faux pour la plupart des lecteurs.

• Comment en adapter un

  Remplacez l’identifiant, gardez la génération de la clé d’idempotence, gardez le traitement du corps brut dans l’exemple de webhook, et remplacez les branches d’erreur par vos actions plutôt que de les supprimer.

Quand l’utiliser

• Première intégration

  Partez d’un exemple qui fonctionne plutôt que d’en assembler un, puis lisez la référence pour comprendre ce que vous avez collé.

• Ajouter une capacité

  Remboursements, tokenisation et webhooks ont chacun leur exemple : l’adapter est plus rapide et plus sûr que d’étendre l’appel de paiement existant.

• Réviser l’intégration d’autrui

  Les exemples servent de référence de comparaison quand un chemin de paiement a été écrit par un prestataire ou hérité d’une équipe précédente.

Mettre en œuvre Exemples de code

Ce qui échoue, et comment vous l’apprenez

• La branche d’erreur a été supprimée

  La modification la plus fréquente consiste à retirer la partie qui gère l’échec, inutile pour voir un succès. C’est pourtant la raison d’être de l’exemple.

• La clé d’idempotence devenue constante

  La figer pour faire tourner un exemple transforme chaque débit suivant en répétition du premier, et le symptôme est un paiement qui semble disparaître plutôt qu’échouer.

• Le corps brut perdu au collage

  L’exemple de webhook lit la requête avant que le cadriciel l’analyse. Déposé dans une route qui reçoit déjà un objet, il fait échouer chaque événement valide.

• Des identifiants livrés avec le code

  Un exemple porte une clé fictive. La remplacer par une vraie, même sandbox, avant de la versionner installe l’habitude qui produira le même commit avec une clé de production.

Sandbox par rapport à la production

• Écrits pour le sandbox par défaut

  Chaque exemple suppose des identifiants sandbox et une carte test documentée : une première exécution est sûre par construction et donne le même résultat à tout le monde.

• Le même code part en production

  Seul l’identifiant change. Si un exemple exige des retouches au-delà de la configuration, c’est un défaut de l’exemple, pas une étape à deviner.

• L’exemple de webhook exige un tunnel

  Il attend un point de terminaison joignable. En sandbox, un tunnel HTTPS local suffit; la production exige une adresse routable, et c’est la seule partie qui change à la bascule.