GuidesEncaisserRoutage
Routage
Sans connection_id, PayHaze choisit pour chaque paiement le compte qui l’encaisse parmi vos comptes, chez un ou plusieurs prestataires. Il écarte d’abord ceux qui ne peuvent pas le prendre, puis suit le mode automatique ou vos propres règles, et garde la raison de chaque choix.
D’abord, les comptes qui peuvent encaisser
Un compte n’est candidat que s’il est actif, prend la devise et le mode de capture du paiement, n’est pas en panne et n’a pas atteint son plafond du jour. Aucune règle ne rend candidat un compte qui ne l’est pas, et un paiement ne change pas de compte une fois créé.
- En panne : au moins 3 échecs techniques en 5 minutes (réponses perdues ou incohérentes), soit la moitié ou plus des opérations du compte sur 15 minutes. Un refus de la banque ou un abandon de l’acheteur n’en est pas un. Après 5 minutes sans nouvel échec, le compte est repris ; aucun paiement n’est inventé pour le tester.
- Plafond du jour : les paiements acceptés ou en cours depuis minuit, heure de Paris ; un remboursement ne libère pas de place.
- Tous les comptes pleins : PayHaze refuse le paiement ou l’envoie à votre compte de secours, selon votre choix (PUT /v1/routing/policy).
Le mode automatique : le compte qui accepte le plus
Par défaut, chaque paiement part vers le compte au meilleur taux d’acceptation, calculé à chaque décision sur ses 30 derniers paiements terminés : acceptés contre refusés par la banque, sans les abandons. À taux égal, le moins cher selon le tarif de votre contrat.
- Moins de 10 paiements terminés : le compte est encore à l’essai, le moins cher passe d’abord
- Sous 20 % d’acceptation pendant qu’un autre compte fonctionne : le compte est mis de côté
- Un paiement sur 20 essaie un autre compte candidat, pour que chaque taux reste à jour
Vos propres règles, sans code
Une version contient jusqu’à 50 règles, lues dans l’ordre. Une condition porte sur le montant, la devise, le mode de capture ou l’absence de compte en bonne santé. L’action envoie vers un compte nommé, le meilleur taux d’acceptation, le coût estimé le plus bas, le premier compte candidat, chacun son tour, n’importe quel compte capable avec une alerte, ou refuse avec votre raison.
curl -X POST "$PAYMENT_OS_API/v1/routing/versions" \
-H "Authorization: Bearer $PAYMENT_OS_KEY" \
-H "X-Merchant-ID: $MERCHANT_ID" \
-d '{
"rules": [
{ "if": { "field": "currency", "op": "is", "value": "GBP" }, "then": { "route": "connection", "connection_id": "con_5b1d7e2a-0c4f-4e8b-a9d3-6f2e1c8b4a70" } },
{ "if": { "field": "amount", "op": "gt", "minor": 50000 }, "then": { "route": "lowest_cost" } },
{ "if": null, "then": { "route": "best_acceptance" } }
]
}'- Observer : le brouillon calcule son choix à côté des règles en place, pour chaque paiement, sans rien envoyer (POST /v1/routing/versions/{id}/observe)
- Rejouer : combien de paiements des 7 derniers jours auraient changé de compte, et l’écart de frais estimé (POST /v1/routing/replay)
- Activer, avec une double vérification : la version remplacée est gardée et peut être réactivée (POST /v1/routing/versions/{id}/activate)
Chaque décision expliquée
Pour chaque paiement, PayHaze garde le mode, la version et la règle appliquées, le compte choisi, l’alerte éventuelle, une explication, et chaque compte regardé avec ses raisons : devise non prise en charge, en panne, plafond du jour atteint.
curl "$PAYMENT_OS_API/v1/payment-intents/pay_7c1e…/route" \
-H "Authorization: Bearer $PAYMENT_OS_KEY" \
-H "X-Merchant-ID: $MERCHANT_ID"La même explication figure sur la fiche du paiement, dans le tableau de bord. GET /v1/routing montre le mode en place, vos versions avec les paiements passés par chaque règle sur 7 jours, la santé et le plafond de chaque compte.