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 inmode: "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 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" 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.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 De betaalmethode is nu opgeslagen en geautoriseerd voor dit lid. Belast deze met de stappen in Een opgeslagen betaalmethode belasten.
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.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
- Ingesloten
- Doorsturen
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 De betaalmethode is nu opgeslagen en geautoriseerd voor dit lid.
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.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.
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 jesetupFutureUsage: "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
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.

