Skip to main content
Når noget går i stykker, så find ud af, hvad der fejler, tjek, at du rammer det rigtige miljø, og se på fejlsvaret. De fleste problemer skyldes: forkerte legitimationsoplysninger, uoverensstemmelse mellem sandkasse og produktion, manglende tilladelse eller en webhook-handler, der ikke svarer korrekt.

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:
Nogle OAuth-endpoints returnerer i stedet OAuth-standardfelterne 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:
Vent den forsinkelse, der står i beskeden, før du prøver igen. For idempotente anmodninger skal du prøve igen med eksponentiel backoff. Prøv ikke validerings-, godkendelses- eller tilladelsesfejl igen uden at ændre anmodningen.

API-godkendelse

Brug de legitimationsoplysninger, der passer til, hvor koden kører. Hvis en API-anmodning fejler:
  1. Bekræft, at miljøet matcher nøglen: SDK’ets Production-miljø (standarden) for produktionsnøgler og Sandbox for sandbox-nøgler, eller https://api.whop.com/api/v1 og https://sandbox-api.whop.com/api/v1, når du kalder API’et direkte.
  2. Bekræft, at ID’er bruger Whop-tag-præfikser som biz_, user_, mem_, plan_, prod_, app_, pay_ eller ch_, ikke interne numeriske ID’er.
  3. Log HTTP-status, svar-body, endpoint og request-ID, hvis Whop returnerer et.
  4. Prøv kun igen, når fejlen er forbigående eller skyldes hastighedsbegrænsning. Prøv ikke 401, 403 eller valideringsfejl igen uden at ændre anmodningen.
Eksponér aldrig Account API-nøgler eller App API-nøgler i kode på klientsiden. Browser-, mobil- og iframe-kode skal kalde din server, og din server skal kalde Whop.

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 med error og error_description.
Omdirigerings-URI’er skal matche præcist. Hvis du har konfigureret https://example.com/oauth/callback, er https://example.com/oauth/callback/ en anden URI.

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 en message og en code til 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 dens ch_-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 returnUrl på 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 https og 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-id eller 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.
Til lokal udvikling skal du videresende en offentlig URL til din maskine med en tunnel og bruge den URL i dashboardets webhook-indstillinger.

Element-fejl

Hvert Whop Element accepterer et onError-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:
Hvis et element ikke kan indlæses:
  1. Bekræft, at adgangstokenet blev udstedt til den konto, du forventer, og har de scopes, som elementets referenceside angiver.
  2. På dit eget domæne skal du altid sende et accessToken. Seerens session virker kun på whop.com.
  3. Bekræft, at containeren findes, før du kalder mount. React-komponenter monterer sig selv.
  4. Lyt efter onReady, så du ved, om elementet blev initialiseret.
  5. Hvis elementet ender i en tilstand, det ikke kan komme sig fra, så kald destroy() og opret et nyt.
Elements-fejlfindingstabellen viser de almindelige symptomer og deres årsager.

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 Sandbox til Production, eller fjern en 1.x-sandbox-tilsidesættelse af baseUrl / 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_description eller elementets onError-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.