Kaydetme akışınızı seçin
Kullanıcının şu anda ödeme de yapıp yapmadığına bağlı olarak iki yol vardır.
Bu sayfanın geri kalanı kurulum modunu baştan sona ele alır, ardından kaydedilen bir yöntemden daha sonra nasıl ücret alınacağını gösterir.
Ödeme öğeleriyle bir ödeme yöntemi kaydedin
Kaydetme formunumode: "setup" ile ödeme öğeleri üzerine kurun. Öğe yalnızca kaydedilebilen yöntemleri sunar, alıcıya kaydın gerektirdiği gelecekte kullanım onayını gösterir ve size bir onay token’ı verir. Bu token’ı sunucunuzdan bir kurulum niyetine dönüştürürsünüz; kurulum niyetinin client_secret değeri de alıcının henüz tamamlamadığı adımları bitirir.
1
Formu kurulum modunda yerleştirin
mode="setup" değerini ve kaydedilen yöntemin kullanılacağı para birimini iletin. Tutar olmadığı için tutar sınırları uygulanmaz. returnUrl değerini https üzerinden barındırdığınız bir sayfaya ayarlayın. Banka kayıtları ve bazı 3D Secure akışları alıcıyı oraya geri getirir.mode="setup" ile yerleştirin.2
Kurulum niyetini sunucunuzda oluşturun
Onay token’ıyla bir kurulum niyeti oluşturun. Whop alıcıyı token’daki e-postadan belirler ve kurulum niyetiyle birlikte
201 Created yanıtı verir. Kurulum niyeti status değerini, alıcının henüz tamamlamadığı adımlar için bir client_secret değerini ve succeeded olduğunda kaydedilen yöntemi payment_method_id olarak taşır. Kaydedilen yöntemi sisteminizdeki bir müşteriye bağlamak için metadata ekleyin. Bu, webhook’ta geri gelir. Yeniden denenen bir isteğin yöntemi asla iki kez kaydetmemesi için bir Idempotency-Key gönderin.3
Bekleyen adımları tamamlayın
succeeded olarak dönen bir kurulum niyetinde yöntem kayıtlıdır. requires_action, alıcının hâlâ 3D Secure veya banka kaydı gibi bir adımı olduğu anlamına gelir. client_secret değerini, ödeme akışının kullandığı çağrıyla aynı olan handleNextAction fonksiyonuna iletin. Bu, bir diyalog içinde satır içi bir adım çalıştırır veya alıcıyı returnUrl adresinize gönderir. Döndürdüğü status değerine göre dallanın: succeeded yöntemin kaydedildiğini, processing kararın hâlâ verilmekte olduğunu gösterir; diğer her şey yeni bir deneme gerektirir. Kapatılan bir diyalog kurulumu hata olmadan requires_action durumunda bırakır ve deneme başarısız olduğunda lastPaymentError nedeni taşır. processing, işlemcinin hâlâ karar vermekte olduğu anlamına gelir; bu nedenle bekleme durumu gösterin ve kaydı aşağıdaki webhook’un doğrulamasına izin verin. canceled, alıcının adımı yarıda bıraktığı veya sağlayıcının yöntemi reddettiği anlamına gelir: last_setup_error sağlayıcının nedenini taşır ve alıcı vazgeçtiğinde null kalır. Durumu bunun yerine sunucunuzdan okumak için kurulum niyetini alın ve aynı status değerine göre dallanın ya da bir adım beklemedeyken daha hafif olan Kurulum durumunu al uç noktasını yoklayın.4
Tamamlanmayı ele alın
Ödeme yöntemi kimliğini ve Ödeme yöntemi artık bu üye için kaydedilmiş ve yetkilendirilmiştir. Kayıtlı bir ödeme yönteminden ücret alın bölümündeki adımlarla ücret alın.
metadata değerinizi geri almak için setup_intent.succeeded webhook’unu dinleyin. Kapatılan bir sekmeden sonra da ulaşan tek sinyal budur ve aynı işleyici aşağıdaki barındırılan akışa da hizmet eder. Kurulum niyeti, görüntüleme için payment_instrument değerini de taşır: bir ad, standart simge seti ve kart için markası, son dört hanesi ve son kullanma tarihi. Kaydedilen yöntemi başka bir istek yapmadan gösterebilirsiniz. API sürümü 2026-09-22-1 öncesine sabitlenmiş webhook’lar, kaydedilen yöntemi bunun yerine payment_method.id olarak taşır.Barındırılan bir ödeme sayfasıyla ödeme yöntemi kaydedin
1
Kurulum modunda bir ödeme yapılandırması oluşturun
Ücret almadan ödeme bilgilerini toplamak için varyant olmadan bir ödeme yapılandırması oluşturun. Üyeyi ve ödeme yöntemini sisteminizdeki bir müşteriye bağlayabilmek için meta veri ekleyin.
2
Kullanıcıyı ödeme sayfasına yönlendirin
Kullanıcının ödeme yöntemini kaydetmesi için Checkout öğesini yerleştirin veya kullanıcıyı yönlendirin.Kurulum modundaki bir yapılandırma, aynı öğeyi bir ödeme yöntemi
kaydı olarak yerleştirir: hiçbir ücret alınmaz ve tamamlanan ödeme sayfası
sorgu dizesinde
- Gömülü
- Yönlendirme
setup_intent_id ile returnUrl adresine yönlendirir. Kaydı
yönlendirmeden değil, setup_intent.succeeded webhook’undan doğrulayın.3
Tamamlanmayı ele alın
Ödeme yöntemi kimliğini almak için Ödeme yöntemi artık bu üye için kaydedilmiş ve yetkilendirilmiştir.
setup_intent.succeeded webhook’unu dinleyin. Kurulum niyeti, üyeyi ve ödeme yöntemini sisteminizdeki bir müşteriye bağlamak için kullanabileceğiniz checkout_configuration_id değerini ve yapılandırmanın metadata değerini taşır.Kaydı, alıcının
redirect_url adresinize ulaşmasından değil webhook’tan doğrulayın. Kapatılan bir sekmeden sonra da ulaşan tek sinyal budur.Kayıtlı bir ödeme yönteminden ücret alın
1
Ödeme yöntemini alın
Bir üye için kayıtlı ödeme yöntemlerini listeleyin veya önceki adımdaki kurulum niyetinden gelen
payment_method_id değerini kullanın.2
Oturum dışı bir ödeme oluşturun
Müşteri etkileşimi olmadan ödeme yönteminden ücret alın. Ödeme oluşturma uç noktası hemen bir ödeme nesnesi döndürür ve ücretlendirmeyi eşzamansız olarak işler.
3
Ödeme olaylarını ele alın
Başarıyı veya başarısızlığı takip etmek için ödeme webhook’larını dinleyin.
Ödeme sırasında kaydedin
Alıcıdan ücret alırken bir ödeme yöntemini kaydetmek için ödeme sayfasını ödeme öğeleri üzerine kurun vePayments tanıtıcısında setupFutureUsage: "off_session" iletin. Öğeler alıcıya kaydetme onayını gösterir ve bunu onay token’ına kaydeder; ödeme de yöntemi yalnızca bu onay doğrulandığında kasaya kaydeder.
Bir varyant seçmeye yönelik Elements özelliği, uyumluluk için plan adını korur.
1
Formu kaydetme onayıyla yerleştirin
createConfirmationToken ve handleNextAction fonksiyonlarını adım adım anlatır.2
Ödemeyi onay token'ıyla oluşturun
Oluşturma yanıtı, ödemenin sonucu değil, açıldığı hâlidir. Kaydedilen yöntemin
payment_method_id değeri, ücretlendirme tamamlandığında payment.succeeded webhook’unda gelir.3
Daha sonra ücret alın
payment_method_id, Kayıtlı bir ödeme yönteminden ücret alın bölümünde kullanılacak payt_ yöntemidir. Hiçbir şey kaydedilmediğinde null kalır. payment.succeeded webhook’u aynı alanı taşır ve kapatılan bir sekmeden sonra da çalışan yol budur.Sonraki adımlar
Ödeme kabul edin
Kaydetme akışınızla birlikte kullanabileceğiniz tek seferlik ve abonelik ödeme sayfaları.
Checkout öğesi
Whop Elements ile Whop ödeme sayfasını kendi sitenize yerleştirin.
Webhook'ları dinleyin
setup_intent.succeeded, payment.succeeded ve payment.failed olaylarını takip edin.Faturalandırma portalı
Müşterilerin kayıtlı ödeme yöntemlerini yönetmesine ve kaldırmasına izin verin.

