Skip to main content
Zorg ervoor dat uitbetalingen alleen terechtkomen op een PayPal-account dat eigendom is van de houder. De houder logt in bij PayPal in plaats van een e-mailadres te typen, en Whop slaat het e-mailadres van PayPal op zodra de naam overeenkomt met de uitbetalingsinstellingen van de houder.
Voordat je begint, heb je het volgende nodig:
  • Een API-sleutel met de scopes payout:destination:read en payout: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_login false en retourneert stap 2 een 403.
  • 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 en verification: {}. De verificatie hoeft niet te zijn afgerond. https://localhost werkt 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.
  1. Je server start een sessie en krijgt een authorize_url bij PayPal.
  2. De browser van de houder gaat daarheen, waar de houder inlogt en toestemming geeft.
  3. PayPal stuurt de browser terug naar Whop, dat het e-mailadres, de naam en de verificatiestatus van het account uitleest.
  4. Whop stuurt de browser naar je return_url met ?paypal_link_token=… of ?error=….
  5. Je server geeft het token door aan Whop, dat de naam controleert en de methode opslaat.

  1. 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.

  1. 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.
De browser keert terug naar je 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”.

  1. 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.
De response is de nieuwe uitbetaalmethode, ingekort:
Je kunt nu een uitbetaling versturen naar deze methode.

Als Whop het account weigert

Whop antwoordt met 400 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