Skip to main content
Deze quickstart draait in de sandbox, een aparte Whop-omgeving waarin nooit echt geld wordt verplaatst. Je haalt een sandbox-API-sleutel op, doet je eerste aanroep, maakt een checkout aan, betaalt die met een testkaart en ontvangt de webhook payment.succeeded op je server. Live gaan is de laatste stap, en dat komt grotendeels neer op het verwisselen van sleutels.
Gebruik je een coding agent, geef hem dan deze pagina als Markdown, https://docs.whop.com/developer/quickstart.md, of plak de prompt uit het Overzicht.

Sandbox en productie

Whop heeft twee omgevingen die niets met elkaar delen: geen accounts, geen sleutels, geen producten, geen webhooks. Je bouwt in de sandbox en lanceert in productie. Elke waarde hieronder verschilt tussen de twee.
API-sleutels voor sandbox en productie zien er identiek uit, dus niets in een sleutel vertelt je bij welke omgeving hij hoort. De fragmenten op deze pagina kiezen de omgeving op basis van een variabele WHOP_ENVIRONMENT in plaats van die hard te coderen, zodat dezelfde code in beide omgevingen werkt. De Whop MCP-server werkt alleen met productiegegevens.

Een sandbox-API-sleutel ophalen

1

Meld je aan voor de sandbox

Ga naar sandbox.whop.com en maak een account aan. Dit staat los van een eventueel account op whop.com. Tijdens het aanmelden wordt je eerste bedrijf aangemaakt: het Account dat eigenaar is van API-sleutels, producten, webhooks en betalingen.
2

Maak een Account API-sleutel aan

Open sandbox.whop.com/dashboard/developer. Selecteer in Account API Keys de optie Create en geef de sleutel een naam zoals Local development.Gebruik voor deze quickstart de rol Admin. Schakel vóór productie over naar een aangepaste set machtigingen die alleen de endpoints dekt die je aanroept.
3

Bewaar de sleutel op je server

Kopieer de sleutel wanneer Whop hem toont en zet hem in je lokale .env-bestand, samen met de omgeving waartoe hij behoort:
Sectie Account API Keys in het Whop-dashboard met een sleutelnaam, gemaskeerde waarde en de knop Create
Houd WHOP_API_KEY op je server. Zet API-sleutels niet in browsercode, mobiele apps of openbare repositories. Sleutels voor sandbox en productie zien er identiek uit, dus geef ze namen waarmee je ze uit elkaar kunt houden.
Een Account API-sleutel is de juiste keuze wanneer je server namens je eigen bedrijf handelt. Wil je een app bouwen die andere bedrijven installeren, of gebruikers laten inloggen met Whop, zie dan Auth & API-sleutels.

De SDK installeren

Voor deze pagina heb je SDK 2.7.0 of hoger nodig. Eerdere versies accepteren de inline variant op checkoutconfiguraties niet.

Je eerste aanroep doen

Richt de client op de omgeving die in WHOP_ENVIRONMENT staat en haal het account achter je sleutel op. Zo bevestig je dat de sleutel werkt, en print je je account-ID, dat begint met biz_.
Dat is je sandboxaccount. De sleutel werkt.

Een checkout aanmaken

Eén aanroep maakt een variant aan en retourneert een purchase_url, een checkoutpagina die wordt gehost op sandbox.whop.com.
Je opent deze URL in de betaalstap. Heb je al een variant, geef dan het ID ervan door als variant_id in plaats van de inline variant. Je kunt niet beide meesturen. Create Checkout Configuration somt alle opties op, waaronder terugkerende prijzen, proefperiodes en redirect-URL’s.

Luisteren naar de webhook

Zet je endpoint op voordat je betaalt, zodat het event payment.succeeded ergens terechtkan.
1

Voeg een endpoint toe

Voeg een POST-route toe die de handtekening verifieert en het event logt. Voor verificatie heb je de ruwe request-body nodig, dus lees die uit vóór je JSON gaat parsen.
Stel de route tijdens het ontwikkelen via HTTPS beschikbaar met ngrok, Cloudflare Tunnel of een andere tunnel.
2

Maak de webhook aan in het sandboxdashboard

Open Developer > Webhooks in het sandboxdashboard en selecteer Create webhook. Plak het HTTPS-adres van je endpoint, laat de API-versie op v1 staan en selecteer payment.succeeded.
Formulier Create webhook met het event payment_succeeded geselecteerd in de lijst met events
3

Bewaar het ondertekeningsgeheim

Kopieer het geheim uit de kolom Secret van de webhook en voeg het precies zoals getoond toe aan .env, inclusief het voorvoegsel ws_:
Herstart je server zodat hij de nieuwe waarde oppikt.

Betalen met een testkaart

Open de purchase_url uit de checkoutstap en betaal met: Binnen een paar seconden logt je server payment.succeeded en het betalings-ID, dat begint met pay_.
Je hebt van begin tot eind een betaling ontvangen en de bijbehorende webhook verwerkt. Er is niets in rekening gebracht.
Wil je een geweigerde kaart of 3D Secure testen, gebruik dan de andere nummers in Testkaarten. Komt er niets binnen, controleer dan het afleverlog van de webhook in het dashboard en Aflevering van webhooks.

Live gaan

Sandbox en productie delen niets, dus live gaan betekent dat je de configuratie op whop.com herhaalt met productiegegevens. Je code verandert niet. Alleen de waarden in je omgeving veranderen.
1

Maak een productiesleutel aan

Log in op whop.com, open whop.com/dashboard/developer en maak een Account API-sleutel aan met alleen de machtigingen die je integratie gebruikt.
2

Vervang elke waarde door de productietegenhanger

Stel in je productieomgeving alle drie de variabelen in op productiewaarden. Gebruik nooit een sandboxsleutel of -geheim in productie, of andersom.
Roep je de API rechtstreeks aan, wijzig dan de basis-URL naar https://api.whop.com/api/v1.
3

Maak opnieuw aan wat je in de sandbox hebt gemaakt

Producten, varianten, checkoutconfiguraties en webhooks worden niet overgenomen. Maak de productiewebhook aan voor je productie-URL en bewaar het nieuwe ondertekeningsgeheim.
4

Zet je API-versie vast

De SDK stuurt de versie mee waartegen hij is gebouwd. Roep je de API rechtstreeks aan, stuur dan Api-Version-Date mee bij elk verzoek, zodat latere wijzigingen je responses niet veranderen. Zie API-versiebeheer.
Checkoutlinks in productie innen echt geld. Controleer welke sleutel je gebruikt voordat je iets uitvoert dat een betaling aanmaakt of een saldo verplaatst.

Bouw nu waarvoor je kwam

Je verkoopt een abonnement of een eenmalig product

Checkoutlinks, het Checkout-element, varianten en proefperiodes.

Je bent geld verschuldigd aan anderen

Uitbetalingen, overboekingen, saldi en het uitbetalingsportaal.

Je ontvangt een deel van wat anderen verkopen

Subaccounts, namens hen innen en hen uitbetalen.

Je wilt distributie, niet alleen infrastructuur

Apps die binnen Whop draaien, met auth, views en de CLI.

Je product heeft mensen nodig die met elkaar praten

Chat, DM’s en forums die je kunt insluiten.

Je wilt gewoon de referentie lezen

Elke resource in de Current API, met een playground bij elk endpoint.