SDK'da Ödeme Bağlamı

Bir ödemeye ait tarayıcı oturumunu skorladığınızda, ödemenin tanımlayıcılarını identity client'ına ekleyin. Bunlar SDK'nın yaptığı her isteğe iliştirilir; böylece analiz — ve ondan sonraki her olay — ait olduğu ödemeye göre sorgulanabilir olur. Bu, aynı headless Web SDK'dır; bu sayfa yalnız ödemeye özel yapılandırmayı kapsar.

Buradaki hiçbir şey SDK'nın ne yaptığını değiştirmez. analyze() yine risk snapshot'ını döndürür ve kararı yine siz verirsiniz. Ödeme alanları korelasyon bağlamıdır — analizi etiketler ki sonradan ödemeye bağlanabilsin.

Ödeme yapılandırma alanları

Alan	Amaç
`paymentId`	Bu analizin ait olduğu ödeme. Her identity isteğine iliştirilir.
`checkoutSessionId`	Henüz bir payment id yokken checkout oturumu.
`subjectId`	Kimi skorladığınız (müşteri id'niz). Verilmezse ödeme id'lerine düşer — aşağıya bakın.
`includeFraudDecision`	Analizin ayrıca bir fraud kararı taşımasını isteyen opsiyonel bayrak. Aşağıdaki uyarıya bakın.

const client = await Lunixi.identity.init({
  sessionBootstrapUrl: '/lunixi/identity/session',
  subjectId: 'cus_8f2a9c',
  paymentId: 'pay_01HV3K...',
  checkoutSessionId: 'cks_7bd2...',
  productContext: 'checkout',
  includeFraudDecision: false,
});
const snapshot = await client.analyze();

Subject fallback

subjectId, analizin altında dosyalandığı kimliktir. Ayarlamazsanız SDK bir fallback uygular; böylece analiz asla anonim olmaz:

`subjectId`

Varsa olduğu gibi kullanılır.

`paymentId`

subjectId yoksa payment id subject olur.

`checkoutSessionId`

İkisi de yoksa checkout session id subject olur.

⚠️

Elinizde varken her zaman açık bir subjectId (stabil müşteri id'niz) verin. paymentId'ye düşmek her ödemeyi farklı bir subject altında dosyalar; bu da snapshot'ın üzerine kurulduğu subject-başı süreklilik geçmişini parçalar.

traceId korelasyonu

analyze(), yanıt zarfında (meta.traceId) bir traceId döndürür. SDK aynı traceId'yi ardından gelen track() / trackBatch() olaylarına taşır; böylece bir analiz ve tüm alt olayları tek bir korelasyon id'sini paylaşır.

const snapshot = await client.analyze();
// meta.traceId bu analizi aşağıdaki olaylara bağlar
await client.track('checkout_step', { step: 'review' });

Analiz ayrıca paymentId / checkoutSessionId ile de etiketlendiğinden, sonradan identity izini, olaylarını ve ödemeyi iki taraftan da hizalayabilirsiniz.

includeFraudDecision bayrağı

includeFraudDecision katı bir boolean, default kapalıdır. İstek-şekillendiren bir bayraktır: analizin snapshot'ın yanında ayrıca bir fraud kararı taşımasını ister.

⚠️

includeFraudDecision'ı opsiyonel bir istek bayrağı olarak görün, bir garanti olarak değil. Bunu ayarlamak, SDK yanıtında bir fraud kararının döneceğini vaat etmez — bir tane doldurulup doldurulmayacağı hesabınızın backend yapılandırmasına bağlıdır. Bu bayraktan bir fraud verdict'i zorunlu kılan client mantığı kurmayın. Fraud'un ödemeye gerçekten ağırlık yapmasını istediğinizde bu, burada değil, sunucuda ödeme risk modu üzerinden olur — bkz. Ödeme Kararında Identity.

Sıradaki adımlar

Checkout Analiz Akışı — hosted form identity'yi SDK olmadan bir ödemeye nasıl bağlar.
Ödeme Kararında Identity — identity delili sonuca gerçekten ne zaman ağırlık yapar.
Web SDK — tam SDK referansı: metotlar, config, token rotasyonu, hata yönetimi.
Risk Snapshot — analyze()'ın döndürdüğü her alan.

Genel Bakış Checkout Analiz Akışı