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: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:
API kimlik doğrulaması
Kodun çalıştığı yere uyan kimlik bilgisini kullanın.
Bir API isteği başarısız olursa:
- Ortamın anahtarla eşleştiğini doğrulayın: production anahtarları için SDK’nın
Productionortamı (varsayılan), sandbox anahtarları içinSandbox; API’yi doğrudan çağırıyorsanızhttps://api.whop.com/api/v1vehttps://sandbox-api.whop.com/api/v1. - Kimliklerin dahili sayısal kimlikler değil,
biz_,user_,mem_,plan_,prod_,app_,pay_veyach_gibi Whop etiket önekleri kullandığını doğrulayın. - HTTP durumunu, yanıt gövdesini, uç noktayı ve Whop döndürüyorsa istek kimliğini günlüğe kaydedin.
- Yalnızca hata geçiciyse veya hız sınırına takıldıysa yeniden deneyin.
401,403veya doğrulama hatalarını isteği değiştirmeden yeniden denemeyin.
İ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_idolarak 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.
Ö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
onErrorekleyin. Öğe yüklenemediğinde veya çöktüğünde, programatik işleme için birmessageve bircodeile çalışır.- Uyumluluk özelliği
plandeğerini iletiyorsanız, varyantın var olduğunu, etkin olduğunu ve beklediğiniz hesaba ait olduğunu doğrulayın. checkoutConfigurationiletiyorsanız, sunucunuzun onu oluşturduğunu vech_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
returnUrlsağ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.succeededolayı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,
httpskullandığı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
unwrapWebhookfonksiyonuna 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
2xxyanıtı döndürün. - Yinelenen teslimat: Whop webhook’ları en az bir kez teslim eder.
webhook-idveya 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.
Öğe hataları
Her Whop Element bironError 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:
- Erişim belirtecinin beklediğiniz hesap için oluşturulduğunu ve öğenin referans sayfasında listelenen kapsamları taşıdığını doğrulayın.
- Kendi alan adınızda her zaman bir
accessTokeniletin. Görüntüleyenin oturumu yalnızca whop.com üzerinde çalışır. mountçağırmadan önce kapsayıcının var olduğunu doğrulayın. React bileşenleri kendilerini bağlar.- Öğenin başlatılıp başlatılmadığını bilmek için
onReadyolayını dinleyin. - Öğe kurtarılamaz bir duruma girerse
destroy()çağırın ve yeni bir tane oluşturun.
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ı
SandboxyerineProductionolarak değiştirin veya 1.x sürümündekibaseUrl/base_url/WithBaseURLsandbox 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_descriptionveya öğeninonErrordeğeri. - İlgili Whop kimlikleri, gizli bilgiler çıkarılmış olarak.
- Webhook sorunları için webhook olay kimliği veya
webhook-idbaş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.

