Introduction
Pour les commerçants proposant des produits en abonnement, une représentation correcte des commissions récurrentes détermine la transparence, les paiements et la confiance des partenaires. Affilentra Pro combine une solution d'affiliation self‑hosted avec les programmes des commerçants et offre des rôles, du suivi ainsi que des fonctions de commission et de facturation. Ce guide montre de manière pratique comment suivre dans Affilentra les événements d'abonnement, configurer des règles de commission récurrente, traiter correctement la proratisation lors d'un changement de forfait et facturer les bonus de churn ou de rétention.
1. Créer les bases : rôles, produit et identifiants de suivi
Avant de créer des règles, vérifiez ces points de base :
- Créer les rôles : opérateur logiciel (Admin), commerçant (Merchant) et partenaire (Affiliate). Assurez-vous que les commerçants ont accès aux paramètres de leur programme.
- Créer le produit en tant qu'abonnement : dans Affilentra, attribuez à chaque produit d'abonnement un identifiant unique de produit/abonnement (Product/Subscription ID). Cet identifiant doit apparaître dans les événements de suivi afin que les paiements récurrents puissent être associés au bon produit/partenaire.
- Subscription‑ID dans la pile de paiement : assurez-vous que votre fournisseur de paiement inclut à chaque événement de prélèvement la Subscription‑ID, l'Invoice‑ID et l'identifiant de transaction.
2. Suivre les événements récurrents : de quels événements avez‑vous besoin ?
Au minimum, les événements suivants doivent être traités dans Affilentra :
- initial_sale (premier paiement / conversion d'essai)
- subscription_payment (paiement récurrent mensuel / annuel)
- subscription_proration (changement de forfait / crédit partiel)
- subscription_cancelled / subscription_expired
- payment_failed / chargeback / refund
En pratique, implémentez cela ainsi : votre fournisseur de paiement envoie des webhooks au point d'extrémité de suivi de la plateforme. Portez attention aux champs suivants dans le payload : subscription_id, transaction_id, amount, currency, event_type, timestamp, invoice_id, customer_id et, en cas de changement de forfait, également previous_plan / new_plan ainsi que prorated_amount ou proration_days.
3. Configurer les règles de commission récurrente
Structurez les commissions en trois niveaux : premier paiement, paiements suivants, bonus spéciaux.
- Premier paiement : définir une règle pour initial_sale (par ex. 30 % ou un montant fixe). Le paiement est effectué après validation de la conversion.
- Commissions mensuelles/annuelles : créez une règle récurrente qui se déclenche à chaque subscription_payment. La règle peut être un pourcentage (par ex. 10 % par prélèvement) ou un montant fixe (par ex. 5 €/mois).
- Gérer les dépendances : permettre des taux différents pour les conversions Trial→Paid, les upgrades ou les downgrades. Utilisez les métadonnées produit et forfait pour attribuer les règles de manière granulaire.
Remarques techniques : utilisez l'ID d'abonnement comme clé primaire pour l'attribution des partenaires. Lors de la première vente, enregistrez l'affectation du partenaire (par ex. via lien de suivi ou coupon) dans les métadonnées de l'abonnement, afin que les paiements suivants soient automatiquement attribués au bon partenaire.
4. Traiter correctement la proratisation lors d'un changement de forfait
Les changements de forfait génèrent souvent des montants partiels. Il existe deux approches pratiques pour le calcul de la commission :
- Basée sur le montant (recommandée) : la commission se calcule sur le montant effectivement facturé. Si le prestataire de paiement fournit un prorated_amount, le montant de la commission = prorated_amount × commission_rate.
- Basée sur le temps : si vous souhaitez calculer les commissions strictement selon le temps d'utilisation, vous aurez besoin de proration_days ou period_lengths. Exemple : Commission au prorata = (days_active / total_days) × period_commission.
Pour représenter correctement la proratisation, procédez ainsi :
- Le webhook de paiement pour les changements de forfait doit contenir prorated_amount et des informations sur previous_plan/new_plan.
- Dans Affilentra, créez une règle de traitement déclenchée lorsque event_type = subscription_proration et qui calcule la commission sur la base de prorated_amount.
- Configurez l'idempotence : vérifiez transaction_id et invoice_id pour éviter les doubles facturations.
Exemple de calcul : taux de commission 10 %, prorated_amount = 15,00 € → Commission = 1,50 €. Documentez dans l'historique des transactions la base (prorated_amount, previous_period, new_period) pour assurer la traçabilité.
5. Gestion du churn : rétrofacturations et bonus de rétention
Une gestion propre du churn comprend deux aspects : les clawbacks (rétrocessions) en cas d'annulation/remboursement et les incitations positives pour la rétention.
Clawbacks et ajustements
- En cas de refund, chargeback ou subscription_cancelled, Affilentra doit générer une écriture corrective : commission négative ou marqueur d'annulation.
- Politique : décidez si, lors d'un remboursement, seule la dernière commission est annulée ou si elle est répartie proportionnellement sur plusieurs périodes. Implémentez la règle comme une logique d'ajustement automatisée qui réagit aux événements de type refund.
Bonus de rétention
- Les bonus de rétention sont versés lorsqu'un partenaire contribue activement à la fidélisation du client (par ex. réactivation après intention d'annulation, upsell, intervention de support réussie).
- Mise en œuvre technique : définissez un événement déclencheur retention_success (manuel ou automatisé via votre CRM/support) qui déclenche un paiement de bonus. Le bonus peut être un montant fixe ou un pourcentage de la prochaine facture.
- Palier : versez des bonus échelonnés, par ex. petit bonus si le client reste >30 jours, bonus plus élevé si >90 jours.
6. Rapprochement, reporting et paiements
Mettez en place des processus de rapprochement réguliers :
- Exportez les listes de transactions avec Subscription‑ID, partenaire, type d'événement, montant, commission et statut (paid/adjusted/pending).
- Vérifiez les éléments ouverts : les paiements échoués et les demandes de remboursement en attente doivent être réglés avant le paiement.
- Utilisez la fonction de facturation d'Affilentra pour la création des postes de paiement. Définissez des cycles de paiement (mensuel, hebdomadaire) et fixez des seuils minimaux de paiement.
7. Tests et bonnes pratiques
- Environnement de test : simulez tous les événements webhook pertinents (initial_sale, subscription_payment, proration, refund, cancel) et vérifiez les résultats dans l'historique du partenaire.
- Idempotence : vérifiez les identifiants de transaction avant l'enregistrement afin d'éviter les doublons.
- Documentation : enregistrez les métadonnées (par ex. original_invoice_id, coupon, matériel promotionnel) pour des vérifications ultérieures.
- Transparence : fournissez aux partenaires un historique de paiement traçable (liens de suivi, périodes, déductions dues aux remboursements).
- Protection des données & conformité : veillez au stockage des données clients conformément au RGPD et pseudonymisez-les si possible.
Conclusion et étapes de mise en œuvre
Affilentra Pro fournit l'infrastructure nécessaire pour reproduire en self‑hosted la logique des abonnements, du prorata et du churn. Voici, en bref, les prochaines étapes :
- Créer les identifiants Produit/Subscription dans Affilentra et enregistrer l'affectation du partenaire lors du premier achat.
- Implémenter l'intégration webhook avec le fournisseur de paiement et envoyer tous les champs pertinents (notamment subscription_id, transaction_id, prorated_amount).
- Configurer les règles de commission pour le premier paiement et pour les paiements récurrents ; traiter les événements de prorata de sorte que les commissions se basent sur prorated_amount.
- Introduire et automatiser les ajustements liés au churn et les bonus de fidélisation en tant qu'événements déclenchés.
- Réaliser des tests approfondis et mettre en place le reporting / la réconciliation pour les paiements.
Si vous êtes prêt à exploiter votre programme d'affiliation pour les abonnements de manière sécurisée et transparente, choisissez votre point d'entrée : Einstieg wählen.
Prochaine étape
Essayer Affilentra soi‑même
Plateforme unifiée qui rassemble de façon transparente la mise à disposition des produits, le tracking, la validation des conversions, le calcul des commissions et le paiement, avec des rôles clairement séparés ; option d'installation self‑hosted avec licence perpétuelle sans partage de chiffre d'affaires ; les commerçants conservent le contrôle des produits, des conditions et des supports promotionnels ; les partenaires reçoivent des liens de suivi personnels et un historique de paiement consultable.