Skip to main content
Gebruik opgeslagen betaalmethoden om klanten automatisch te belasten voor abonnementen, verlengingen of facturering op basis van gebruik. De klant slaat zijn kaart één keer op via een gehoste of ingesloten flow van Whop, en daarna kun je die op elk moment belasten.
Combineer deze gids met webhooks: luister naar setup_intent.succeeded om het opslaan te bevestigen, en daarna naar payment.succeeded / payment.failed om toekomstige afschrijvingen te volgen.

Kies je opslagflow

Twee routes, afhankelijk van of de gebruiker ook nu betaalt. De rest van deze pagina behandelt de setup-modus van begin tot eind en laat daarna zien hoe je een opgeslagen methode later belast.

Een betaalmethode opslaan met de payment elements

Bouw het opslagformulier op de payment elements in mode: "setup". Het element biedt alleen methoden aan die kunnen worden opgeslagen, toont de koper de toestemming voor toekomstig gebruik die het opslaan vereist en geeft je een bevestigingstoken. Vanaf je server zet je dat token om in een setup intent, en met de client_secret van de setup intent rond je elke stap af die de koper nog moet doen.
1

Het formulier mounten in setup-modus

Geef mode="setup" door en de valuta waarmee de opgeslagen methode wordt gebruikt. Er is geen bedrag, dus bedraglimieten gelden niet. Stel returnUrl in op een pagina die je via https host. Bankinschrijvingen en sommige 3D Secure-flows brengen de koper daar terug.
Het token bevat de toestemming die het element heeft getoond. Een token dat is verzameld met een formulier in betaalmodus wordt door de setup intent geweigerd, dus mount in mode="setup" wanneer de koper niet betaalt.
2

De setup intent aanmaken op je server

Maak een setup intent aan met het bevestigingstoken. Whop bepaalt de koper aan de hand van het e-mailadres in het token en antwoordt met 201 Created en de setup intent. Die bevat de status, een client_secret voor elke stap die de koper nog moet doen en, zodra de status succeeded is, de opgeslagen methode als payment_method_id. Voeg metadata toe om de opgeslagen methode aan een klant in je systeem te koppelen. Die komt terug in de webhook. Stuur een Idempotency-Key mee zodat een herhaald verzoek de methode nooit twee keer opslaat.
3

Openstaande stappen afronden

Een setup intent die terugkomt met succeeded heeft de methode opgeslagen. requires_action betekent dat de koper nog een stap moet doen, zoals 3D Secure of een bankinschrijving. Geef de client_secret door aan handleNextAction, dezelfde aanroep die de betaalflow gebruikt. Die voert een inline stap uit in een dialoogvenster of stuurt de koper naar je returnUrl. Vertak op de status die wordt teruggegeven: bij succeeded is de methode opgeslagen, bij processing wordt nog beslist en al het andere vereist een nieuwe poging. Een gesloten dialoogvenster laat de setup op requires_action staan zonder fout, en lastPaymentError bevat de reden wanneer de poging mislukt. processing betekent dat de verwerker nog beslist, dus toon een wachtstatus en laat de webhook hieronder het opslaan bevestigen. canceled betekent dat de koper de stap heeft afgebroken of dat de provider de methode heeft geweigerd: last_setup_error bevat de reden van de provider en blijft null wanneer de koper is weggegaan. Om de status in plaats daarvan vanaf je server uit te lezen, haal je de setup intent op en vertak je op dezelfde status, of poll je het lichtere Retrieve setup status zolang een stap openstaat.
4

Voltooiing afhandelen

Luister naar de webhook setup_intent.succeeded om het ID van de betaalmethode en je metadata terug te krijgen. Dit is het enige signaal dat een gesloten tabblad overleeft, en dezelfde handler bedient ook de gehoste flow hieronder. De setup intent bevat ook payment_instrument voor weergave: een naam, de standaard iconenset en bij een kaart het merk, de laatste vier cijfers en de vervaldatum. Je kunt de opgeslagen methode tonen zonder nog een verzoek. Webhooks die zijn vastgezet op een versie vóór API-versie 2026-09-22-1 bevatten de opgeslagen methode in plaats daarvan als payment_method.id.
De betaalmethode is nu opgeslagen en geautoriseerd voor dit lid. Belast deze met de stappen in Een opgeslagen betaalmethode belasten.

Een betaalmethode opslaan met een gehoste checkout

1

Een checkoutconfiguratie aanmaken in setup-modus

Maak een checkoutconfiguratie aan zonder variant om betaalgegevens te verzamelen zonder af te schrijven. Voeg metadata toe om het lid en de betaalmethode aan een klant in je systeem te kunnen koppelen.
2

De gebruiker naar de checkout leiden

