Skip to main content
Je verdient zolang de referral duurt, op vier afzonderlijke inkomstenbronnen. Eén aanroep schrijft je in en geeft je link terug. Al het andere rapporteert wat je hebt doorverwezen en wat je hebt verdiend.

Wat je kunt bouwen

  • Een referralprogramma dat je zelf runt, waarbij je je eigen link deelt met je eigen publiek.
  • Rapportage over wat je hebt doorverwezen: welke bedrijven en gebruikers nog actief zijn en wat elk ervan oplevert.
  • Overzichten van verdiensten, uitgesplitst tot op de transactie en het tarief achter elke regel.
  • Een openbare ranglijstpagina op basis van het partnerleaderboard.

Kernobjecten

Partner, doorverwezen bedrijf, partnerverdienste. Elk object wordt gedefinieerd in Kernconcepten.

Inschrijven

POST /partners schrijft de aanroepende gebruiker in en maakt diens partnerbedrijven in aanmerking voor verdiensten. De aanroep geeft referral_link terug, de URL die je deelt om erkend te worden, en whop_partner_enabled_at. Opnieuw inschrijven behoudt het oorspronkelijke inschrijvingsmoment in plaats van het te resetten, waardoor de aanroep veilig herhaald kan worden. Vereist de permissie partner:create. Voor het uitlezen van referrals en verdiensten is partner:basic:read nodig, en voor het weergeven van doorverwezen bedrijven wordt ook referral:basic:read geaccepteerd. Zie Permissies.

Waaraan je verdient

payout_percentages op een doorverwezen bedrijf geeft je tarief per inkomstenbron als fractie, dus 0.3 betekent 30%. Drie van de vier zijn een aandeel in de brutowinst van Whop. Advertentie-uitgaven vormen de uitzondering: dat is een aandeel in de uitgaven zelf. Bij een bedrijf dat voor een partnerbedrijf is binnengehaald, behoort dat tarief toe aan het team. GET /partners/businesses/:id geeft ook my_payout_percentages terug, jouw eigen deel van elk tarief. Dat is het volledige tarief wanneer je het bedrijf zelf hebt doorverwezen. Bij een deal van een partnerbedrijf is het jouw teamaandeel in het tarief. Een manager verdient zijn aandeel minus het aandeel van de persoon onder hem, en een deelnemer aan een deal verdient zijn deel. Het is null wanneer je niets aan het bedrijf verdient. GET /partners/businesses geeft alles weer wat je hebt doorverwezen, nieuwste eerst. Elk partnerbedrijf heeft een coma_-ID, een status van active of removed, en referral_started_at en referral_expires_at. earnings_usd en volume_usd zijn objecten in plaats van losse getallen. earnings_usd splitst zich op in completed, pending en total. volume_usd splitst zich op in attributed, awaiting_settlement en settled.

Verdiensten uitlezen

GET /partners/businesses/{id}/earnings specificeert wat Whop je voor één bedrijf betaalt. Elke verdienste vermeldt de income_source, het transaction_amount_usd waaruit ze voortkomt en je payout_percentage. Verdiensten worden eerst verrekend voordat ze worden uitbetaald. Zowel commission_amount_usd als payout_percentage zijn null totdat dat gebeurt. Waar de gegevens bestaan, splitst financial_activity de inkomsten- en kostenregels achter de commissie uit. Het is null voor verdiensten die zijn verrekend voordat Whop dat detail vastlegde.

Het leaderboard

GET /partners/leaderboard rangschikt doorverwijzers op partnerverdiensten. De parameter period accepteert day, month, year, last_30_days of all_time, en staat standaard op all_time. Authenticatie is optioneel. Anonieme aanroepers krijgen de ranglijst in leaders, en geauthenticeerde aanroepers krijgen ook hun eigen positie in me, dat null is wanneer je nog geen referralverdiensten hebt.

Volgende stappen

Inschrijven als partner

Eén aanroep om deel te nemen en je referrallink te krijgen.

Je referrals weergeven

Elk bedrijf dat je hebt binnengehaald, met verdiensten.

Affiliates

Referraltracking binnen je eigen producten.

Partners-referentie

Elk partner-endpoint, met een playground.