Skip to main content
Brug gemte betalingsmetoder til automatisk at opkræve kunder for abonnementer, fornyelser eller forbrugsbaseret fakturering. Kunden gemmer sit kort én gang via et Whop-hostet eller indlejret flow, og du kan opkræve det når som helst derefter.
Kombiner denne guide med webhooks: lyt efter setup_intent.succeeded for at bekræfte, at metoden er gemt, og derefter efter payment.succeeded / payment.failed for at følge fremtidige opkrævninger.

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 i mode: "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 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.
Tokenet indeholder det samtykke, elementet viste. Et token indsamlet fra en formular i betalingstilstand afvises af setup intenten, så monter i 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 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.
Betalingsmetoden er nu gemt og godkendt for dette medlem. Opkræv den med trinnene i Opkræv en gemt betalingsmetode.

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 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 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.
Eksemplet bruger waitUntil fra @vercel/functions til at køre handleren efter at have svaret 200. På andre runtimes (Bun, Cloudflare Workers, Fastify, Hono) skal du erstatte den med dit frameworks tilsvarende primitiv til baggrundsopgaver eller en jobkø. Se webhooks-guiden for tilsvarende handlere i Python og Ruby.
Betalingsmetoden er nu gemt og godkendt for dette medlem.

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.
Du kan også sende line_items for at blande eksisterende varianter med priser oprettet inline. Hvert element tager præcis én af variant_id eller variant:
Oprettelse af en variant kræver plan:create samt payment:charge. Genbrug af en matchende variant via product_id kræver kun payment:charge. En inline product-definition kræver også access_pass:create for at oprette produktet eller access_pass:update for at opdatere et eksisterende. Varianter skal tilhøre betalingskontoen og opfylde kurvens kompatibilitetsregler. Den inline variant bruger samme find-eller-opret-adfærd som en variant på øverste niveau. Angiv force_create_new_plan: true for at gennemtvinge en ny variant. Indlejrede variant- og produktfelter følger Api-Version-Date, og ukendte egenskaber afvises. Brug en Idempotency-Key til at gentage requesten uden at oprette endnu en betaling.For at give rabat skal du angive ID’et for en af dine rabatkoder som promo_code_id, så beregner Whop den nedsatte pris for dig. Rabatkoden skal være aktiv og gyldig for varianten, og varianten skal tilhøre et produkt.
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 angive setupFutureUsage: "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

Byg en checkout med betalingselementer gennemgår betalingsknappen, 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.