Skip to main content
Ödeme öğelerinin kurulum modunda topladığı bir onay token’ından veya yeniden doğrulamak için zaten kayıtlı bir ödeme yönteminden bir tane oluşturun. Bir ödemeyle aynı toplama akışını çalıştırır, bu yüzden alıcının hâlâ bir adımı tamamlaması gerekebilir: kartta 3D Secure, barındırılan bir kayıt veya bir banka hesabını bağlama. Oluşturma yanıtı, sonucu değil, oluşturulduğu hâliyle kurulum amacıdır. client_secret değerini öğelerin handleNextAction işlevine verin veya kurulumun ne kadar ilerlediğini ve neyin beklemede olduğunu öğrenmek için Durumu al ile yoklama yapın. succeeded durumuna ulaştığında, payment_method_id kayıtlı yöntemi belirtir ve Ödeme Oluştur ondan tahsilat yapar.

Uç noktalar

Öznitelikler

string
gerekli
sint_ önekli kurulum amacı kimliği.
string | null
gerekli
Ödeme yönteminin kaydedildiği biz_ önekli hesap.
string | null
gerekli
Bu kurulumun oluşturulduğu ch_ önekli ödeme yapılandırması. Barındırılan bir ödeme sayfası yerine bu API aracılığıyla oluşturulan bir kurulum için null.
string | null
gerekli
Alıcının arayüzünün bu kurulumu yoklamak ve dönüş URL’sini ayarlamak için sunduğu kimlik bilgisi — bunu öğelerin handleNextAction işlevine verin. Yalnızca bu API aracılığıyla oluşturulan kurulumlarda bulunur ve listeleme yanıtlarında her zaman null’dır — bunun için kurulum amacını alın.
string
gerekli
Kurulum amacının oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
object | null
gerekli
Kurulumun neden olduğu yerde sona erdiği veya hiçbir şey başarısız olmadıysa null. canceled durumunda bulunur — vazgeçen bir alıcı kod taşımaz, sağlayıcı tarafından reddedilen ise taşır. Kurulum başarılı olduğunda kaldırılır.

Özellikler

string | null
gerekli
Başarısızlığın makine tarafından okunabilir sınıflandırması, ör. enrollment_declined. Alıcı yalnızca kurulumdan vazgeçtiyse bulunmaz.
string | null
gerekli
Başarısızlığın insan tarafından okunabilir açıklaması.
string | null
gerekli
Alıcının hesaptaki mber_ önekli üye kaydı. Çağıran alıcı değilse, member:basic:read izni olmadan null.
object | null
gerekli
Kurulum amacı oluşturulurken eklenen kendi anahtar-değer verileriniz.
object | null
gerekli
Bu kurulumun arkasındaki yöntem, görüntüleme için biçimlendirilmiş: alıcıya yönelik bir ad, standart simge seti ve kartsa kartın markası, son dört hanesi, kart veren kuruluş kimlik numarası, son kullanma tarihi ve ağ işlem kimliği. Bir yöntem toplanana kadar null.

Özellikler

object | null
gerekli
Yalnızca kart, Apple Pay ve Google Pay ödemeleri: kartın ağı, son dört hanesi, kart veren kuruluş kimlik numarası, son kullanma tarihi ve ağ işlem kimliği.

Özellikler

string | null
gerekli
card.networks girdileri ve kayıtlı kart ödeme yöntemleriyle eşleşen ağ tanımlayıcısı (visa, amex, …). Kasa ağı kaydetmediyse null.
number | null
gerekli
Kartın son kullanma ayı, 1 ile 12 arası. Kasa bunu kaydetmediyse null.
number | null
gerekli
Kartın dört haneli son kullanma yılı. Kasa bunu kaydetmediyse null.
string | null
gerekli
BIN olarak da adlandırılan kart veren kuruluş kimlik numarası: kartı veren bankayı tanımlayan kartın ilk altı veya sekiz hanesi. İşlemci bildirmediyse null.
string | null
gerekli
Yakalandığında kartın son dört hanesi.
string | null
gerekli
Bu hesabın kart için kullandığı ağ işlem kimliği. Whop’ta varsa, kart üzerindeki ilk müşteri huzurundaki tahsilatından veya doğrulamasından gelen bu hesabın kendi kimliğidir. Aksi takdirde bu kart için daha önceki bir ağ işlem kimliğidir; başka bir hesabın işleminden gelebilir veya kartla birlikte getirilmiş olabilir. Bu hesapta bu kartın daha sonraki satıcı tarafından başlatılan bir tahsilatında önceki işlem olarak bunu belirtin. Bir tane olana kadar null. Bir ödeme ilk kaydedilirken gönderilen bir webhook null taşıyabilir, bu yüzden okumak için ödemeyi alın.
string
gerekli
Alıcıya yönelik araç adı — kart göründüğünde “Visa •••• 4242”, aksi takdirde yöntemin kendi adı (“Klarna”).
object
gerekli
Standart simge seti: kare ve kart şekilleri, her biri açık ve koyu renk düzenlerinde.

