Før du starter, skal du have:
- En API-nøgle med scopes
payout:destination:readogpayout:create_destination. - PayPal-login aktiveret på kontoen. Kontakt Whop for at få det slået til. Indtil da er
supports_paypal_loginfalse, og trin 2 returnerer403. - En gennemført udbetalingsopsætning. Whop matcher navnet i den med PayPal-kontoen.
- En
https-side, som PayPal kan sende indehaveren tilbage til, på et domæne, der er tilføjet til kontoen eller dens platform. Tilføj det med Create Domain ogverification: {}. Verificeringen behøver ikke at være fuldført.https://localhostvirker til test. - Whop SDK 2.5.0 eller nyere, hvis du bruger et SDK.
Sådan fungerer omdirigeringen
Det hele sker i indehaverens browser, i én fane. Du kalder aldrig PayPal direkte.- Din server starter en session og får en
authorize_urlhos PayPal. - Indehaverens browser går dertil, og vedkommende logger ind og godkender.
- PayPal sender browseren tilbage til Whop, som læser kontoens e-mail, navn og verificeringsstatus.
- Whop sender browseren til din
return_urlmed?paypal_link_token=…eller?error=…. - Din server sender tokenet til Whop, som kontrollerer navnet og gemmer metoden.
- Find udbetalingsmetoden
List understøttede udbetalingsmetoder, og gem id for den med supports_paypal_login: true. SDK’erne bladrer gennem alle resultater for dig.
- Start login
Opret en PayPal-linksession, og omdiriger indehaveren til dens authorize_url. Sessionen udløber efter 15 minutter, ved expires_at.
return_url med en af disse:
Hvis indehaveren bliver færdig efter
expires_at, eller efter at return_url-domænet er fjernet fra kontoen, kan Whop ikke sende vedkommende tilbage. Vedkommende ser en side med “Invalid or expired link”.
- Gem udbetalingsmetoden
Opret den gemte udbetalingsmetode på din server med paypal_link_token i stedet for fields. Brug samme account_id, supported_payout_method_id og destination_currency som sessionen, da tokenet kun virker med dem. Whop gemmer PayPals e-mail og navngiver metoden efter den.
Hvis Whop afviser kontoen
Whop svarer400 med en message til indehaveren, f.eks. ved et navn, der ikke matcher. Vis den uændret.
- Tokenet overlever en afvisning, så prøv en midlertidig fejl igen med samme token.
- Hvis beskeden siger, at PayPal skal forbindes igen, så start en ny session, når indehaveren har løst problemet.
- En ikke-verificeret PayPal-konto eller en ubekræftet e-mail gemmes stadig.
Hvad indehaveren ser
PayPals samtykkeskærm nævner Whop som den app, der beder om vedkommendes e-mail, navn og verificeringsstatus. Alle omdirigeringer forbliver i den fane, der åbnede PayPal, så hvis du bruger en pop-up, skal din returneringsside give besked til det vindue, der åbnede den, og lukke sig selv.Næste trin
Send en udbetaling
Udbetal til den PayPal-metode, du lige har gemt
API-reference for Payouts
Alle endpoints for udbetalinger og udbetalingsmetoder

