Skip to main content
Bir şey bozulduğunda neyin başarısız olduğunu belirleyin, doğru ortama istek gönderdiğinizi kontrol edin ve hata yanıtına bakın. Çoğu sorun şunlardan birine dayanır: yanlış kimlik bilgisi, sandbox/production uyuşmazlığı, eksik izin veya doğru yanıt vermeyen bir webhook işleyicisi.

Hızlı ön değerlendirme

API isteği hataları

Whop standart HTTP durum kodları döndürür. Bir istek başarısız olduğunda yanıt gövdesi nedenini söyler. Çoğu hata bir kod ve bir mesaj içerir:
Bazı OAuth uç noktaları bunun yerine OAuth standardındaki error ve error_description alanlarını döndürür. Bu durumlar için OAuth hataları bölümüne bakın.

Hız sınırları

/api/v1 istekleri için Whop, istek hacmini API işlemi ve API kimlik bilgisi başına izler. Varsayılan sınır dakikada 600 istektir. Sınırı aştığınızda API şu içerikle 429 döndürür:
Yeniden denemeden önce mesajdaki süre kadar bekleyin. İdempotent istekler için üstel geri çekilme ile yeniden deneyin. Doğrulama, kimlik doğrulama veya izin hatalarını isteği değiştirmeden yeniden denemeyin.

API kimlik doğrulaması

Kodun çalıştığı yere uyan kimlik bilgisini kullanın. Bir API isteği başarısız olursa:
  1. Ortamın anahtarla eşleştiğini doğrulayın: production anahtarları için SDK’nın Production ortamı (varsayılan), sandbox anahtarları için Sandbox; API’yi doğrudan çağırıyorsanız https://api.whop.com/api/v1 ve https://sandbox-api.whop.com/api/v1.
  2. Kimliklerin dahili sayısal kimlikler değil, biz_, user_, mem_, plan_, prod_, app_, pay_ veya ch_ gibi Whop etiket önekleri kullandığını doğrulayın.
  3. HTTP durumunu, yanıt gövdesini, uç noktayı ve Whop döndürüyorsa istek kimliğini günlüğe kaydedin.
  4. Yalnızca hata geçiciyse veya hız sınırına takıldıysa yeniden deneyin. 401, 403 veya doğrulama hatalarını isteği değiştirmeden yeniden denemeyin.
Account API anahtarlarını veya App API anahtarlarını asla istemci tarafı kodda açığa çıkarmayın. Tarayıcı, mobil ve iframe kodu sunucunuzu çağırmalı, sunucunuz da Whop’u çağırmalıdır.

İzinler ve kapsamlar

403 ve insufficient_scope hataları genellikle kimlik bilgisinin geçerli olduğu ancak o işlemi gerçekleştiremediği anlamına gelir.
  • Whop uygulamaları için uygulamanın gerekli izinleri İzinler bölümünde istediğini doğrulayın, ardından uygulama ayarlarını kaydedin ve gerektiğinde yeniden yükleyin veya yeniden yetkilendirin.
  • OAuth için yalnızca özelliğinizin ihtiyaç duyduğu kapsamları isteyin, ardından bu kapsamları ekledikten sonra kullanıcının OAuth akışını tamamladığından emin olun.
  • Kontrol panelinde oluşturulan API anahtarları için anahtarın, kimliğini account_id olarak ilettiğiniz hesaba ait olduğunu doğrulayın.
  • Alt hesaplar için, ileteceğiniz hesabı seçmeden önce işlemin sahibinin üst hesap mı yoksa alt hesap mı olması gerektiğini doğrulayın.

OAuth hataları

OAuth hataları, error ve error_description içeren standart bir yük veya yönlendirme sorgu dizesi döndürür.
Yönlendirme URI’leri tam olarak eşleşmelidir. https://example.com/oauth/callback yapılandırdıysanız, https://example.com/oauth/callback/ farklı bir URI’dir.

Ödeme hataları

Checkout öğesi ve iOS ödemesi farklı nedenlerle başarısız olabilir. Bunları aynı şekilde ayıklayın: varyantı veya ödeme yapılandırmasını kontrol edin, hata geri çağırmasını inceleyin ve teslimatı sunucunuzda doğrulayın.

