Introduction
Intégrer un marchand va bien au‑delà d’un simple formulaire : il faut fournir les produits, configurer le tracking, valider les conversions et définir les règles de commission. Affilentra relie ces étapes dans une instance self‑hosted où opérateurs, marchands et partenaires ont des rôles séparés. Cet article montre concrètement comment configurer les webhooks, les règles de validation et les commandes de test automatisées dans Affilentra (PRO & NETWORK) afin que les marchands soient intégrés rapidement, en toute sécurité et sans erreur dans votre réseau de partenaires.
Pourquoi un onboarding piloté par webhooks ?
Les webhooks permettent d’intégrer les systèmes externes (boutique, ERP, prestataire de paiement) de manière événementielle dans Affilentra. Plutôt que d’effectuer des saisies manuelles ou des importations planifiées, vous réagissez immédiatement aux événements pertinents comme la création d’un marchand, les mises à jour de produits ou les événements de commande. Combinés à des validations automatisées et à des commandes de test, cela réduit le taux d’erreur, raccourcit les délais de traitement et améliore la traçabilité pour les marchands et les partenaires.
Étapes préparatoires (checklist avant la mise en œuvre technique)
- Installer une instance Affilentra self‑hosted (PRO ou NETWORK).
- Vérifier : HTTPS, accès pour les opérateurs logiciels et les administrateurs, environnement PHP/MySQL à jour.
- Clarifier les informations disponibles sur le marchand : URL de la boutique, accès API, catalogue produits, modèles de commission souhaités.
- Définir quels événements doivent déclencher des webhooks (p. ex. merchant.created, product.updated, order.created, order.status_changed).
- Esquisser les rôles et les droits : quelles actions les marchands, partenaires et opérateurs sont autorisés à effectuer.
Configuration des webhooks dans Affilentra
Affilentra offre, dans PRO & NETWORK, la possibilité de configurer des webhooks pour des événements globaux et spécifiques aux marchands. Procédez comme suit :
- Créer un point de terminaison webhook : Enregistrez un nouveau webhook dans l’espace admin et renseignez l’URL cible du système externe.
- Sélection des événements : Choisissez précisément les événements, p. ex. merchant.created, merchant.updated, product.synced, order.created. Limitez la sélection à l’essentiel pour réduire le trafic.
- Configurer la sécurité : Activez les signatures HMAC avec un secret partagé. Affilentra signe les payloads, les systèmes externes vérifient la signature avant traitement.
- Stratégie de retry : Définissez le nombre de tentatives de réessai et la stratégie de backoff afin que les pannes temporaires n’entraînent pas de perte de données.
- Idempotence : Utilisez des IDs d’événement uniques dans le payload pour permettre aux récepteurs de détecter les répétitions et d’éviter les traitements en double.
Remarques pratiques
Documentez la structure de payload attendue pour votre équipe boutique ou ERP. Les champs usuels sont merchant_id, shop_url, products (avec SKU, prix, disponibilité) et signatur_meta. Des noms de champs clairs et des types de données réduisent les échanges nécessaires.
Règles de validation : configurer les règles de champ et métier
Les règles de validation protègent votre réseau contre des données erronées ou incomplètes. Affilentra permet des contrôles configurables à plusieurs niveaux :
- Contrôles de schéma : champs obligatoires, types de données et limites de longueur (par exemple shop_url doit être un HTTPS valide, SKU ne doit pas être vide).
- Règles métier : exemple : les types de commission doivent correspondre aux produits, les méthodes de paiement choisies doivent être activées pour le marchand.
- Validation contextuelle : règles qui s'appliquent uniquement à certaines catégories de marchands ou marchés (par exemple valeur minimale de conversion pour certains programmes partenaires).
Implémentez les validations comme partie intégrante du processus de traitement des webhooks. En cas d'entrées incorrectes, Affilentra envoie automatiquement un retour aux systèmes sources (réponse webhook) et journalise le message d'erreur dans l'interface utilisateur pour les opérateurs et les marchands.
Commandes de test automatisées : valider le tracking et la logique de commission
Les commandes de test sont essentielles pour vérifier les parcours de tracking et les calculs de commission avant la mise en production d'un marchand. Voici comment vous devriez mettre en œuvre des commandes de test dans Affilentra :
- Activer le mode test : définissez pour le marchand un statut de test dans lequel les commandes sont marquées comme tests et n'entraînent pas de paiement réel.
- Payloads de simulation : créez des commandes de test standardisées couvrant différents scénarios : conversion réussie, annulation, remboursement partiel, rétrofacturation.
- Déclenchement automatisé : déclenchez des commandes de test via webhook depuis la boutique ou via l'API Affilentra. Les commandes de test doivent contenir les mêmes paramètres de tracking que les commandes en production (par ex. affiliate_id, campaign_id, click_id).
- Reporting et suivi : les commandes de test apparaissent dans l'historique des commandes avec le statut de validation et le calcul de commission, afin que marchands et opérateurs puissent détecter les écarts.
Mettez en place un court déroulé de test : envoyer une commande de test → vérifier la validation → contrôler le calcul de commission → réinitialiser la commande de test ou la passer en production si tout est correct.
Mappage des rôles et permissions
Un élément central de l'onboarding est la séparation claire des rôles. Affilentra distingue opérateur logiciel, marchand et partenaire. Configurez les rôles comme suit :
- Exploitant du logiciel : Accès complet à la configuration du système, à la gestion des webhooks, à la gestion des licences et aux règles de validation globales.
- Commerçant : Contrôle des produits, des prix, des supports publicitaires, des conditions et des webhooks spécifiques au commerçant ; consultation des règlements de commissions pour leurs propres programmes.
- Partenaire (éditeur/créateur) : Liens de suivi personnalisés, historique transparent des conversions et des paiements, accès aux supports publicitaires.
Les règles de mapping définissent quelles autorisations par défaut sont attribuées à un commerçant nouvellement créé. Dans PRO & NETWORK, vous pouvez créer des modèles qui sont attribués automatiquement avec les événements webhook (p. ex. catégorie de commerçant A → certain modèle de commission + accès API restreint).
Pipeline d'onboarding de bout en bout : exemple de déroulement
Un déroulement automatisé typique avec Affilentra ressemble à ceci :
- La boutique envoie merchant.created → Affilentra crée le commerçant et vérifie les données de base (vérifications de schéma).
- Affilentra déclenche merchant.validation_failed/merchant.validation_passed vers le système de la boutique et l'exploitant.
- En cas de réussite du contrôle, des synchronisations de produits sont lancées via product.synced ; les règles de validation pour les produits s'exécutent.
- Des commandes de test sont générées automatiquement (order.created avec test_flag) ; le suivi et la logique de commission sont vérifiés.
- Après un test réussi, le commerçant obtient le statut Live ; les partenaires reçoivent des liens de suivi personnalisés et peuvent lancer des campagnes.
Supervision, journaux et gestion des erreurs
Utilisez la journalisation dans Affilentra : les événements webhook, les erreurs de validation et les commandes de test doivent être visibles dans le tableau de bord. Définissez des règles d'alerte pour les erreurs récurrentes (p. ex. échecs de synchronisation de produits) et établissez des règles d'escalade vers l'exploitant.
Exemple pratique : démarrage rapide pour un nouveau commerçant
Déroulement concret en quelques étapes :
- Envoyer les données du commerçant via le webhook merchant.created à Affilentra.
- Affilentra valide les champs obligatoires ; en cas de données manquantes, l'API de la boutique reçoit un objet d'erreur détaillé en retour.
- Après des contrôles réussis, les données produits sont synchronisées et une série de commandes de test est générée automatiquement.
- Les résultats des tests sont affichés dans le portail commerçant ; l'exploitant vérifie la mise en ligne et passe le commerçant en Live.
- Les partenaires reçoivent automatiquement des liens de suivi pour le nouveau programme commerçant et voient les conversions de test ainsi que les conversions Live dans leur historique.
Conclusion et recommandations
L'onboarding piloté par webhook réduit les tâches manuelles et permet des processus transparents et reproductibles. Avec Affilentra, vous assurez que les règles de validation et les commandes de test sont des composants intégrés de l'onboarding — et que les rôles restent clairement séparés. Concrètement, cela signifie : moins d'erreurs de comptabilisation, un time-to-market plus rapide et des paiements traçables pour toutes les parties prenantes.
Prochaine étape : Vérifiez votre check‑list d'onboarding, définissez les événements webhook nécessaires et créez des commandes de test standardisées. Si vous souhaitez utiliser Affilentra, choisissez l'accès adapté à votre organisation.
Prochaine étape
Essayer Affilentra
Plateforme unifiée qui rassemble de manière transparente la mise à disposition des produits, le tracking, la validation des conversions, le calcul des commissions et le paiement selon des rôles clairement séparés ; option d'installation self-hosted avec licence perpétuelle sans participation au chiffre d'affaires ; les marchands conservent le contrôle sur les produits, les conditions et les supports publicitaires ; les partenaires reçoivent des liens de tracking personnels et un historique des paiements traçable.