Sandbox Issuer Resolution

Sandbox kart prefix'lerinin issuer ve BIN metadata'ya nasıl çözüldüğü ve neyi simüle etmediği.

HSRC Pay içinde sandbox issuer resolution vardır; fakat bu bir issuer behavior simulation engine değildir.

Codebase kart prefix'lerini issuer ve BIN metadata'ya çözer: network, country, brand, IIN, phone, prefix ve kart tipi. Çözülen issuer payment method üzerinde saklanır ve routing capability kontrollerinde kullanılabilir. Issuer davranışı üretmez.

Runtime Model

Adım	Ne olur?
PAN temizleme	Gönderilen kart numarasındaki rakam olmayan karakterler temizlenir.
Network fallback	Resolver kart numarası aralıklarından network tahmini yapabilir.
BIN lookup	Sandbox repository `bin_list` satırlarını yükler ve en uzun prefix eşleşmesini seçer.
Issuer + metadata sonucu	Resolve sonucu `issuer`, `network`, `country`, `iin`, `brand`, `phone`, `prefix` ve `type` alanlarını içerir.
Payment method update	Çözülen alanlar payment method'a ve `_sys_resolve_result` metadata'sına yazılır.
Routing input	Provider capability matching issuer, network, country, card type, currency, secure mode ve installment verilerini okuyabilir.

Ne Yapar?

Kart prefix'i BIN kaydıyla eşleşirse card payment method için sandbox issuer çözer.
Card payment method'a sandbox-only BIN metadata ekler.
Provider capability bu alanlara göre tanımlandıysa issuer, network, country ve kart tipi uyumluluğunu test etmeyi sağlar.
Sandbox BIN datasını production BIN intelligence'tan ayrı tutar.

Ne Yapmaz?

Gerçek issuer, banka, ACS, card network veya lisanslı finansal kurum değildir.
Issuer kararı simüle etmez.
BIN veya issuer'ları requires_action, hard decline, soft decline, insufficient funds, invalid account, fraud veya issuer unavailable sonuçlarına eşlemez.
Production approval, routing, fee veya provider davranışı garantisi vermez.
Issuer profile yönetmek için public API değildir.

Sandbox Cards ile İlişkisi

Sandbox kartları ve sandbox issuer resolution ilişkili ama aynı şey değildir:

Alan	Kaynak	Runtime amacı
Sandbox kart allowlist'i	`SandboxCards`	Sandbox provider içinde kart test verisini kabul veya reddetmek.
Sandbox issuer resolution	`SandboxBinList` / `bin_list`	Payment method için issuer ve BIN metadata çözmek.
3DS sonucu	Payment config + sandbox adapter	Geçerli sandbox kartı için `secure_mode: true`, `requires_action` döndürür.
Açık hata simülasyonu	Provider/sandbox scenario config	Kart/BIN numarası değil `expectedSandboxErr` veya eşdeğer config.

Örnek Metadata

Public docs tam internal BIN listesini bilerek yayınlamaz. Şekil şudur:

Alan	Anlam
`prefix`	Longest-prefix lookup ile eşleşen kart prefix'i
`iin`	Genellikle prefix'ten gelen IIN değeri
`network`	`VISA`, `MASTERCARD`, `TROY`, `AMEX`, vb.
`issuer`	Çözülen sandbox issuer label'ı; gerçek issuer decision engine değildir
`country`	Routing input'u olarak kullanılan ülke metadata'sı
`brand`	Sandbox kart ürün etiketi
`type`	`CREDIT`, `DEBIT` veya `PREPAID`
`phone`	BIN kaydındaki sandbox metadata alanı