Retour au blog
Affiliation•7 min de lecture

Éditeurs : envoyer un contact par API et lire chaque refus

Un identifiant, une clé, un appel. Ce qui se passe ensuite côté régie, pourquoi un contact est refusé, et comment le paiement se suit sans discussion.

IOD

La rédaction IOD

10 septembre 2026

Éditeurs : envoyer un contact par API et lire chaque refus

Temps de lecture estimé

7 min • Article complet

Vous avez un site, une newsletter ou une audience qui se pose des questions sur son argent. Vous aimeriez transmettre à un professionnel les personnes qui demandent à être rappelées, et être payé pour cela. La mécanique est simple. Ce qui fait la différence entre une régie et une autre, c’est ce que vous voyez après l’envoi.

L’envoi

Vous recevez un identifiant et une clé secrète. Votre formulaire, ou votre serveur, nous envoie le contact en un seul appel : prénom, nom, téléphone, adresse e-mail, pays, consentement, et la campagne concernée. La documentation tient sur une page.

La clé fait deux choses. Elle prouve que l’envoi vient bien de vous, et elle impose votre identifiant sur le contact. Vous ne pouvez pas envoyer un contact au nom d’un autre éditeur, et personne ne peut en envoyer au vôtre.

La réponse arrive dans la foulée : accepté, ou refusé avec un motif. Pas de file d’attente silencieuse.

Les motifs de refus

Un contact refusé n’est pas un contact perdu. Il apparaît dans votre espace, avec la raison, le jour même. Les motifs sont en nombre limité.

MotifCe que cela veut dire
Numéro invalideLe numéro n’est pas composable dans le pays indiqué
Adresse invalideL’adresse e-mail n’a pas un format correct
DoublonCe contact a déjà été reçu ; il est gardé, marqué « réinscrit », non facturé
Pays hors campagneLa campagne n’accepte pas ce pays
Champ manquantUn champ exigé par l’annonceur est vide
Plafond atteintLa campagne a un maximum de contacts par jour, et il est atteint
Hors plage horaireLa campagne n’accepte des contacts qu’à certaines heures

Chaque motif correspond à une condition écrite dans la campagne. Vous pouvez donc corriger votre formulaire, ou retenir un contact plutôt que de l’envoyer pour rien.

Les conditions, fixées une fois

Au moment où une campagne est créée, ses conditions sont écrites : prix par contact, pays acceptés, plafond éventuel, champs obligatoires, plage horaire, et si les doublons sont déduits ou non. Elles ne changent pas en cours de route.

Nous avons choisi que ces conditions soient réglées par campagne et non par éditeur, parce qu’un même éditeur peut travailler sur plusieurs annonceurs aux exigences différentes. Vous voyez les conditions de chaque campagne dans votre espace avant d’envoyer le premier contact.

Ce que nous refusons d’entrée

Les bases achetées. Les formulaires qui promettent un cadeau ou un gain pour obtenir un numéro. Les pages qui ne disent pas qu’un professionnel va rappeler.

Ce n’est pas une question de morale abstraite. Un contact qui ne s’attend pas à l’appel raccroche, l’annonceur le signale, et c’est votre taux de contacts utiles qui baisse. Un formulaire honnête rapporte moins de contacts par jour et plus de contacts payés.

Le paiement

Votre espace affiche ce qui vous est dû, ce qui a été payé et à quelle date. Avant chaque règlement, vous voyez la liste des contacts retenus et la liste des contacts écartés, avec le motif de chacun.

Deux modes existent selon l’éditeur : paiement après coup, ou prépaiement. Dans le second cas, votre solde se lit en permanence et une alerte part quand il approche de zéro.

Nous ne faisons pas de virement automatique. Un humain regarde le relevé, et le règlement part. Mais le relevé, lui, est le même que celui que vous avez sous les yeux.

Le retour de l’annonceur

L’annonceur nous renvoie ce que devient chaque contact : rappelé, injoignable, faux numéro, converti. Vous voyez ces statuts sur vos propres contacts.

C’est utile pour vous autant que pour nous. Si une page de votre site envoie beaucoup de faux numéros, vous le saurez avant la facture, pas après. Si une autre envoie des contacts qui aboutissent, vous saurez laquelle mettre en avant.

Pour commencer

Un échange suffit pour ouvrir un accès et vous donner la documentation. Les premiers contacts se font en mode test, sans facturation ni transmission, le temps de vérifier que votre envoi est bien formé. La page Éditeurs et affiliés décrit les étapes.

Partager :
Affiliation
IOD

La rédaction IOD

Les articles de ce blog sont écrits par l'équipe d'IOD, régie de médias spécialisée dans la finance personnelle et le placement.

Une question sur ce sujet ?

Écrivez-nous : la personne qui vous répond est celle qui fait tourner l'outil.