Routage des paiements entre les portefeuilles dans QryptoPay

QryptoPay peut diriger un nouveau paiement non pas vers un portefeuille tiré au hasard dans le pool, mais vers un portefeuille précis, selon une liste ordonnée de règles que vous définissez dans l’onglet « Flux de paiement » de la fiche du marchand. C’est utile si vous avez plusieurs portefeuilles actifs sur un même réseau et que l’argent doit se répartir entre eux selon des règles, et non au hasard : par exemple, les paiements d’une région vers un portefeuille et ceux d’une autre région vers un autre, ou les grosses commandes séparées des petites.

Les règles ne décident quelque chose que lorsqu’un réseau compte au moins deux portefeuilles actifs. La manière d’en ajouter un et de passer d’un réseau à l’autre est décrite dans l’article Gérer les portefeuilles dans QryptoPay. Un seul portefeuille Monero est actif à la fois, le routage entre plusieurs portefeuilles XMR ne s’applique donc pas.

L’onglet « Flux de paiement »

Les réglages de routage sont indépendants des portefeuilles : ils se trouvent sur la page du marchand, dans l’onglet « Flux de paiement » (juste après « Page de paiement »). Un sélecteur de réseau figure en haut de la page : les règles et la route de secours se configurent séparément pour chaque réseau, et passer d’un réseau à l’autre ne reporte rien.

Comment une règle est construite

Une règle se déploie en un bloc « si » … « alors » :

• le champ facultatif « Nom de la règle » — jusqu’à 60 caractères, une étiquette pour le marchand lui-même. Le nom n’influe en rien sur le choix du portefeuille : c’est un repère pour l’humain, pas une partie de la condition. Quand le nom est vide, la règle repliée s’affiche comme « Sans nom » ;
• un ou plusieurs groupes de conditions, séparés par le mot « ou » : la règle se déclenche si au moins un groupe correspond en entier. Le bouton Ajouter un groupe « ou » ajoute un nouveau groupe ;
• à l’intérieur d’un groupe, les lignes sont reliées par le mot « et » : le groupe n’est validé que si toutes ses lignes sont vraies. L’interface le dit elle-même à côté de l’étiquette « si » : « toutes les lignes sont vraies » tant qu’il n’y a qu’un groupe, et « l’un des groupes est vrai » dès qu’il y en a plusieurs ;
• le portefeuille destinataire se trouve sous la condition, à côté du libellé « le paiement est envoyé au portefeuille » : c’est la partie « alors » de la règle.

Une ligne à l’intérieur d’un groupe est de l’un des types suivants, que l’on ajoute par le menu « Ajouter une ligne » :

• « Paramètre de boutique » — une paire « clé = valeur ». La clé est celle que vous transmettez dans metadata en générant le lien de paiement (voir Intégrer la boutique à QryptoPay), par exemple location. La valeur est comparée sans tenir compte de la casse : usa et USA sont équivalents. Vous pouvez ajouter autant de lignes de ce type que vous voulez dans un groupe.
• « Montant de la commande » — les champs « De » et « À », une plage en dollars, hors frais de paiement en cryptomonnaie. Un groupe ne peut contenir qu’une seule ligne de ce type : tant qu’elle existe, il n’est pas possible d’en ajouter une seconde.

La borne supérieure du montant n’est pas incluse

Le champ « À » n’affiche plus d’indication à ce sujet dans l’interface : la voici. La borne supérieure de la plage n’entre pas dans la condition. Une commande exactement égale à ce montant ne passe pas cette ligne et est examinée plus loin, par le groupe suivant ou par la règle suivante. Par exemple, une plage de $0 à $500 retient une commande de $499,99, mais pas une commande d’exactement $500. Un champ « À » vide signifie qu’il n’y a pas de borne supérieure.

L’ordre des règles est la priorité

La liste se lit de haut en bas, et le paiement revient à la première règle dont la condition est remplie : l’interface n’a plus de priorité numérique distincte. Les règles se réordonnent avec les boutons ↑ et ↓ de chaque ligne.

Si le portefeuille visé par une règle est désactivé, la règle est ignorée lors de la sélection, et c’est la règle suivante de la liste qui a sa chance. Si ce portefeuille est supprimé, la règle est supprimée avec lui.

Quand aucune règle ne correspond

Ce n’est pas un bloc à part, à côté des règles, mais le pied de la même liste : le sélecteur « Si aucune règle ne correspond ». Modes disponibles :

• « Portefeuille aléatoire du pool » — le mode par défaut : le paiement part vers un portefeuille actif du réseau tiré au hasard, comme il le ferait sans routage.
• « Portefeuille sélectionné » — tous les paiements non appariés vont vers un même portefeuille, que vous indiquez à côté.

⚠️ Un portefeuille indisponible entraîne un refus de paiement

Si le portefeuille sélectionné devient indisponible, le paiement du client échouera.

Autrement dit, le mode « Portefeuille sélectionné » ne se rabat pas sur le pool : si vous désactivez ou supprimez le portefeuille désigné, un client dont le paiement ne correspond à aucune règle ne pourra plus payer du tout, au lieu d’être dirigé vers un portefeuille tiré au hasard dans le pool. Ne gardez ce mode activé que tant que le portefeuille désigné est sûrement actif.

Vérifier où est allé un paiement

Sur la fiche du paiement, sous le bloc « Portefeuille QryptoPay », le panneau indique pourquoi le paiement a atterri là :

• si une règle s’est déclenchée, une ligne du type « Règles de routage : location = dubai · montant de $500 à $5 000 » ;
• si le paiement est parti vers le portefeuille par défaut, « Portefeuille sélectionné par défaut » ;
• si le paiement vient du pool ou a été accepté avant l’apparition de cette fonction, il n’y a aucune ligne.

C’est un instantané de la décision au moment du paiement, et non le réglage actuel des règles : si vous modifiez les règles plus tard, l’explication des paiements déjà acceptés ne change pas.

Étapes suivantes

• Gérer les portefeuilles dans QryptoPay — soldes, réserve de frais, désactivation d’un portefeuille.
• Intégrer la boutique à QryptoPay — comment transmettre les metadata sur lesquelles reposent les conditions sur un paramètre de boutique.
• Configurer les frais par devise dans QryptoPay — les frais sont calculés sur le même montant de commande que celui qu’examine la condition de montant.