Fonctionnement de l’attribution
- Vous créez une fiche d’affilié pour un utilisateur, puis vous ajoutez des overrides. Chaque override renvoie les champs
product_direct_linketcheckout_direct_link. Ce sont les URL de parrainage que l’affilié partage (elles contiennent?a=<username>). - Un acheteur utilise le lien. Whop enregistre le cookie d’affiliation (fenêtre d’attribution de 30 jours par défaut).
- L’acheteur passe commande pendant cette fenêtre. L’override correspondant calcule la commission :
standard(par variante, en pourcentage ou en montant fixe) ourev_share(pourcentage du chiffre d’affaires, pour un produit précis ou pour tout le compte). - Whop attribue la commission à l’affilié et la reflète dans le champ
total_referral_earnings_usdde l’override.
Les remboursements annulent les commissions. Si un acheteur est remboursé pendant la fenêtre, le gain de l’affilié sur cette vente est automatiquement récupéré.
Les affiliés ont besoin d’un compte Whop pour recevoir leurs versements. Les gains s’accumulent sur la fiche. Les versements sont crédités sur le solde de leur compte via des transferts. S’ils n’ont pas encore de compte, intégrez-les via l’inscription de sous-comptes.
Créer un affilié
user_identifier se résout de manière flexible. Transmettez un nom d’utilisateur, une adresse e-mail, un ID utilisateur ou un ID Discord. Si une fiche d’affilié existe déjà pour la paire compte/utilisateur, Whop renvoie la fiche existante (idempotent).
Ajouter des overrides de commission
Une fiche d’affilié ne définit pas de commission à elle seule. Ajoutez des overrides pour déterminer la rémunération de l’affilié.Standard (par variante)
commission_value :
"percentage": nombre entier de 1 à 100 (40= 40 %)."flat_fee": montant en dollars (10= 10 $).
applies_to_payments :
"first_payment": l’affilié est rémunéré uniquement sur l’achat initial."all_payments": l’affilié est aussi rémunéré sur chaque paiement récurrent.
Rev-share (pourcentage du chiffre d’affaires)
Les overrides de partage de revenus sont toujours exprimés en pourcentage. Ne transmettez pascommission_type: "flat_fee".
Gérer les overrides
Gérer les affiliés
Paramètres d’affiliation au niveau du compte
Trois champs du compte déterminent la façon dont Whop présente le programme d’affiliation aux utilisateurs. Mettez-les à jour via la ressource Account.Suivi des gains
Chaque override comprend un champtotal_referral_earnings_usd qui reflète les gains cumulés (en dollars américains) pour cet override précis. Récupérez à nouveau l’override (ou listez les overrides d’un affilié) pour obtenir le total actuel.
Il n’existe pas de webhook
affiliate.* dédié en v1, et le schéma public payment n’expose pas le lien avec l’affilié. Interrogez affiliates.overrides.list selon votre calendrier de versements et comparez les dernières valeurs de total_referral_earnings_usd avec celles que vous avez enregistrées précédemment.Champs de réponse d’un override
Étapes suivantes
Verser les gains des affiliés
Transférez les commissions accumulées de votre solde vers les comptes des affiliés.
Accepter des paiements
Les configurations de paiement attribuent automatiquement les ventes lorsque des cookies de parrainage sont définis.
Écouter les webhooks
Utilisez
payment.succeeded pour la télémétrie générale des ventes. L’attribution aux affiliés reste basée sur l’interrogation périodique.Référence de l'API Affiliates
La ressource complète : endpoints, champs et schémas d’override.

