Hurtig triage
API-anmodningsfejl
Whop returnerer standard-HTTP-statuskoder. Når en anmodning fejler, fortæller svar-body’en dig hvorfor. De fleste fejl indeholder en kode og en besked:error og error_description. Se OAuth-fejl for disse tilfælde.
Hastighedsbegrænsninger
For/api/v1-anmodninger sporer Whop anmodningsmængden pr. API-operation og API-legitimationsoplysning. Standardgrænsen er 600 anmodninger pr. minut.
Når du overskrider grænsen, returnerer API’et 429 med:
API-godkendelse
Brug de legitimationsoplysninger, der passer til, hvor koden kører.
Hvis en API-anmodning fejler:
- Bekræft, at miljøet matcher nøglen: SDK’ets
Production-miljø (standarden) for produktionsnøgler ogSandboxfor sandbox-nøgler, ellerhttps://api.whop.com/api/v1oghttps://sandbox-api.whop.com/api/v1, når du kalder API’et direkte. - Bekræft, at ID’er bruger Whop-tag-præfikser som
biz_,user_,mem_,plan_,prod_,app_,pay_ellerch_, ikke interne numeriske ID’er. - Log HTTP-status, svar-body, endpoint og request-ID, hvis Whop returnerer et.
- Prøv kun igen, når fejlen er forbigående eller skyldes hastighedsbegrænsning. Prøv ikke
401,403eller valideringsfejl igen uden at ændre anmodningen.
Tilladelser og scopes
403- og insufficient_scope-fejl betyder normalt, at legitimationsoplysningerne er gyldige, men ikke kan udføre den handling.
- For Whop-apps skal du bekræfte, at appen anmoder om de nødvendige tilladelser i Tilladelser, og derefter gemme app-indstillingerne og geninstallere eller genautorisere, når det er nødvendigt.
- For OAuth skal du kun anmode om de scopes, din funktion har brug for, og derefter sikre dig, at brugeren gennemførte OAuth-forløbet, efter du tilføjede disse scopes.
- For API-nøgler oprettet i dashboardet skal du bekræfte, at nøglen hører til den konto, hvis ID du sender som
account_id. - For underkonti skal du afklare, om forældre- eller underkontoen skal eje handlingen, før du vælger den konto, du sender.
OAuth-fejl
OAuth-fejl returnerer en standard-payload eller en omdirigerings-forespørgselsstreng mederror og error_description.
Checkout-fejl
Checkout-elementet og iOS-checkout kan fejle af forskellige årsager. Fejlsøg dem på samme måde: tjek varianten eller checkout-konfigurationen, undersøg fejl-callbacket, og bekræft leveringen på din server.Checkout-element
- Tilknyt
onError. Den kører, når elementet ikke kan indlæses eller går ned, med enmessageog encodetil programmatisk håndtering. - Hvis du sender kompatibilitetsegenskaben
plan, skal du bekræfte, at varianten findes, er aktiv og hører til den konto, du forventer. - Hvis du sender
checkoutConfiguration, skal du bekræfte, at din server har oprettet den, og at du har sendt densch_-ID. - Alle indstillinger sættes ved oprettelsen. For at ændre ordren skal du montere en ny checkout i stedet for at kalde
update(). - En mislykket betaling genåbner den samme checkout med årsagen vist, så køberen kan betale igen uden genmontering.
- Angiv en
returnUrlpå en rute, der kan vise succes- og genforsøgstilstande. Et trin uden for siden, såsom 3DS eller en bankside, sender køberen tilbage dertil. - Brug webhooks til levering. Omdirigeringen er nyttig til UI, men din server bør stole på
payment.succeeded.
iOS-checkout
Håndtér forventede og uventede fejl med forskellige forløb:
Webhook-levering
Almindelige webhook-problemer:- Ingen hændelse modtaget: bekræft, at webhook-URL’en er offentligt tilgængelig, bruger
httpsog hører til den rigtige konto og det rigtige miljø. - Signaturverificering fejler: send den rå request-body til
unwrapWebhook. Parse ikke JSON før verificering. - Genforsøg bliver ved: returnér hurtigt et
2xx-svar efter verificering, før du starter langvarigt arbejde i et baggrundsjob. - Dobbelt levering: Whop leverer webhooks mindst én gang. Gem
webhook-ideller en anden hændelsesidentifikator, og gør handleren idempotent. - Uventet rækkefølge: antag ikke, at hændelser ankommer i kronologisk rækkefølge. Hent ressourcens aktuelle tilstand, når rækkefølgen betyder noget.
Element-fejl
Hvert Whop Element accepterer etonError-callback. Det kører, når elementet ikke kan indlæses eller går ned, og værdien indeholder en message, en valgfri code til programmatisk håndtering og en sourceKey, når en host-state-kilde fejlede.
Tilknyt det altid under udvikling:
- Bekræft, at adgangstokenet blev udstedt til den konto, du forventer, og har de scopes, som elementets referenceside angiver.
- På dit eget domæne skal du altid sende et
accessToken. Seerens session virker kun på whop.com. - Bekræft, at containeren findes, før du kalder
mount. React-komponenter monterer sig selv. - Lyt efter
onReady, så du ved, om elementet blev initialiseret. - Hvis elementet ender i en tilstand, det ikke kan komme sig fra, så kald
destroy()og opret et nyt.
Sandkasse og produktion
Sandbox-data og produktionsdata er adskilte.
Når du skifter fra sandkasse til produktion:
- Opret nye produktions-API-nøgler.
- Skift SDK-miljøet fra
SandboxtilProduction, eller fjern en 1.x-sandbox-tilsidesættelse afbaseUrl/base_url/WithBaseURL. - Genskab produkter, checkout-links, webhooks og underkontoposter, der kun findes i sandkassen, i produktion.
- Bekræft, at webhook-URL’er peger på produktionsinfrastruktur, ikke en lokal tunnel.
Hvad du skal inkludere, når du beder om hjælp
Inkludér så meget af følgende, som du kan:- Endpointet, SDK-metoden eller elementnavnet, der fejlede.
- Miljøet: sandkasse eller produktion.
- Statuskoden, fejl-body’en, OAuth-
error_descriptioneller elementetsonError-værdi. - De involverede Whop-ID’er, med hemmeligheder fjernet.
- Webhook-hændelses-ID’et eller
webhook-id-headeren ved webhook-problemer. - Et kort kodestykke, der viser, hvordan du opretter klienten, checkouten, OAuth-URL’en, webhook-handleren eller elementet.
OAuth
Byg OAuth 2.1 + PKCE-forløbet, og håndtér fornyelse af tokens.
Webhooks
Verificér signaturer, før du behandler hændelser, og håndtér genforsøg.
Tilladelser
Vælg app-tilladelser, og forklar dem for skabere.
Test i sandkassen
Test API-kald og checkout-forløb uden at røre produktion.

