Skip to main content
Denne quickstart kører i sandkassen, et separat Whop-miljø, hvor der aldrig flyttes penge. Du får en sandbox-API-nøgle, foretager dit første kald, opretter en checkout, betaler den med et testkort og modtager payment.succeeded-webhooken på din server. At gå live er det sidste trin, og det handler mest om at bytte nøgler.
Hvis du bruger en kodeagent, så giv den denne side som Markdown, https://docs.whop.com/developer/quickstart.md, eller indsæt prompten fra Oversigt.

Sandkasse og produktion

Whop kører to miljøer, der intet deler: ikke konti, ikke nøgler, ikke produkter, ikke webhooks. Du bygger i sandkassen og lancerer i produktion. Hver værdi nedenfor ændrer sig mellem dem.
Sandbox- og produktions-API-nøgler ser identiske ud, så intet i en nøgle fortæller dig, hvilket miljø den hører til. Kodestykkerne på denne side vælger miljøet ud fra en WHOP_ENVIRONMENT-variabel i stedet for at hardcode det, så den samme kode kører i begge. Whop MCP-serveren handler kun på produktionsdata.

Få en sandbox-API-nøgle

1

Tilmeld dig sandkassen

Gå til sandbox.whop.com, og opret en konto. Den er adskilt fra enhver konto, du har på whop.com. Tilmeldingsforløbet opretter din første virksomhed, som er den Account, der ejer API-nøgler, produkter, webhooks og betalinger.
2

Opret en Account API-nøgle

Åbn sandbox.whop.com/dashboard/developer. Under Account API Keys skal du vælge Create og give nøglen et navn som Local development.Brug Admin-rollen til denne quickstart. Før produktion skal du skifte til et brugerdefineret tilladelsessæt, der kun dækker de endpoints, du kalder.
3

Gem nøglen på din server

Kopiér nøglen, når Whop viser den, og læg den i din lokale .env-fil sammen med det miljø, den hører til:
Whop-dashboardets Account API Keys-sektion, der viser et nøglenavn, en maskeret værdi og en Create-knap
Hold WHOP_API_KEY på din server. Læg ikke API-nøgler i browserkode, mobilapps eller offentlige repositories. Sandbox- og produktionsnøgler ser identiske ud, så navngiv dem, så du kan skelne dem fra hinanden.
En Account API-nøgle er det rette valg, når din server handler på vegne af din egen virksomhed. For at bygge en app, som andre virksomheder installerer, eller for at lade brugere logge ind med Whop, se Godkendelse og API-nøgler.

Installér SDK’et

Denne side kræver SDK 2.7.0 eller nyere. Tidligere versioner accepterer ikke den inline variant på checkout-konfigurationer.

Foretag dit første kald

Peg klienten mod det miljø, der er angivet i WHOP_ENVIRONMENT, og hent kontoen bag din nøgle. Det bekræfter, at nøglen virker, og udskriver dit konto-ID, som starter med biz_.
Det er din sandbox-konto. Nøglen virker.

Opret en checkout

Ét kald opretter en variant og returnerer en purchase_url, en checkout-side hostet på sandbox.whop.com.
Du åbner denne URL i betalingstrinnet. Hvis du allerede har en variant, så send dens ID som variant_id i stedet for den inline variant. Du kan ikke sende begge. Create Checkout Configuration viser alle muligheder, herunder tilbagevendende priser, prøveperioder og omdirigerings-URL’er.

Lyt efter webhooken

Opsæt dit endpoint, før du betaler, så payment.succeeded-hændelsen har et sted at lande.
1

Tilføj et endpoint

Tilføj en POST-rute, der verificerer signaturen og logger hændelsen. Verificeringen kræver den rå request-body, så læs den før enhver JSON-parsing.
Mens du udvikler, så eksponér ruten over HTTPS med ngrok, Cloudflare Tunnel eller en anden tunnel.
2

Opret webhooken i sandbox-dashboardet

Åbn Developer > Webhooks i sandbox-dashboardet, og vælg derefter Create webhook. Indsæt HTTPS-adressen på dit endpoint, behold API-versionen på v1, og vælg payment.succeeded.
Formularen til oprettelse af webhook, der viser hændelsen payment_succeeded valgt på hændelseslisten
3

Gem signeringshemmeligheden

Kopiér hemmeligheden fra webhookens Secret-kolonne, og tilføj den til .env præcis som vist, inklusive ws_-præfikset:
Genstart din server, så den indlæser den nye værdi.

Betal med et testkort

Åbn purchase_url fra checkout-trinnet, og betal med: Inden for få sekunder logger din server payment.succeeded og betalings-ID’et, som starter med pay_.
Du har modtaget en betaling og håndteret dens webhook fra ende til anden. Der blev ikke trukket noget.
For at teste et afvist kort eller 3D Secure skal du bruge de andre numre i Testkort. Hvis intet ankommer, så tjek leveringsloggen på webhooken i dashboardet og Webhook-levering.

Gå live

Sandkasse og produktion deler intet, så at gå live betyder, at du gentager opsætningen på whop.com med produktionsoplysninger. Din kode ændrer sig ikke. Kun værdierne i dit miljø gør.
1

Opret en produktionsnøgle

Log ind på whop.com, åbn whop.com/dashboard/developer, og opret en Account API-nøgle med kun de tilladelser, din integration bruger.
2

Byt hver værdi ud med dens produktionsmodstykke

I dit produktionsmiljø skal du sætte alle tre variabler til produktionsværdier. Genbrug aldrig en sandbox-nøgle eller -hemmelighed i produktion, eller omvendt.
Hvis du kalder API’et direkte, så skift base-URL’en til https://api.whop.com/api/v1.
3

Genskab det, du lavede i sandkassen

Produkter, varianter, checkout-konfigurationer og webhooks overføres ikke. Opret produktionswebhooken mod din produktions-URL, og gem dens nye signeringshemmelighed.
4

Fastlås din API-version

SDK’et sender den version, det blev bygget mod. Hvis du kalder API’et direkte, så send Api-Version-Date på hver anmodning, så senere ændringer ikke ændrer dine svar. Se API-versionering.
Checkout-links i produktion tager rigtige penge. Tjek, hvilken nøgle du har i hånden, før du kører noget, der opretter en opkrævning eller flytter en saldo.

Byg nu det, du kom for

Du sælger et abonnement eller et engangsprodukt

Checkout-links, Checkout-elementet, varianter og prøveperioder.

Du skylder penge til andre end dig selv

Udbetalinger, overførsler, saldi og udbetalingsportalen.

Du tager en andel af det, andre sælger

Underkonti, opkrævning på deres vegne og udbetaling til dem.

Du vil have distribution, ikke kun infrastruktur

Apps, der kører inde i Whop, med godkendelse, visninger og CLI’en.

Dit produkt kræver, at folk taler med hinanden

Chat, DM’er og fora, du kan indlejre.

Du vil bare læse referencen

Alle ressourcer i Current API, med en playground på hvert endpoint.