Un virement accepté n'est pas un virement arrivé

« Accepté » ne veut pas dire « arrivé »

Vous envoyez un lot de versements. L'API répond en deux secondes, chaque ligne porte un identifiant, et le statut dit PENDING ou SUCCESS selon le prestataire. Votre tableau de bord affiche « envoyé », l'affilié reçoit un e-mail qui lui annonce son paiement, et tout le monde passe à autre chose.

Sauf que la réponse que vous venez de recevoir ne dit pas que les fonds sont arrivés. Elle dit que la demande a été acceptée pour traitement. Ce sont deux affirmations très différentes, et l'écart entre les deux peut durer trente jours.

Le cas PayPal, en détail

Un versement PayPal vers une adresse e-mail suit ce chemin :

Vous envoyez le lot. PayPal accepte et rend un identifiant de lot.
Si l'adresse correspond à un compte PayPal confirmé, les fonds arrivent en quelques minutes. C'est le cas le plus fréquent, et c'est celui qui donne confiance dans le reste.
Si l'adresse ne correspond à aucun compte confirmé, PayPal met le paiement en attente et envoie un message à cette adresse : « quelqu'un vous a envoyé un paiement, créez un compte pour le recevoir ».
La personne a trente jours. Passé ce délai, le paiement est UNCLAIMED, puis RETURNED, et les fonds reviennent sur votre solde.

Il y a d'autres chemins de retour : un compte fermé, un pays non desservi, une adresse avec une faute de frappe, un blocage de conformité. Le point commun est que rien de tout cela n'est connu au moment où l'API vous a répondu.

Ce qui se passe si personne ne regarde

Une plateforme qui s'arrête à la première réponse produit une situation précise, et déplaisante :

Votre comptabilité indique 128 € versés, et les fonds sont sur votre solde PayPal.
Le solde de l'affilié est à zéro, alors que vous lui devez toujours 128 €.
Une facture a été émise pour un paiement qui n'a pas eu lieu.
L'affilié a reçu un e-mail lui annonçant un paiement qu'il n'a jamais reçu.

Et surtout : c'est lui qui vous l'apprend, souvent des semaines plus tard, souvent agacé. Vous ouvrez PayPal, vous ne retrouvez pas la ligne, il faut la chercher, et pendant ce temps la personne qui vous apporte des ventes se demande si elle sera payée.

Le pire dans un virement revenu n'est pas la somme. C'est que la seule personne au courant soit celle qui attend les fonds.

Ce qu'il faut faire à la place

Interroger jusqu'à une réponse qui ne peut plus changer

Chaque ligne partie doit rester dans un état « en cours » et être réinterrogée périodiquement — ici, toutes les heures — jusqu'à ce que le prestataire donne un état terminal : arrivé, échoué, ou revenu. Tant que la réponse peut encore changer, la ligne n'est pas soldée.

Une heure n'est pas un chiffre magique. C'est un compromis : assez fréquent pour que vous l'appreniez le jour même, assez espacé pour ne pas déclencher de limitation d'API sur un lot de deux cents lignes.

Défaire proprement, pas partiellement

Quand la réponse est « revenu », il y a cinq choses à faire, et faire quatre sur cinq laisse la base incohérente :

Marquer la ligne comme revenue, avec sa date et le motif rendu par le prestataire.
Rétablir le solde de l'affilié, par une écriture de sens inverse — pas en modifiant l'écriture d'origine, qui doit rester lisible.
Repasser les ventes concernées à « à verser », pour qu'elles reviennent naturellement dans le prochain lot.
Émettre un avoir numéroté qui nomme la facture émise. Une facture ne se supprime pas : elle s'annule.
Prévenir les deux parties. L'affilié a reçu un message disant qu'il avait été payé : il doit en recevoir un qui le corrige, et qui lui dit quoi faire.

Le détail comptable qui compte

La contre-passation d'un versement est une écriture supplémentaire, pas une modification de l'écriture d'origine. Le grand livre garde donc deux lignes qui s'annulent, et l'historique reste lisible.

Conséquence pratique pour qui écrit le logiciel : on ne peut pas lire « cette commission a-t-elle été payée ? » en cherchant l'existence d'une écriture de versement. Il faut regarder la somme. Un test qui se contente de vérifier qu'une écriture existe conclura que l'affilié a été payé, et il aura tort.

Comment en avoir moins

Un retour reste un cas rare, mais on peut le rendre plus rare encore.

Demander l'adresse de versement à l'inscription, pas au moment du premier paiement. L'affilié la vérifie quand il est attentif, pas quand il attend.
Refuser un lot incomplet plutôt que de sauter des lignes. Un affilié sans adresse doit apparaître dans une liste « impossible à payer » avec le motif, et recevoir un e-mail — une fois, au moment où vous décidez de payer.
Vérifier la destination avant l'envoi quand le prestataire le permet. Wise, par exemple, n'accepte pas l'adresse e-mail seule sur toutes les destinations : sur certaines, il faut les coordonnées bancaires. Autant le savoir avant d'envoyer.
Un seuil minimum. Envoyer de très petits montants produit surtout des frais et des retours.

La question à poser

À une plateforme d'affiliation, ou à celui qui écrit la vôtre :

Que se passe-t-il, précisément, trente jours après qu'un versement PayPal est parti vers une adresse sans compte confirmé ?

Si la réponse commence par « on regarde dans PayPal », le travail n'est pas fait. Il devrait commencer par « vous recevez un e-mail, le solde de l'affilié est rétabli, et un avoir a annulé la facture ».

Meritt fait ce que cet article décrit.

Suivi sur votre propre domaine, attribution au clic et à l'identité, versements depuis vos comptes PayPal et Wise, factures et avoirs générés. 0, 49 ou 99 $ par mois, jamais un pourcentage.

Créer mon programme Voir le produit