Skip to main content
Les affiliés perçoivent des commissions sur les ventes qu’ils apportent. Le flux de l’API comporte deux parties : créer une fiche d’affilié, puis ajouter des règles spécifiques (overrides) qui définissent la commission.

Fonctionnement de l’attribution

  1. Vous créez une fiche d’affilié pour un utilisateur, puis vous ajoutez des overrides. Chaque override renvoie les champs product_direct_link et checkout_direct_link. Ce sont les URL de parrainage que l’affilié partage (elles contiennent ?a=<username>).
  2. Un acheteur utilise le lien. Whop enregistre le cookie d’affiliation (fenêtre d’attribution de 30 jours par défaut).
  3. L’acheteur passe commande pendant cette fenêtre. L’override correspondant calcule la commission : standard (par variante, en pourcentage ou en montant fixe) ou rev_share (pourcentage du chiffre d’affaires, pour un produit précis ou pour tout le compte).
  4. Whop attribue la commission à l’affilié et la reflète dans le champ total_referral_earnings_usd de 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)

Règles de 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 pas commission_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 champ total_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.