Parrainages et referrals entre apps

Configurer, associer et suivre les relations referrer ↔ referral entre applications

Gérez les parrainages entre applications pour le tracking et la bonification — associez des apps, envoyez des invitations, suivez les statuts et créditez automatiquement.

Ce guide décrit comment configurer et exploiter les relations de parrainage entre applications (referrer ↔ referral). Vous y trouverez des instructions pas-à‑pas pour :

associer deux applications comme referrer et referral depuis l’administration ;
envoyer des invitations, copier des liens ou générer des QR codes ;
accepter un code de parrain (côté filleul) ;
suivre les statuts et gérer le crédit associé ;
bonnes pratiques (validation de domaines, profils collaborateurs) et pièges à éviter.

Ce que vous pouvez faire

Associer des apps

Créer une relation de parrainage entre une application « referrer » (celle qui parraine) et une application « referral » (celle qui est parrainée).

Envoyer invitations & liens

Partager l’invitation par email, copier un lien de parrainage ou générer un QR code pour diffusion.

Suivi des statuts

Visualiser l’historique des invitations, les statuts (envoyé, activé, validé, annulé) et le solde de crédits.

Bonification automatique

Créditer automatiquement le parrain selon les règles (ex. crédit après dépense du filleul).

Contrôle d'accès

Limiter l’accès des collaborateurs partenaires via des politiques de profil (profile policies).

Validation domaines

Recommande la validation des domaines pour éviter les fraudes et garantir le bon routage des invites.

Commencez par définir la politique métier

Avant d’associer des apps, clarifiez la règle de bonification (montant, condition d’activation, durée) et documentez-la pour que les équipes support et opérations sachent quand créditer.

Étapes principales — vue d’ensemble

Administration : associer referrer ↔ referral (workflow d’association).
Sponsor : envoyer invitation, copier lien, générer QR.
Filleul : accepter le parrainage via code ou lien.
Suivi : vérifier statuts, gérer crédits et résoudre les cas particuliers.
Gouvernance : valider domaines, config partenaires et restreindre accès collaborateurs.

Workflow 1 — Associer deux applications (Admin)

Associer une app referrer et une app referral (Admin > Parrainages)

Étape 1 — Ouvrir la section Parrainages

Connectez-vous en tant qu’administrateur, ouvrez le menu Administration, puis choisissez “Parrainages”.

Étape 2 — Créer une nouvelle association

Cliquez sur “Nouvel association” ou “Associer des apps”. Donnez un nom lisible à la relation (ex. “AppA → AppB”).

Étape 3 — Sélectionner le referrer

Choisissez l’application qui fera le parrain (referrer). Vérifiez l’identifiant affiché et la description pour éviter les confusions entre environnements (prod / staging).

Étape 4 — Sélectionner le referral

Choisissez l’application parrainée (referral). Confirmez la correspondance des domaines et des informations de contact du partenaire.

Étape 5 — Paramétrer la bonification

Indiquez le type et le montant du bonus (ex. 50 € crédit pour le parrain, 30 € réduction pour le filleul), la condition d’activation (ex. dépense minimale, période) et la durée de validité.

Étape 6 — Ajouter des métadonnées partenaires

Si le partenaire nécessite une configuration particulière (par ex. paramètres sérialisés ou options spécifiques), ajoutez-les dans la zone “Configuration partenaire” et notez la documentation associée.

Étape 7 — Valider les domaines recommandés

Saisissez les domaines autorisés pour les invitations et activez la validation de domaine si disponible afin de garantir que les liens/QR pointent vers des domaines de confiance.

Étape 8 — Enregistrer et tester

Enregistrez l’association. Effectuez un test complet : envoyez une invitation test, activez-la côté filleul et vérifiez l’attribution du crédit dans le tableau de suivi.

Nommer clairement les associations

Utilisez un format de nom normalisé (ex. “referrerApp → referralApp - production”) pour éviter d’associer par erreur des environnements de test en production.

