Skip to main content
Abonelikler, yenilemeler veya kullanıma dayalı faturalandırma için müşterilerden otomatik olarak ücret almak üzere kayıtlı ödeme yöntemlerini kullanın. Müşteri kartını Whop’un barındırılan veya gömülü bir akışıyla bir kez kaydeder ve siz de sonrasında istediğiniz zaman ücret alabilirsiniz.
Bu kılavuzu webhook’larla birlikte kullanın: kaydı doğrulamak için setup_intent.succeeded olayını, ardından gelecekteki ücretlendirmeleri takip etmek için payment.succeeded / payment.failed olaylarını dinleyin.

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 formunu mode: "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.
Token, öğenin gösterdiği onayı taşır. Ödeme modundaki bir formdan toplanan token kurulum niyeti tarafından reddedilir; bu nedenle alıcı ödeme yapmıyorsa 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 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.
Ö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.

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 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 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.
Örnek, 200 yanıtı verdikten sonra işleyiciyi çalıştırmak için @vercel/functions paketindeki waitUntil fonksiyonunu kullanır. Diğer çalışma ortamlarında (Bun, Cloudflare Workers, Fastify, Hono) bunu framework’ünüzün eşdeğer arka plan görevi yapısıyla veya bir iş kuyruğuyla değiştirin. Python ve Ruby işleyici eşdeğerleri için webhook kılavuzuna bakın.
Ödeme yöntemi artık bu üye için kaydedilmiş ve yetkilendirilmiştir.

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.
Mevcut varyantları satır içinde oluşturulan fiyatlandırmayla karıştırmak için line_items da gönderebilirsiniz. Her kalem, variant_id veya variant değerlerinden tam olarak birini alır:
Bir varyant oluşturmak, payment:charge izninin yanı sıra plan:create iznini de gerektirir. product_id ile eşleşen bir varyantı yeniden kullanmak yalnızca payment:charge gerektirir. Satır içi bir product tanımı ayrıca ürünü oluşturmak için access_pass:create veya mevcut bir ürünü güncellemek için access_pass:update gerektirir. Varyantlar ödeme hesabına ait olmalı ve sepetin uyumluluk kurallarını karşılamalıdır. Satır içi variant, üst düzey bir variant ile aynı bul-veya-oluştur davranışını kullanır. Yeni bir varyantı zorlamak için force_create_new_plan: true iletin. İç içe varyant ve ürün alanları Api-Version-Date değerini izler ve bilinmeyen özellikler reddedilir. İsteği başka bir ödeme oluşturmadan yeniden oynatmak için bir Idempotency-Key kullanın.İndirim uygulamak için promosyon kodlarınızdan birinin kimliğini promo_code_id olarak iletin; Whop indirimli fiyatı sizin için hesaplar. Promosyon kodu etkin ve varyant için geçerli olmalı, varyant da bir ürüne ait olmalıdır.
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 ve Payments 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

Ödeme öğeleriyle bir ödeme sayfası oluşturun sayfası ödeme düğmesini, 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.