Routage
Les prestataires envisagés pour un paiement, dans l'ordre, et les raisons de ce classement.
Lorsqu'un paiement peut passer par plusieurs prestataires, l'orchestrateur les classe et sélectionne le premier. La vue Routing conserve ce classement : chaque candidat, son score, les candidats ignorés et la chaîne de tentatives qui a suivi.
Elle répond à la seule question qui ne trouve sa réponse nulle part ailleurs : pourquoi ce paiement est-il passé par ce prestataire ?
Mode live uniquement
La vue Routing est réservée au mode live. Les paiements de sandbox ne passent pas par la sélection d'un prestataire. Un compte de sandbox ne contient donc aucune donnée ici.
Filtres
| Filtre | Élément recherché |
|---|---|
| Recherche | L'identifiant du paiement |
| Canal | cm.mtn, ci.orange et les autres |
| Prestataire | Celui qui a été sélectionné |
| Date de début, date de fin | Des journées calendaires entières |
| Résultat | fallback, circuit_skip ou no_candidate |
Le filtre de résultat est un raccourci utile à connaître.
| Résultat | Signification |
|---|---|
fallback | Plusieurs candidats ont été classés. La cascade disposait donc d'une solution de repli |
circuit_skip | Au moins un prestataire a été ignoré parce que son disjoncteur était ouvert |
no_candidate | Aucun candidat n'était admissible. Ces paiements ont échoué avant tout appel à un prestataire |
Filtrer sur no_candidate pendant une semaine est le moyen le plus rapide d'auditer votre configuration. Chaque ligne correspond à un paiement que vous n'auriez pas pu accepter.
Contenu d'un enregistrement de décision
| Champ | Remarque |
|---|---|
| Paiement | L'identifiant, le canal, le montant et la devise |
country_blocked | Vaut true lorsqu'une restriction de pays arrête le paiement avant le chargement des candidats |
circuit_skipped | Les prestataires retirés de la sélection, chacun avec sa raison |
candidates | La liste classée |
| Tentatives | Les appels réellement envoyés aux prestataires, dans l'ordre |
Chaque candidat contient l'ensemble du calcul qui détermine sa position.
| Champ | Signification |
|---|---|
rank | La valeur 1 désigne le premier candidat essayé |
priority | La priorité de base de ce prestataire sur votre compte |
rule_id, rule_boost | La règle de routage qui correspond et la valeur ajoutée |
is_least_cost, cost_boost | Indique s'il était le moins cher et la valeur de cet avantage |
telemetry_boost | Ajustement issu du taux de réussite récent du prestataire |
tiebreak_score | Valeur qui départage deux candidats autrement égaux |
weight | Valeur finale utilisée par le classement |
La lecture de ces champs dans l'ordre indique si un paiement a emprunté un rail en raison de votre règle, de son coût inférieur ou des échecs récents du prestataire attendu.
Trois points à examiner
Un candidat classé premier alors que vous ne l'attendiez pas. Comparez rule_boost et cost_boost. L'avantage accordé au coût minimal peut dépasser celui d'une règle que vous pensiez décisive.
Un prestataire absent de la liste des candidats. Il n'a pas été ignoré, il n'a jamais été admissible. La cause se situe avant le routage : prise en charge de la devise, du canal ou du pays, ou prestataire non activé sur votre compte.
Un prestataire dans circuit_skipped. Son disjoncteur était ouvert. Il avait donc connu suffisamment d'échecs pour être retiré de la rotation. La raison figure dans l'entrée.
`country_blocked` n'est pas une décision du prestataire
Il s'agit d'une restriction au niveau du compte, vérifiée avant le chargement des candidats. Lorsque cette valeur est true, la liste des candidats est vide et aucun prestataire n'a été contacté.
La chaîne de tentatives
Sous le classement figurent les actions réellement effectuées : une ligne par appel à un prestataire, dans l'ordre, avec le résultat de chacun. Pour un paiement réussi avec le deuxième candidat, l'échec du premier apparaît au-dessus. C'est tout l'intérêt d'une cascade vérifiable.
Routingtrx_CSUGajfv9xh0XQ5wu2lx
payment.created12:31:48.001
25,000 XAF, channel cm.mtn
route.evaluatedmomo-cm-mtn-first12:31:48.044
Rule "MoMo CM, MTN first" matched
provider.attempt.failedMTN MoMo12:31:48.901
MTN MoMo returned a 503 error
route.fallbackwaterfall12:31:49.220
Automatic waterfall fallback to next provider
provider.attempt.succeededOrange Money12:31:50.130
Payment accepted
payment.succeeded12:31:50.140
trx_CSUGajfv9xh0XQ5wu2lx, 1 940 ms over 2 attempts