Skip to main content
Bu hızlı başlangıç, paranın hiçbir zaman hareket etmediği ayrı bir Whop ortamı olan sandbox’ta çalışır. Bir sandbox API anahtarı alacak, ilk çağrınızı yapacak, bir ödeme sayfası oluşturacak, bunu bir test kartıyla ödeyecek ve payment.succeeded webhook’unu sunucunuzda alacaksınız. Canlıya geçmek son adımdır ve büyük ölçüde anahtarları değiştirmekten ibarettir.
Bir kodlama ajanı kullanıyorsanız, ona bu sayfayı Markdown olarak (https://docs.whop.com/developer/quickstart.md) verin veya Genel bakış sayfasındaki istemi yapıştırın.

Sandbox ve production

Whop, hiçbir şey paylaşmayan iki ortam çalıştırır: ne hesaplar, ne anahtarlar, ne ürünler, ne de webhook’lar. Sandbox’ta geliştirir, production’da yayına alırsınız. Aşağıdaki her değer bu iki ortam arasında değişir.
Sandbox ve production API anahtarları birebir aynı görünür; bu nedenle bir anahtardaki hiçbir şey hangi ortama ait olduğunu söylemez. Bu sayfadaki kod parçacıkları ortamı sabit kodlamak yerine bir WHOP_ENVIRONMENT değişkeninden seçer, böylece aynı kod her iki ortamda da çalışır. Whop MCP sunucusu yalnızca production verileri üzerinde işlem yapar.

Bir sandbox API anahtarı alın

1

Sandbox'a kaydolun

sandbox.whop.com adresine gidin ve bir hesap oluşturun. Bu hesap, whop.com’daki herhangi bir hesabınızdan ayrıdır. Kayıt akışı ilk işletmenizi oluşturur; bu, API anahtarlarına, ürünlere, webhook’lara ve ödemelere sahip olan Hesaptır.
2

Bir Hesap API anahtarı oluşturun

sandbox.whop.com/dashboard/developer adresini açın. Account API Keys bölümünde Create seçeneğini seçin ve anahtara Local development gibi bir ad verin.Bu hızlı başlangıç için Admin rolünü kullanın. Production’a geçmeden önce yalnızca çağırdığınız uç noktaları kapsayan özel bir izin setine geçin.
3

Anahtarı sunucunuzda saklayın

Whop anahtarı gösterdiğinde kopyalayın ve ait olduğu ortamla birlikte yerel .env dosyanıza koyun:
Bir anahtar adı, maskelenmiş değer ve Create düğmesini gösteren Whop kontrol paneli Account API Keys bölümü
WHOP_API_KEY değerini sunucunuzda tutun. API anahtarlarını tarayıcı koduna, mobil uygulamalara veya herkese açık depolara koymayın. Sandbox ve production anahtarları birebir aynı göründüğünden, onları birbirinden ayırt edebileceğiniz şekilde adlandırın.
Sunucunuz kendi işletmeniz adına işlem yaptığında doğru seçim bir Hesap API anahtarıdır. Diğer işletmelerin yüklediği bir uygulama geliştirmek veya kullanıcıların Whop ile oturum açmasını sağlamak için Kimlik doğrulama ve API anahtarları sayfasına bakın.

SDK’yı yükleyin

Bu sayfa SDK 2.7.0 veya üzerini gerektirir. Önceki sürümler ödeme yapılandırmalarında satır içi variant değerini kabul etmez.

İlk çağrınızı yapın

İstemciyi WHOP_ENVIRONMENT içinde belirtilen ortama yönlendirin ve anahtarınızın arkasındaki hesabı getirin. Bu, anahtarın çalıştığını doğrular ve biz_ ile başlayan hesap kimliğinizi yazdırır.
Bu sizin sandbox hesabınız. Anahtar çalışıyor.

Bir ödeme sayfası oluşturun

Tek bir çağrı bir varyant oluşturur ve sandbox.whop.com üzerinde barındırılan bir ödeme sayfası olan purchase_url değerini döndürür.
Bu URL’yi ödeme adımında açacaksınız. Zaten bir varyantınız varsa, satır içi variant yerine kimliğini variant_id olarak iletin. İkisini birden gönderemezsiniz. Create Checkout Configuration, yinelenen fiyatlandırma, deneme süreleri ve yönlendirme URL’leri dahil tüm seçenekleri listeler.

Webhook’u dinleyin

payment.succeeded olayının ulaşacağı bir yer olması için ödeme yapmadan önce uç noktanızı kurun.
1

Bir uç nokta ekleyin

İmzayı doğrulayan ve olayı günlüğe kaydeden bir POST rotası ekleyin. Doğrulama ham istek gövdesini gerektirir, bu yüzden herhangi bir JSON ayrıştırmasından önce onu okuyun.
Geliştirme sırasında rotayı ngrok, Cloudflare Tunnel veya başka bir tünel ile HTTPS üzerinden erişilebilir hale getirin.
2

Webhook'u sandbox kontrol panelinde oluşturun

Sandbox kontrol panelinde Developer > Webhooks bölümünü açın, ardından Create webhook seçeneğini seçin. Uç noktanızın HTTPS adresini yapıştırın, API sürümünü v1 olarak bırakın ve payment.succeeded olayını seçin.
Olaylar listesinde payment_succeeded olayının seçili olduğu webhook oluşturma formu
3

İmzalama gizli anahtarını saklayın

Gizli anahtarı webhook’un Secret sütunundan kopyalayın ve ws_ öneki dahil, tam olarak gösterildiği gibi .env dosyasına ekleyin:
Yeni değeri alması için sunucunuzu yeniden başlatın.

Bir test kartıyla ödeyin

Ödeme sayfası adımındaki purchase_url adresini açın ve şu bilgilerle ödeyin: Birkaç saniye içinde sunucunuz payment.succeeded olayını ve pay_ ile başlayan ödeme kimliğini günlüğe kaydeder.
Bir ödeme aldınız ve webhook’unu uçtan uca işlediniz. Hiçbir ücret tahsil edilmedi.
Reddedilen bir kartı veya 3D Secure’u test etmek için Test kartları bölümündeki diğer numaraları kullanın. Hiçbir şey gelmezse, kontrol panelindeki webhook’un teslimat günlüğünü ve Webhook teslimatı bölümünü kontrol edin.

Canlıya geçin

Sandbox ve production hiçbir şey paylaşmaz; bu nedenle canlıya geçmek, kurulumu whop.com üzerinde production kimlik bilgileriyle tekrarlamak anlamına gelir. Kodunuz değişmez. Yalnızca ortamınızdaki değerler değişir.
1

Bir production anahtarı oluşturun

whop.com adresinde oturum açın, whop.com/dashboard/developer adresini açın ve yalnızca entegrasyonunuzun kullandığı izinlere sahip bir Hesap API anahtarı oluşturun.
2

Her değeri production karşılığıyla değiştirin

Production ortamınızda üç değişkenin hepsini production değerlerine ayarlayın. Bir sandbox anahtarını veya gizli anahtarını asla production’da yeniden kullanmayın; tersini de yapmayın.
API’yi doğrudan çağırıyorsanız, temel URL’yi https://api.whop.com/api/v1 olarak değiştirin.
3

Sandbox'ta oluşturduklarınızı yeniden oluşturun

Ürünler, varyantlar, ödeme yapılandırmaları ve webhook’lar aktarılmaz. Production webhook’unu production URL’nize göre oluşturun ve yeni imzalama gizli anahtarını saklayın.
4

API sürümünüzü sabitleyin

SDK, karşısında derlendiği sürümü gönderir. API’yi doğrudan çağırıyorsanız, sonraki değişikliklerin yanıtlarınızı değiştirmemesi için her istekte Api-Version-Date gönderin. Bkz. API sürümleme.
Production ödeme bağlantıları gerçek para tahsil eder. Ücret oluşturan veya bakiye taşıyan herhangi bir şeyi çalıştırmadan önce hangi anahtarı kullandığınızı kontrol edin.

Şimdi asıl amacınız olanı geliştirin

Abonelik veya tek seferlik bir ürün satıyorsunuz

Ödeme bağlantıları, Checkout öğesi, varyantlar ve deneme süreleri.

Sizden başka kişilere borçlusunuz

Ödemeler, transferler, bakiyeler ve ödeme portalı.

Başkalarının sattıklarından pay alıyorsunuz

Alt hesaplar, onlar adına tahsilat ve onlara ödeme yapma.

Yalnızca altyapı değil, dağıtım da istiyorsunuz

Kimlik doğrulama, görünümler ve CLI ile Whop içinde çalışan uygulamalar.

Ürününüz insanların birbiriyle konuşmasını gerektiriyor

Yerleştirebileceğiniz sohbet, DM’ler ve forumlar.

Sadece referansı okumak istiyorsunuz

Current API’deki her kaynak, her uç noktada bir deneme alanıyla birlikte.