Voordat je begint, heb je het volgende nodig:
- Een API-sleutel met de scopes
payout:destination:readenpayout:create_destination. - Inloggen met PayPal ingeschakeld op het account. Neem contact op met Whop om dit in te schakelen. Tot die tijd is
supports_paypal_loginfalseen retourneert stap 2 een403. - Voltooide uitbetalingsinstellingen. Whop vergelijkt de naam daarin met het PayPal-account.
- Een
https-pagina waarnaar PayPal de houder kan terugsturen, op een domein dat is toegevoegd aan het account of het platform daarvan. Voeg het toe met Create Domain enverification: {}. De verificatie hoeft niet te zijn afgerond.https://localhostwerkt om te testen. - Whop SDK 2.5.0 of hoger, als je een SDK gebruikt.
Hoe de redirect werkt
Alles gebeurt in de browser van de houder, in één tabblad. Je roept PayPal nooit rechtstreeks aan.- Je server start een sessie en krijgt een
authorize_urlbij PayPal. - De browser van de houder gaat daarheen, waar de houder inlogt en toestemming geeft.
- PayPal stuurt de browser terug naar Whop, dat het e-mailadres, de naam en de verificatiestatus van het account uitleest.
- Whop stuurt de browser naar je
return_urlmet?paypal_link_token=…of?error=…. - Je server geeft het token door aan Whop, dat de naam controleert en de methode opslaat.
- Zoek de uitbetaalmethode
Vraag de ondersteunde uitbetaalmethoden op en bewaar de id van de methode met supports_paypal_login: true. De SDK’s bladeren voor je door alle resultaten.
- Start het inloggen
Maak een PayPal-koppelsessie aan en stuur de houder door naar de authorize_url ervan. De sessie verloopt na 15 minuten, op expires_at.
return_url met een van de volgende:
Als de houder klaar is na
expires_at, of nadat het domein van de return_url uit het account is verwijderd, kan Whop de houder niet terugsturen. De houder ziet dan een pagina “Invalid or expired link”.
- Sla de uitbetaalmethode op
Maak op je server de opgeslagen uitbetaalmethode aan met paypal_link_token in plaats van fields. Gebruik dezelfde account_id, supported_payout_method_id en destination_currency als de sessie, want het token werkt alleen daarmee. Whop slaat het e-mailadres van PayPal op en vernoemt de methode ernaar.
Als Whop het account weigert
Whop antwoordt met400 en een message voor de houder, bijvoorbeeld bij een niet-overeenkomende naam. Toon die melding ongewijzigd.
- Het token blijft geldig na een weigering, dus probeer een tijdelijke fout opnieuw met hetzelfde token.
- Als de melding zegt dat PayPal opnieuw moet worden gekoppeld, start dan een nieuwe sessie zodra de houder het probleem heeft opgelost.
- Een niet-geverifieerd PayPal-account of een niet-bevestigd e-mailadres wordt toch opgeslagen.
Wat de houder ziet
Het toestemmingsscherm van PayPal noemt Whop als de app die om het e-mailadres, de naam en de verificatiestatus vraagt. Elke redirect blijft in het tabblad dat PayPal heeft geopend, dus als je een pop-up gebruikt, moet je returnpagina het venster dat de pop-up heeft geopend op de hoogte stellen en zichzelf sluiten.Volgende stappen
Een uitbetaling versturen
Betaal uit naar de PayPal-methode die je zojuist hebt opgeslagen
API-referentie voor uitbetalingen
Alle endpoints voor uitbetalingen en uitbetaalmethoden