Workflow 2 — Envoyer une invitation / partager un lien (côté referrer)

Envoyer une invitation email, copier le lien ou générer un QR code

Étape 1 — Accéder au panneau Parrainage

Depuis l’interface de l’application parrainante, ouvrez la page Parrainage / Invitations.

Étape 2 — Préparer l'invitation

Saisissez l’email du destinataire ou choisissez l’option “Copier le lien” / “Générer QR code” si vous préférez partager autrement.

Pour l’email : vérifiez la syntaxe (caractères autorisés, domaine).
Pour le lien : vérifiez l’URL affichée (doit contenir l’identifiant du referrer).
Pour le QR : prévisualisez puis téléchargez ou copiez.

Étape 3 — Envoyer et suivre

Envoyez l’email. L’invitation apparaîtra ensuite dans la liste “Entreprises parrainées” avec un statut initial (ex. envoyé).

Étape 4 — Actions complémentaires

Vous pouvez copier le lien dans le presse-papier, télécharger le QR code (ou le copier), ou transmettre directement le code de parrainage si fourni.

Étape 5 — Vérifier la réception et le statut

Surveillez le tableau des invitations pour voir les transitions de statut (envoyé → activé → validé / annulé).

Utilisez le QR pour les salons ou documents imprimés

Le QR code est pratique sur supports physiques (flyers, stands, cartes). Vérifiez que la page d’atterrissage gère correctement le paramètre de parrainage.

Workflow 3 — Accepter un parrainage (côté filleul)

Valider un code parrain ou suivre un lien de parrainage

Étape 1 — Recevoir l'invitation

Le filleul reçoit l’invitation par email, lien ou QR. Il peut cliquer sur le lien ou scanner le QR pour accéder à l’inscription/page d’abonnement.

Étape 2 — Entrer le code parrain (si fourni)

Sur la page d’abonnement ou dans le champ “Code parrain”, saisir le code communiqué par le parrain puis cliquer sur “Valider”.

Étape 3 — Vérifier la confirmation

Après validation, le filleul doit voir un message confirmant la réduction immédiate (ex. -30 €) ou l’activation du parrainage.

Étape 4 — Compléter l'inscription / abonnement

Finaliser l’inscription ou souscrire à l’abonnement. Respectez les conditions (si la bonification du parrain dépend d’un seuil de dépense, informez‑en le filleul).

Étape 5 — Suivi côté parrain

Le parrain voit le statut du filleul changer dans sa liste (ex. pending → validated) et le crédit s’ajoute selon la règle définie.

Codes invalides ou expirés

Un code parrain peut être périmé ou mal saisi. Si le code n’est pas accepté : vérifier la longueur, les caractères, et la période de validité ; demandez au parrain de renvoyer l’invitation ou de générer un nouveau code.

Workflow 4 — Suivi, statuts et gestion des crédits

Consulter l'historique, interpréter les statuts et gérer les crédits

Étape 1 — Ouvrir la liste des parrainages

Accédez à la page « Liste des entreprises parrainées » depuis le menu Parrainages.

Étape 2 — Lire les statuts

Les statuts courants :

sent / envoyé : invitation envoyée, pas encore activée ;
pending / activé : filleul a activé, condition de validation en attente (ex. délai ou dépense) ;
validated / validé : conditions remplies, crédit appliqué ;
cancelled / annulé : parrainage refusé ou annulé. Interprétez chaque statut et communiquez-le aux parties concernées.

Étape 3 — Vérifier le solde crédit

Consultez le solde de crédit affiché (ex. “Votre solde de crédit Sinao : 50 €”). Ce montant est généralement appliqué automatiquement à la prochaine facture.

Étape 4 — Historique détaillé & justificatifs

Pour un cas particulier, ouvrez la ligne correspondante pour voir la date d’invitation, l’email/entreprise, derniers changements et tout justificatif lié.

Étape 5 — Corriger les erreurs

