Skip to main content
Affiliates verdienen commissie op doorverwezen verkopen. De API-flow bestaat uit twee delen: maak een affiliaterecord aan en voeg daarna overrides toe die de commissie bepalen.

Hoe attributie werkt

  1. Je maakt een affiliaterecord aan voor een gebruiker en voegt daarna overrides toe. Elke override retourneert de velden product_direct_link en checkout_direct_link. Dit zijn verwijzings-URL’s die de affiliate deelt (ze bevatten ?a=<username>).
  2. Een koper gebruikt de link. Whop slaat de affiliatecookie op (standaard een attributievenster van 30 dagen).
  3. De koper rekent af binnen het venster. De bijbehorende override berekent de commissie: standard (per variant, percentage of vast bedrag) of rev_share (percentage van de omzet, per product of voor het hele account).
  4. Whop kent de commissie toe aan de affiliate en verwerkt die in het veld total_referral_earnings_usd van de override.
Terugbetalingen draaien commissies terug. Als een koper binnen het venster een terugbetaling krijgt, worden de verdiensten van de affiliate op die verkoop automatisch teruggevorderd.
Affiliates hebben een Whop-account nodig om uitbetalingen te ontvangen. Verdiensten worden op het record opgebouwd. Uitbetalingen gaan naar hun accountsaldo via transfers. Hebben ze nog geen account, onboard ze dan met inschrijving van subaccounts.

Een affiliate aanmaken

user_identifier wordt flexibel herleid. Geef een gebruikersnaam, e-mailadres, gebruikers-ID of Discord-ID mee. Als er al een affiliaterecord bestaat voor de combinatie van account en gebruiker, retourneert Whop het bestaande record (idempotent).

Commissie-overrides toevoegen

Een affiliaterecord bepaalt zelf geen commissie. Voeg overrides toe om te bepalen wat de affiliate betaald krijgt.

Standard (per variant)

Regels voor commission_value:
  • "percentage": geheel getal van 1–100 (40 = 40%).
  • "flat_fee": bedrag in dollars (10 = $10).
applies_to_payments:
  • "first_payment": de affiliate verdient alleen aan de eerste aankoop.
  • "all_payments": de affiliate verdient ook aan elke terugkerende betaling.

Rev-share (omzetpercentage)

Rev-share-overrides zijn altijd gebaseerd op een percentage. Geef geen commission_type: "flat_fee" mee.

Overrides beheren

Affiliates beheren

Affiliate-instellingen op accountniveau

Drie accountvelden bepalen hoe Whop het affiliateprogramma aan gebruikers presenteert. Werk ze bij via de Account-resource.

Verdiensten bijhouden

Elke override bevat een veld total_referral_earnings_usd met de cumulatieve verdiensten (in Amerikaanse dollars) voor die specifieke override. Haal de override opnieuw op (of vraag de lijst met overrides van een affiliate op) om het actuele totaal te krijgen.
Er is geen aparte affiliate.*-webhook in v1, en het openbare payment-schema toont geen koppeling met affiliates. Poll affiliates.overrides.list volgens je uitbetalingsschema en vergelijk de nieuwste waarden van total_referral_earnings_usd met de laatst opgeslagen waarden.

Responsvelden van overrides

Volgende stappen

Verdiensten van affiliates uitbetalen

Maak opgebouwde commissies over van je saldo naar affiliate-accounts.

Betalingen accepteren

Checkoutconfiguraties kennen verkopen automatisch toe wanneer verwijzingscookies zijn ingesteld.

Naar webhooks luisteren

Gebruik payment.succeeded voor algemene verkooptelemetrie. Voor affiliate-attributie moet je nog steeds pollen.

API-referentie voor affiliates

Volledige resource. Endpoints, velden en override-schema’s.