Özellikler

object
gerekli
Kredi kartı oranlarında karo (48x30).

Özellikler

object
gerekli
Koyu yüzeyler için renk düzeni.

Özellikler

string
gerekli
Şeklin doğal boyutunda raster yedeği.
string
gerekli
Çift yoğunlukta raster yedeği.
string
gerekli
Dört kat yoğunlukta raster yedeği.
string
gerekli
Vektör dosyası. SVG’nin görüntülendiği her yerde bunu tercih edin.
object
gerekli
Açık yüzeyler için renk düzeni.

Özellikler

string
gerekli
Şeklin doğal boyutunda raster yedeği.
string
gerekli
Çift yoğunlukta raster yedeği.
string
gerekli
Dört kat yoğunlukta raster yedeği.
string
gerekli
Vektör dosyası. SVG’nin görüntülendiği her yerde bunu tercih edin.
object
gerekli
Kare karo (32x32).

Özellikler

object
gerekli
Koyu yüzeyler için renk düzeni.

Özellikler

string
gerekli
Şeklin doğal boyutunda raster yedeği.
string
gerekli
Çift yoğunlukta raster yedeği.
string
gerekli
Dört kat yoğunlukta raster yedeği.
string
gerekli
Vektör dosyası. SVG’nin görüntülendiği her yerde bunu tercih edin.
object
gerekli
Açık yüzeyler için renk düzeni.

Özellikler

string
gerekli
Şeklin doğal boyutunda raster yedeği.
string
gerekli
Çift yoğunlukta raster yedeği.
string
gerekli
Dört kat yoğunlukta raster yedeği.
string
gerekli
Vektör dosyası. SVG’nin görüntülendiği her yerde bunu tercih edin.
number | null
gerekli
Yalnızca taksitli yöntemler: tahsilatın kaç ödemeye bölündüğü. Metin değil, veridir — etiketi istemci tarafında oluşturun ve çevirin.
string
gerekli
Ödeme yöntemi türü tanımlayıcısı, ör. card, klarna, apple_pay.
string | null
gerekli
Ödeme Oluştur ile tahsilata hazır, payt_ önekli kayıtlı ödeme yöntemi. Kurulum succeeded olana kadar null.
string | null
gerekli
Kaydedilen aracın türü, örneğin card veya us_bank_account.
string | null
gerekli
Alıcının site dışı bir adımı tamamladıktan sonra ulaştığı yer veya onları oldukları yerde bırakmak için null.
string
gerekli
Kurulumun ne kadar ilerlediği. 201 veya 200, yöntemin kaydedildiği değil, yanıt verdiğimiz anlamına gelir — her zaman buna göre dallanın. requires_action — alıcının bekleyen bir adımı var; client_secret değerini öğelere verin veya Kurulum durumunu al ile yoklama yapın. processing — işlemci karar veriyor. succeeded — yöntem kaydedildi ve yalnızca bu durum kaydedildi anlamına gelir. canceled — vazgeçildi veya reddedildi; last_setup_error alanına bakın.Kullanılabilir seçenekler: processing, succeeded, canceled, requires_action
string | null
gerekli
Desteklenen oturum içi kart ödemeleri için 3D Secure davranışı. mandate_challenge, ödeme işlenmeden önce bir 3DS doğrulaması gerektirir; mandate_if_required, yalnızca ödeme işlemcisi gerektirdiğinde doğrulamayı zorunlu kılar; frictionless_if_required, normal sürtünmesiz 3DS akışını kullanır. 1.000 $ veya üzeri ödemeler, mandate_challenge seçilmedikçe mandate_if_required kullanır. Risk ve kimlik doğrulama kurtarma gereksinimleri tercihi geçersiz kılabilir. Bu kurulum için istenen ayar veya ayarlanmamışsa null.Kullanılabilir seçenekler: mandate_challenge, mandate_if_required, frictionless_if_required
boolean
gerekli
Alıcı bu ödeme yöntemini kaydederken 3D Secure’u tamamladığında true.
string
gerekli
Kurulum amacının en son güncellendiği zaman, ISO 8601 zaman damgası olarak.
object | null
gerekli
Ödeme yöntemini kaydeden kullanıcı. Alıcı kullanıcı yerine bir hesap olduğunda null.

Özellikler

string
gerekli
user_ önekli kullanıcı kimliği.
string | null
gerekli
Görünen ad.
object
gerekli
Avatar sarmalayıcısı. url değeri her zaman mevcuttur ve kullanıcı resim ayarlamadıysa oluşturulmuş bir yer tutucudur.

Özellikler

string
gerekli
Avatar görsel URL’si. Her zaman mevcuttur. Kullanıcı resim ayarlamadıysa oluşturulmuş bir yer tutucudur.
string
gerekli
Herkese açık kullanıcı adı.
SetupIntent