Skip to main content
Kullanıcıların web sitenizde veya uygulamanızda Whop ile oturum açmasını sağlamak için OAuth 2.1 + PKCE’yi OpenID Connect (OIDC) ile birlikte kullanın. Döndürülen erişim token’ları, verilere erişmenizi ve bu kullanıcılar adına işlem yapmanızı sağlar.
OAuth uç noktaları https://api.whop.com/oauth/ adresinde bulunur.

Adım 1: OAuth uygulamanızı oluşturun

Güncel @whop/sdk içindeki apps.create tarafından döndürülen App nesnesi bir client_secret alanı sunmaz. Bunun yerine istemci sırrını Dashboard sekmesinden kopyalayın.
Programatik olarak bir OAuth uygulaması oluşturmak için Create App uç noktasını kullanın:
Yönlendirme URI’lerini daha sonra Update App uç noktasıyla güncelleyin.

Adım 2: Kullanıcıları yetkilendirmeye gönderin

Web veya mobil istemcinizde, kullanıcıları güvenli bir şekilde Whop’un OAuth akışına yönlendirmek için PKCE kullanın.
Kullanıcıyı yönlendirmek için startWhopOAuth çağırın:
Kullanıcı oturum açmamışsa Whop oturum açmasını ister, ardından onay ekranını gösterir. Kullanıcı uygulamanızı istenen kapsamlar için zaten onaylamışsa, iki kez onaylamasına gerek kalmadan otomatik olarak geri yönlendirilir.
company_id olarak bir hesap kimliği iletirseniz token’lar kullanıcı için o hesapla sınırlandırılır. Yalnızca kullanıcının o Whop hesabında kontrol edebildiği kaynaklara erişebilirsiniz.

Adım 3: Geri çağrıyı işleyin ve kodu takas edin

Whop, code ve state ile redirect_uri adresinize geri yönlendirir. State’i doğrulamak, kodu token’larla takas etmek ve kimlik bilgilerini almak için bu fonksiyonu kullanın:
Geri çağrı sayfanızda:

Adım 4: Token’ları kullanın

Whop SDK’sını kullanıcının erişim token’ı ile başlatın:
Kullanılabilir tüm uç noktaları görmek için API referansına bakın.

Adım 5: Token’ları yenileyin

Erişim token’larının süresi 1 saat sonra dolar. Yeni kimlik bilgileri almak için yenileme token’ını kullanın:
Kullanım:
Yenileme token’ları her kullanımda değişir. Yenileme uç noktasından döndürülen yeni token’ları her zaman saklayın. Yetkilendirme sırasında company_id sağladıysanız, yenileme sırasında da aynı company_id değerini sağlamanız gerekir.

Adım 6: Kullanıcı bilgisi ve iptal

Kullanıcı bilgisini alın

Kimliği doğrulanmış kullanıcının profilini userinfo uç noktasını kullanarak getirin:
Döndürülen alanlar verilen kapsamlara bağlıdır. openid zorunludur, profile ad/kullanıcı adı/resim ekler, email e-posta alanlarını ekler.

Oturum kapatılırken token’ları iptal edin

Bir kullanıcı oturumu kapattığında yenileme token’ını iptal edin. Erişim token’larının süresi 1 saat sonra dolar ve sunucu tarafında iptal edilemezler.
Kullanıcılar oturumu kapattığında token’ları her zaman iptal edin. Bu, yenileme token’ını anında geçersiz kılar ve token ele geçirilmiş olsa bile yetkisiz erişimi önler.

Hata işleme

OAuth hataları standart biçimi izler:
Yaygın hata kodları:
  • invalid_request: eksik veya geçersiz parametre.
  • invalid_grant: kodun veya token’ın süresi dolmuş ya da iptal edilmiş.
  • invalid_client: bilinmeyen client_id.
  • insufficient_scope: token gerekli kapsama sahip değil.
  • rate_limit_exceeded: çok fazla istek (Retry-After başlığını kontrol edin).

Sonraki adımlar

API referansı

Verilen bir erişim token’ının çağırabileceği her uç nokta.

Ödeme kabul edin

Uçtan uca satın alma akışları için oturum açmayı ödeme sayfasıyla birleştirin.

Webhook'ları dinleyin

Ödeme, üyelik ve giriş olaylarına sunucu tarafında tepki verin.

İzin isteyin

Uygulamanızın gerçekten ihtiyaç duyduğu OAuth kapsamlarını yapılandırın.