Checkout öğesi

  • onError ekleyin. Öğe yüklenemediğinde veya çöktüğünde, programatik işleme için bir message ve bir code ile çalışır.
  • Uyumluluk özelliği plan değerini iletiyorsanız, varyantın var olduğunu, etkin olduğunu ve beklediğiniz hesaba ait olduğunu doğrulayın.
  • checkoutConfiguration iletiyorsanız, sunucunuzun onu oluşturduğunu ve ch_ kimliğini ilettiğinizi doğrulayın.
  • Her seçenek oluşturma sırasında ayarlanır. Siparişi değiştirmek için update() çağırmak yerine yeni bir ödeme öğesi bağlayın.
  • Başarısız bir ödeme, aynı ödeme ekranını nedeni gösterilmiş şekilde yeniden açar; böylece alıcı yeniden bağlama gerekmeden tekrar ödeme yapabilir.
  • Başarı ve yeniden deneme durumlarını görüntüleyebilen bir rotada returnUrl sağlayın. 3DS veya bir banka sayfası gibi site dışı bir adım alıcıyı oraya geri döndürür.
  • Teslimat için webhook’ları kullanın. Yönlendirme arayüz için yararlıdır, ancak sunucunuz payment.succeeded olayına güvenmelidir.

iOS ödemesi

Beklenen ve beklenmeyen hataları farklı yollarla işleyin:

Webhook teslimatı

Yaygın webhook sorunları:
  • Hiç olay alınmadı: webhook URL’sinin herkese açık olarak erişilebilir olduğunu, https kullandığını ve doğru hesaba ve ortama ait olduğunu doğrulayın.
  • İmza doğrulaması başarısız oluyor: ham istek gövdesini unwrapWebhook fonksiyonuna iletin. Doğrulamadan önce JSON ayrıştırmayın.
  • Yeniden denemeler devam ediyor: doğrulamadan sonra, uzun süren işleri bir arka plan işinde başlatmadan önce hızlıca 2xx yanıtı döndürün.
  • Yinelenen teslimat: Whop webhook’ları en az bir kez teslim eder. webhook-id veya başka bir olay tanımlayıcısını saklayın ve işleyiciyi idempotent hale getirin.
  • Beklenmeyen sıra: olayların kronolojik sırayla geldiğini varsaymayın. Sıra önemliyse kaynağın mevcut durumunu getirin.
Yerel geliştirme için bir tünel ile herkese açık bir URL’yi makinenize yönlendirin ve bu URL’yi kontrol panelindeki webhook ayarlarında kullanın.

Öğe hataları

Her Whop Element bir onError geri çağırması kabul eder. Öğe yüklenemediğinde veya çöktüğünde çalışır ve değer bir message, programatik işleme için isteğe bağlı bir code ve bir host-state kaynağı başarısız olduğunda bir sourceKey taşır. Geliştirme sırasında her zaman ekleyin:
Bir öğe yüklenemezse:
  1. Erişim belirtecinin beklediğiniz hesap için oluşturulduğunu ve öğenin referans sayfasında listelenen kapsamları taşıdığını doğrulayın.
  2. Kendi alan adınızda her zaman bir accessToken iletin. Görüntüleyenin oturumu yalnızca whop.com üzerinde çalışır.
  3. mount çağırmadan önce kapsayıcının var olduğunu doğrulayın. React bileşenleri kendilerini bağlar.
  4. Öğenin başlatılıp başlatılmadığını bilmek için onReady olayını dinleyin.
  5. Öğe kurtarılamaz bir duruma girerse destroy() çağırın ve yeni bir tane oluşturun.
Elements sorun giderme tablosu yaygın belirtileri ve nedenlerini listeler.

Sandbox ve production

Sandbox verileri ve production verileri ayrıdır. Sandbox’tan production’a geçerken:
  • Yeni production API anahtarları oluşturun.
  • SDK ortamını Sandbox yerine Production olarak değiştirin veya 1.x sürümündeki baseUrl / base_url / WithBaseURL sandbox geçersiz kılmasını kaldırın.
  • Yalnızca sandbox’ta bulunan ürünleri, ödeme bağlantılarını, webhook’ları ve alt hesap kayıtlarını production’da yeniden oluşturun.
  • Webhook URL’lerinin yerel bir tünele değil, production altyapısına işaret ettiğini doğrulayın.

Yardım isterken nelerin ekleneceği

Aşağıdakilerden mümkün olduğunca fazlasını ekleyin:
  • Başarısız olan uç nokta, SDK yöntemi veya öğe adı.
  • Ortam: sandbox veya production.
  • Durum kodu, hata gövdesi, OAuth error_description veya öğenin onError değeri.
  • İlgili Whop kimlikleri, gizli bilgiler çıkarılmış olarak.
  • Webhook sorunları için webhook olay kimliği veya webhook-id başlığı.
  • İstemciyi, ödeme sayfasını, OAuth URL’sini, webhook işleyicisini veya öğeyi nasıl oluşturduğunuzu gösteren kısa bir kod parçacığı.

OAuth

OAuth 2.1 + PKCE akışını oluşturun ve belirteç yenilemeyi yönetin.

Webhook'lar

Olayları işlemeden önce imzaları doğrulayın ve yeniden denemeleri yönetin.

İzinler

Uygulama izinlerini seçin ve bunları içerik üreticilerine açıklayın.

Sandbox'ta test edin

Production’a dokunmadan API çağrılarını ve ödeme akışlarını test edin.