Objectif : Accepter / refuser des conversions et ajuster un montant automatiquement
Avant de pouvoir automatiser la gestion de vos conversions, assurez-vous de disposer de :
➜ Votre clé API annonceur (jeton d’authentification).
➜ L’URL de base de l’API : https://rest.affilae.com.
➜ Les droits d’accès nécessaires à votre programme.
Documentation de notre API : https://rest.affilae.com/reference
Toutes les requêtes doivent inclure l’en-tête :
➜ Authorization: Bearer {YOUR_TOKEN}
➜ Les montants envoyés ou reçus sont exprimés en centimes (ex: « 100 » = « 1.00 € »).
➜ Les dates sont en UTC
Récupérer l’ID d’une conversion
Avant d’accepter, refuser ou modifier une conversion, vous devez identifier son ID interne Affilae.
Deux méthodes sont possibles :
1. Lister vos conversions
Utilisez l’endpoint GET /advertiser/conversions.list pour obtenir la liste de vos conversions.
Vous pouvez filtrer par :
➜ statut (« pending », « accepted », « refused »),
➜ période (« from », « to »),
➜ identifiant client (« customerId »),
➜ ou identifiant externe (« externalId »).
2. Obtenir les détails d’une conversion
Utilisez GET /advertiser/conversions.info si vous connaissez déjà l’identifiant externe ou le client.
Cette route renvoie toutes les informations liées à la conversion, dont son ID interne Affilae.
Accepter ou refuser une conversion
Une fois l’ID connu, vous pouvez automatiser les décisions de validation.
Accepter une conversion
Utilisez POST /advertiser/conversions.accept.
Cette route permet de valider la conversion et de la marquer comme « acceptée« .
Champs requis :
➜ « program » : l’identifiant du programme annonceur
➜ « id » : l’identifiant interne de la conversion
Refuser une conversion
Utilisez POST /advertiser/conversions.refuse.
Cette route permet de refuser une conversion (ex : retour produit, fraude, test, etc.).
Champs requis :
➜ « program » : identifiant du programme
➜ « id » : identifiant interne de la conversion
➜ « reason » : motif du refus
Ajuster le montant d’une conversion (retour panier)
Dans le cas d’un retour produit ou d’un ajustement de panier, vous pouvez modifier le montant d’une conversion en attente.
Utilisez POST /advertiser/conversions.update.
Conditions :
➜ La conversion doit être en statut « en attente ».
➜ Le montant ajusté doit être inférieur au montant initial.
➜ Le montant n’a pas été modifié.
Champs requis :
➜ « id » : identifiant interne de la conversion
➜ « amount » : nouveau montant (en centimes)
➜ « reason : raison de l’ajustement (ex : retour partiel panier)
Récapitulatif des routes :
➜ Lister les conversions | GET : /advertiser/conversions.list
➜ Obtenir une conversion | GET : advertiser/conversions.info
➜ Accepter une conversion | POST : /advertiser/conversions.accept
➜ Refuser une conversion | POST : /advertiser/conversions.refuse
➜ Ajuster un montant | POST : /advertiser/conversions.update
Bonnes pratiques
➜ Conservez la correspondance entre vos commandes (externalId) et les IDs Affilae pour éviter les doublons.
➜ Stockez votre clé API de manière sécurisée et ne la partagez pas.
➜ Réalisez vos tests sur un petit volume de conversions avant déploiement global.
➜ L’API impose des limites de débit (rate limit). Pensez à les gérer dans vos appels.
➜ Conservez les logs de vos appels pour faciliter le suivi et le support.
Besoin d’aide ?
Notre équipe support est disponible via votre interface annonceur pour toute assistance technique.
Partager :