Si un statut reste bloqué ou un crédit manque : vérifiez les conditions définies (montant minimum, date), contactez le support partenaire ou utilisez la fonction administrative pour forcer l’état après vérification.

Étape 6 — Reporting périodique

Exportez ou relevez périodiquement la liste des parrainages pour contrôle financier et rapprochement des crédits appliqués sur les factures.

Conservez la traçabilité

Lorsqu’un crédit est appliqué manuellement (exception), enregistrez la justification et la référence pour la réconciliation comptable future.

Workflow 5 — Gestion des collaborateurs partenaires (profile policies)

Limiter l'accès des collaborateurs partenaires

Étape 1 — Identifier les rôles

Déterminez quels collaborateurs ont besoin d’accéder aux paramètres de parrainage (ex. marketing, support, finance).

Étape 2 — Créer une politique de profil

Dans la gestion des profils, créez une politique qui limite l’accès à :

visualisation des parrainages ;
envoi d’invitations ;
modification des règles de bonification (réservée aux admins).

Étape 3 — Assigner les collaborateurs

Associez les utilisateurs concernés à la politique appropriée. Testez avec un compte de test pour s’assurer que les permissions sont correctes.

Étape 4 — Revue périodique

Passez en revue les accès régulièrement (mensuellement ou trimestriellement) pour retirer les droits devenus inutiles.

Révocation d'accès importante

Ne laissez pas de droits d’administration relatifs aux parrainages à des comptes qui quittent l’entreprise sans les révoquer — des modifications non autorisées peuvent impacter crédits et finances.

Scénarios et approches (différences selon cas d’usage)

Usage typique pour une intégration directe entre deux apps (ex. SaaS A parraine SaaS B).

Association directe et règles fixes.
Bon pour petits partenariats.

Comparaison : validation de domaine vs pas de validation

Validation de domaine activée

Empêche le détournement de liens.
Garantit l’origine des invitations.
Recommandé pour programmes publics et volumineux.

Sans validation de domaine

Déploiement initial plus rapide.
Risque plus élevé de fraude ou d’usurpation.
À éviter pour programmes à forte valeur monétaire.

Cas particuliers et bonnes pratiques (edge cases)

Parrain supprimé ou application désactivée : prévoir une règle de migration (transférer le parrainage ou annuler et rembourser).
Multi‑parrainage : définir si un filleul peut changer de parrain ou si le premier contact prime.
Doublons d’email : vérifier l’unicité par adresse email et/ou entreprise pour éviter crédits multiples.
Délais et seuils : documenter clairement la condition d’activation (ex. “le filleul doit avoir dépensé au moins X € dans Y mois”).
Configuration sérialisée partenaire : si un partenaire a des options complexes, documentez chaque paramètre et effectuez une recette avant mise en production.

Documentez les exceptions

Créez une fiche interne listant les cas exceptionnels (annulation, litige, remboursement) et le workflow de résolution pour les équipes support et finances.

FAQ — Questions fréquentes

Frequently Asked Questions

Récapitulatif rapide — checklist avant lancement

[ ] Nommer clairement les associations referrer ↔ referral.
[ ] Définir et documenter la règle métier de bonification.
[ ] Activer la validation de domaines si disponible.
[ ] Tester l’envoi d’invitation, l’acceptation du code et l’application du crédit en environnement de pré-production.
[ ] Attribuer des profile policies aux collaborateurs et planifier une revue régulière des accès.
[ ] Mettre en place un tableau de suivi pour la réconciliation comptable.

Besoin d'aide ?

Si vous rencontrez un comportement inattendu (statut bloqué, crédit manquant, lien mal routé), suivez d’abord la checklist de vérification (domaines, règles, doublons), puis contactez le support avec : identifiant du referrer, identifiant du filleul, date de l’invitation et capture d’écran du statut.

Configurer vos premiers parrainages

Créez votre première association referrer ↔ referral et lancez un test complet avant diffusion.

Collaborateurs partenaires

Coupons et secrets clients