Checkout Analiz Akışı
Hosted Checkout Form, bir ödemenin başında sizin için bir identity analizi çalıştırır. Canlı bir identity oturumu bootstrap eder, ortaya çıkan snapshot'ı ve imzalı bir assertion'ı ödeme intent'ine bağlar ve — Identity–Payment tesisatının geri kalanının aksine — bu tek çağrı müşteri-görünürdür: checkout formu bunu tarayıcıda yapar. Bu sayfa akışı uçtan uca yürütür.
Ödeme yolunda bir identity bootstrap'ının görünür bir tarayıcı isteği olduğu tek yer burasıdır. Ondan sonraki her şey (snapshot'ı fraud'a çözmek, profilleri geri beslemek) sizin asla çağırmadığınız platform-içi gRPC'dir.
Bootstrap çağrısı
Checkout'un başında form şunu yapar:
POST api/v1/payments/form/live-analyzeBu bir payment-service çağrısıdır — endpoint'in sahibi Identity değil, ödeme yığınıdır. İçeride bir identity canlı analizi sürer, ama siz (ve alıcının tarayıcısı) yalnız bu tek payment-form isteğini görürsünüz.
Nasıl çalışır
Form canlı bir oturum bootstrap eder
Checkout formu POST api/v1/payments/form/live-analyze çağırır. Ödeme yığını, arkasındaki oturum için canlı bir identity analizi çalıştırır.
Identity bir snapshot ve imzalı bir assertion üretir
Identity, IdentityDecisionSnapshot ile birlikte imzalı bir identity assertion döndürür — snapshot'ın asimetrik imzalı bir beyanı; alt-akıştaki bir servis körü körüne güvenmek yerine bunu doğrulayabilir. Bkz. Assertion & JWKS.
İkisi de ödeme intent'ine bağlanır
Snapshot ve assertion ödeme intent'ine (intent.metadata) yazılır ve intent üzerindeki browserFingerprint doldurulur. Tarayıcıya bir sessionProof cookie'si verilir; bu, o tarayıcıyı bu ödeme oturumuna bağlar.
Ödeme identity iliştirilmiş halde ilerler
Buradan sonra ödeme, kendisine bağlanmış identity delili ile devam eder — external risk modunu etkinleştirdiyseniz tartılmaya hazır (bkz. Ödeme Kararında Identity).
Ne bağlanır
| Delil | Nereye iner |
|---|---|
| Identity snapshot | Ödeme intent'inde intent.metadata |
| İmzalı identity assertion | intent.metadata (JWKS ile doğrulanabilir) |
browserFingerprint | Intent üzerinde doldurulur |
sessionProof | Alıcının tarayıcısına verilen bir cookie |
Zorunlu ön-koşul
Bootstrap opsiyonel bir zenginleştirme değil, zorunlu bir kapıdır. Ödeme, boş ya da eksik bir identity analizi üzerinden ilerleyemez.
Analiz bitmediyse — analysisStatus, completed dışında bir şeyse ya da snapshot / assertion boş döndüyse — ödeme RISK_CHECK_FAILED ile durdurulur. Tamamlanmış bir identity bootstrap'ı, intent'in ilerlemesi için katı bir ön-koşuldur; sessiz bir atlama yoktur.
| Koşul | Sonuç |
|---|---|
snapshot + assertion ile analysisStatus === 'completed' | Intent'e bağlanır; ödeme ilerler |
analysisStatus !== 'completed' | RISK_CHECK_FAILED |
| Boş snapshot ya da assertion | RISK_CHECK_FAILED |
Sıradaki adımlar
- Ödeme Kararında Identity — bağlanan snapshot, iliştirildikten sonra ne yapar.
- Checkout Form — bu bootstrap'ı çalıştıran hosted ödeme formu.
- Assertion & JWKS — imzalı identity assertion'ı doğrulamak.
- Risk Snapshot — intent'e bağlanan her alan.