Vælg dit gem-flow
To veje, afhængigt af om brugeren også betaler lige nu.
Resten af denne side gennemgår setup-tilstand fra start til slut og viser derefter, hvordan du opkræver en gemt metode senere.
Gem en betalingsmetode med betalingselementerne
Byg gem-formularen på betalingselementerne imode: "setup". Elementet tilbyder kun metoder, der kan gemmes, viser køberen det samtykke til fremtidig brug, som lagringen kræver, og giver dig et bekræftelsestoken. Du omdanner tokenet til en setup intent fra din server, og setup intentens client_secret gennemfører ethvert trin, køberen mangler.
1
Monter formularen i setup-tilstand
Angiv Tokenet indeholder det samtykke, elementet viste. Et token indsamlet fra en formular i betalingstilstand afvises af setup intenten, så monter i
mode="setup" og den valuta, den gemte metode skal bruges med. Der er intet beløb, så beløbsgrænser gælder ikke. Sæt returnUrl til en side, du hoster over https. Banktilmeldinger og nogle 3D Secure-flows sender køberen tilbage dertil.mode="setup", når køberen ikke betaler.2
Opret setup intenten på din server
Opret en setup intent med bekræftelsestokenet. Whop finder køberen ud fra tokenets e-mail og svarer
201 Created med setup intenten. Den indeholder status, en client_secret til ethvert trin, køberen mangler, og når den har status succeeded, den gemte metode som payment_method_id. Vedhæft metadata for at knytte den gemte metode til en kunde i dit system. Den kommer tilbage med webhooken. Send en Idempotency-Key, så en gentaget request aldrig gemmer metoden to gange.3
Gennemfør eventuelle ventende trin
En setup intent, der kommer tilbage som
succeeded, har metoden registreret. requires_action betyder, at køberen stadig mangler et trin som 3D Secure eller en banktilmelding. Send client_secret til handleNextAction, det samme kald som betalingsflowet bruger. Det kører et inline-trin i en dialog eller sender køberen til din returnUrl. Forgren på den status, det returnerer: succeeded har gemt metoden, processing afgøres stadig, og alt andet kræver et nyt forsøg. En lukket dialog efterlader opsætningen på requires_action uden fejl, og lastPaymentError indeholder årsagen, når forsøget mislykkes. processing betyder, at betalingsbehandleren stadig træffer afgørelse, så vis en ventetilstand, og lad webhooken nedenfor bekræfte lagringen. canceled betyder, at køberen opgav trinnet, eller at udbyderen afviste metoden: last_setup_error indeholder udbyderens årsag og forbliver null, når køberen gik fra det. For i stedet at læse tilstanden fra din server skal du hente setup intenten og forgrene på samme status eller polle det lettere Retrieve setup status, mens et trin venter.4
Håndter gennemførelse
Lyt efter webhooken Betalingsmetoden er nu gemt og godkendt for dette medlem. Opkræv den med trinnene i Opkræv en gemt betalingsmetode.
setup_intent.succeeded for at få betalingsmetodens ID og din metadata tilbage. Det er det eneste signal, der overlever en lukket fane, og den samme handler betjener det hostede flow nedenfor. Setup intenten indeholder også payment_instrument til visning: et navn, standardikonsættet og for et kort dets mærke, sidste fire cifre og udløbsdato. Du kan vise den gemte metode uden endnu en request. Webhooks, der er fastlåst før API-version 2026-09-22-1, angiver i stedet den gemte metode som payment_method.id.Gem en betalingsmetode med en hostet checkout
1
Opret en checkout-konfiguration i setup-tilstand
Opret en checkout-konfiguration uden en variant for at indsamle betalingsoplysninger uden at opkræve. Tilføj metadata, så du kan knytte medlemmet og betalingsmetoden til en kunde i dit system.
2
Send brugeren til checkout
Monter Checkout-elementet, eller omdiriger brugeren for at gemme sin betalingsmetode.En konfiguration i setup-tilstand monterer det samme element som en lagring
af betalingsmetode: der opkræves intet, og den gennemførte checkout omdirigerer til
- Indlejret
- Omdirigering
returnUrl med setup_intent_id i query-strengen. Bekræft lagringen
ud fra webhooken setup_intent.succeeded i stedet for ud fra omdirigeringen.3
Håndter gennemførelse
Lyt efter webhooken Betalingsmetoden er nu gemt og godkendt for dette medlem.
setup_intent.succeeded for at få betalingsmetodens ID. Setup intenten indeholder checkout_configuration_id og konfigurationens metadata, som du kan bruge til at knytte medlemmet og betalingsmetoden til en kunde i dit system.Bekræft lagringen ud fra webhooken i stedet for ud fra, at køberen ankommer til din
redirect_url. Det er det eneste signal, der overlever en lukket fane.Opkræv en gemt betalingsmetode
1
Hent betalingsmetoden
Vis gemte betalingsmetoder for et medlem, eller brug
payment_method_id fra setup intenten i det forrige trin.2
Opret en off-session-betaling
Opkræv betalingsmetoden uden kundeinteraktion. Endpointet til oprettelse af betalinger returnerer straks et betalingsobjekt og behandler opkrævningen asynkront.
3
Håndter betalingshændelser
Lyt efter betalings-webhooks for at følge, om betalinger lykkes eller mislykkes.
Gem under checkout
For at gemme en betalingsmetode, mens du opkræver køberen, skal du bygge checkouten på betalingselementerne og angivesetupFutureUsage: "off_session" på Payments-handlet. Elementerne viser køberen samtykket til lagring og registrerer det på bekræftelsestokenet, og betalingen gemmer kun metoden, når samtykket er bekræftet.
Elements-egenskaben til valg af en variant hedder stadig plan af kompatibilitetshensyn.
1
Monter formularen med samtykke til lagring
createConfirmationToken og handleNextAction.2
Opret betalingen med bekræftelsestokenet
Svaret på oprettelsen er betalingen, som den blev åbnet, ikke dens udfald. Den gemte metodes
payment_method_id kommer med webhooken payment.succeeded, når opkrævningen er gennemført.3
Opkræv den senere
payment_method_id er den payt_-metode, du skal bruge i Opkræv en gemt betalingsmetode. Den forbliver null, når intet blev gemt. Webhooken payment.succeeded indeholder det samme felt, og det er den vej, der overlever en lukket fane.Næste trin
Modtag betalinger
Engangs- og abonnementscheckouts, der passer til dit gem-flow.
Checkout-elementet
Monter Whop checkout på dit eget website med Whop Elements.
Lyt efter webhooks
Følg
setup_intent.succeeded, payment.succeeded og payment.failed.Faktureringsportal
Lad kunder administrere og fjerne deres gemte betalingsmetoder.

