BitriPay
ONE QR. ONE GATEWAY. EVERY ELIGIBLE RAIL.Pay Local. Fund Global. Settle Your Way.
développeurs

Comment un paiement décide par où passer

Un paiement peut généralement voyager par plusieurs chemins, et ils ne sont pas tous aussi bons à deux heures du matin. Router sur le succès mesuré, le coût et la latence — avec un disjoncteur sur les rails défaillants — fait la différence entre la résilience et une mauvaise nuit.

La plupart des intégrations de paiement contiennent une décision que personne ne revisite : le prestataire choisi la première semaine.

Cela fonctionne. Puis une nuit, cela ne fonctionne plus — pas en panne, juste lent et échouant un paiement sur cinq — et chaque paiement se dégrade avec lui. L’entreprise l’apprend par ses clients.

Le routage est un problème de mesure

Un paiement peut généralement passer par plusieurs chemins. Ces chemins ne valent pas la même chose, et celui qui est le meilleur change d’heure en heure.

La question n’est donc pas quel prestataire avons-nous choisi mais lequel de ceux-ci peut porter ce paiement, maintenant, au mieux.

Noté sur ce qui s’est réellement passé

Chaque connecteur candidat est noté sur trois choses mesurées : son taux de succès récent, le coût total de son usage, et sa latence observée.

Ces chiffres viennent d’une télémétrie conservée par tranches de quinze minutes sur vingt-quatre heures — éventuellement indexée par tranche de montant et par préfixe, parce qu’un rail excellent pour de petits paiements locaux ne l’est pas nécessairement pour de gros.

C’est une mesure, pas une liste de préférences écrite une fois.

Le disjoncteur

Un connecteur qui échoue de façon répétée voit son circuit ouvert : il cesse d’être proposé.

Après un délai, il passe en demi-ouvert — un paiement est autorisé à passer comme test. S’il réussit, le circuit se ferme et le trafic normal reprend. S’il échoue, retour à ouvert.

L’effet est qu’un rail qui se rétablit est testé avec un seul paiement plutôt qu’avec tous vos clients.

Une bascule qui ne débitera pas deux fois

C’est là qu’une logique naïve de nouvelle tentative fait de vrais dégâts.

La bascule a lieu uniquement pour les erreurs qui garantissent qu’aucun argent n’a bougé. Pour tout ce qui est ambigu — un dépassement de délai, un code de réponse inconnu — le statut est vérifié d’abord.

Un paiement qui a peut-être réussi n’est pas réessayé. Perdre une vente par prudence est récupérable. Débiter un client deux fois, c’est un remboursement, une réclamation et une réputation.

Votre politique

Un commerçant peut orienter le routage vers le moins cher, le plus rapide ou le plus fiable, et restreindre les rails qu’un paiement peut utiliser.

Ce que vous ne pouvez pas faire, c’est forcer un rail dont le disjoncteur est ouvert. Ce n’est pas une limite ; c’est toute la valeur d’avoir un disjoncteur.

Vous pouvez voir ce qui s’est passé

Chaque paiement enregistre le connecteur qui l’a porté et les tentatives précédentes. Le tableau de bord montre le chemin réellement emprunté — pas celui qui était prévu, qui est le chiffre que la plupart des systèmes vous donnent et celui qui ne sert à rien pendant un incident.

Ce que cela coûte

Rien de plus. Vous payez le tarif du rail qui a porté le paiement, et le tableau de bord vous dit lequel l’a fait.

Ce que vous pouvez vérifier

Ce sont des faits sur la plateforme en fonctionnement, pas des adjectifs. Chacun est visible dans le produit, dans la référence de l’API ou dans le grand livre.

  • Les notes viennent d’une télémétrie conservée par tranches de quinze minutes sur vingt-quatre heures, éventuellement indexée par tranche de montant et par préfixe, plutôt que d’une liste de préférences figée.
  • Le disjoncteur passe de fermé à ouvert après des fautes consécutives, puis à demi-ouvert après un délai, puis à fermé au succès suivant : un rail qui se rétablit est testé avec un paiement et non avec tous.
  • La santé est un état par connecteur — sain, dégradé, indisponible, en maintenance — déduit du disjoncteur, de la dernière sonde et des succès récents.
  • La bascule n’a lieu que pour les erreurs qui garantissent qu’aucun argent n’a bougé ; tout ce qui est ambigu déclenche d’abord une vérification de statut.
  • Un commerçant peut orienter le routage vers le moins cher, le plus rapide ou le plus fiable, paiement par paiement.

Ce que cela coûte

Inclus. Vous payez le tarif du rail qui a porté le paiement, et le tableau de bord indique lequel l’a fait.

Est-ce activé ?

La disponibilité dépend des autorisations en place et de ce que l’administrateur d’un déploiement donné a activé. Cela change, un article non — la réponse vivante est donc sur la page de la fonctionnalité, qui la lit dans la plateforme elle-même : Smart Route sur la page des fonctionnalités.

À lire ensuite

Frequently asked questions

Une nouvelle tentative pourrait-elle facturer mon client deux fois ?

La bascule n’a lieu que pour les erreurs qui garantissent qu’aucun argent n’a bougé. Pour tout ce qui est ambigu — un dépassement de délai, un code inconnu — le statut est vérifié d’abord. Ne pas réessayer vaut mieux que réessayer vers un double débit.

Puis-je forcer un rail particulier ?

Vous pouvez orienter la politique de routage vers le moins cher, le plus rapide ou le plus fiable, et restreindre les rails qu’un paiement peut utiliser. Ce que vous ne pouvez pas faire, c’est forcer un rail dont le disjoncteur est ouvert, qui est tout l’intérêt d’en avoir un.

Comment savoir quel rail a été utilisé ?

Chaque paiement enregistre le connecteur qui l’a porté, ainsi que les tentatives précédentes. Le tableau de bord montre le chemin réellement emprunté, pas celui qui était prévu.

construire sur bitripay smart route
Try it with a free account

Send with a QR code, add money by card or mobile money, issue a virtual card. Sandbox balances let you explore before any real money moves.

Open an account

Keep reading