Mount het Checkout-element of stuur de gebruiker door om de betaalmethode op te slaan.
Een configuratie in setup-modus mount hetzelfde element als het opslaan van een betaalmethode: er wordt niets afgeschreven en de voltooide checkout stuurt door naar returnUrl met setup_intent_id in de querystring. Bevestig het opslaan aan de hand van de webhook setup_intent.succeeded in plaats van de redirect.
3

Voltooiing afhandelen

Luister naar de webhook setup_intent.succeeded om het ID van de betaalmethode op te halen. De setup intent bevat checkout_configuration_id en de metadata van de configuratie, waarmee je het lid en de betaalmethode aan een klant in je systeem kunt koppelen.
Bevestig het opslaan aan de hand van de webhook in plaats van de aankomst van de koper op je redirect_url. Dit is het enige signaal dat een gesloten tabblad overleeft.
Het voorbeeld gebruikt waitUntil uit @vercel/functions om de handler uit te voeren nadat met 200 is geantwoord. Vervang dit in andere runtimes (Bun, Cloudflare Workers, Fastify, Hono) door de equivalente achtergrondtaakfunctie van je framework of een job queue. Zie de gids over webhooks voor equivalente handlers in Python en Ruby.
De betaalmethode is nu opgeslagen en geautoriseerd voor dit lid.

Een opgeslagen betaalmethode belasten

1

De betaalmethode ophalen

Geef de opgeslagen betaalmethoden van een lid weer, of gebruik de payment_method_id uit de setup intent van de vorige stap.
2

Een off-session betaling aanmaken

Belast de betaalmethode zonder interactie van de klant. Het endpoint voor het aanmaken van betalingen geeft direct een betalingsobject terug en verwerkt de afschrijving asynchroon.
Je kunt ook line_items versturen om bestaande varianten te combineren met inline aangemaakte prijzen. Elk item accepteert precies één van variant_id of variant:
Voor het aanmaken van een variant zijn zowel plan:create als payment:charge vereist. Voor het hergebruiken van een overeenkomende variant via product_id is alleen payment:charge nodig. Een inline product-definitie vereist ook access_pass:create om het product aan te maken, of access_pass:update om een bestaand product bij te werken. Varianten moeten bij het betalingsaccount horen en voldoen aan de compatibiliteitsregels van de winkelwagen. De inline variant gebruikt hetzelfde zoek-of-maak-gedrag als een variant op het hoogste niveau. Geef force_create_new_plan: true door om een nieuwe variant af te dwingen. Geneste variant- en productvelden volgen Api-Version-Date, en onbekende eigenschappen worden geweigerd. Gebruik een Idempotency-Key om het verzoek opnieuw af te spelen zonder nog een betaling aan te maken.Geef het ID van een van je promotiecodes door als promo_code_id om een korting toe te passen, en Whop berekent de afgeprijsde prijs voor je. De promotiecode moet actief en geldig zijn voor de variant, en de variant moet bij een product horen.
3

Betalingsevents afhandelen

Luister naar betalingswebhooks om succes of mislukking te volgen.

Opslaan tijdens de checkout

Om een betaalmethode op te slaan terwijl je de koper belast, bouw je de checkout op de payment elements en geef je setupFutureUsage: "off_session" door op de Payments-handle. De elements tonen de koper de toestemming voor het opslaan en leggen die vast op het bevestigingstoken, en de betaling slaat de methode alleen veilig op wanneer die toestemming is bevestigd. De Elements-property voor het selecteren van een variant heet om compatibiliteitsredenen nog steeds plan.
1

Het formulier mounten met toestemming voor opslaan

Een checkout bouwen met payment elements loopt de betaalknop, createConfirmationToken en handleNextAction door.
2

De betaling aanmaken met het bevestigingstoken

Het antwoord op het aanmaken is de betaling zoals die is geopend, niet de uitkomst ervan. De payment_method_id van de opgeslagen methode komt binnen via de webhook payment.succeeded zodra de afschrijving is voltooid.
3

Later belasten

payment_method_id is de payt_-methode die je gebruikt in Een opgeslagen betaalmethode belasten. Het blijft null wanneer er niets is opgeslagen. De webhook payment.succeeded bevat hetzelfde veld, en dat is de route die een gesloten tabblad overleeft.

Volgende stappen

Betalingen accepteren

Eenmalige checkouts en abonnementscheckouts om te combineren met je opslagflow.

Checkout-element

Mount de Whop-checkout op je eigen site met Whop Elements.

Naar webhooks luisteren

Volg setup_intent.succeeded, payment.succeeded en payment.failed.

Factureringsportaal

Laat klanten hun opgeslagen betaalmethoden beheren en verwijderen.