Sandbox Cards

Sandbox kartları gerçek ödeme aracı değildir. HSRC Pay içinde sandbox provider'ın gönderilen kart verisinin bilinen sandbox test verisi olup olmadığını doğrulamak için kullandığı runtime allowlist'tir.

Önemli sınır: sandbox kartları insufficient funds, invalid account, stolen card, expired card, issuer unavailable veya risk/fraud gibi spesifik issuer hatalarını simüle etmez. Sandbox kartı sadece sandbox kartıdır.

Sandbox Kartları Ne Yapar?

Sandbox Kartları Ne Yapmaz?

Sandbox kart numaraları senaryo switch'i değildir. Belirli bir PAN'ı belirli bir issuer decline veya provider failure ile eşleştirmeyin.

Açık hata simülasyonu için provider/sandbox scenario configuration kullanılır. Felix sandbox adapter'da bu davranış expectedSandboxErr üzerinden çalışır; kart numarasından bağımsızdır. Akış kart doğrulaması gerektiriyorsa kart verisi yine geçerli bir sandbox kartı olmalıdır.

Kart Doğrulama Mantığı

Sandbox provider kart verisini sadece card payment method için doğrular:

1. pan sadece rakamlara indirgenir.
2. month iki haneye normalize edilir.
3. year son iki haneye normalize edilir.
4. cvv veya cvc varsa sadece rakamlara indirgenir ve birebir eşleştirilir.
5. Kart allowlist içinde bulunamazsa provider invalid_payment_method döndürür.

3DS Davranışı

3DS, özel bir kart numarası seçilerek değil ödeme konfigürasyonu ile kontrol edilir:

Sandbox Kart Listesi

Bu kartları sadece sandbox ortamında kullanın. Bunlar dummy test verisidir ve yalnızca sandbox provider allowlist'i tarafından kabul edilir.

Örnek Kullanım

const { data } = await api.post(`/v1/payments/${paymentId}/confirm`, {
  payment_method: {
    type: "card",
    data: {
      pan: "4991001823456701",
      month: "05",
      year: "28",
      cvv: "123",
    },
  },
  payer_identity: { ip_address: clientIp, user_agent: ua },
});

if (data.payment.status === "REQUIRES_ACTION") {
  redirectUser(data.confirmResult.paymentNextAction?.url);
}

Production Sınırı

Sandbox kartları production credential veya production provider route ile kullanılmamalıdır. Production kart davranışı gerçek provider/card network cevabından gelir; bu sandbox allowlist tarafından kontrol edilmez.

Sık Yapılan Hatalar

• Sandbox kart numaralarını issuer error trigger'ı gibi ele almak.
• Bir PAN'ın insufficient funds, invalid account, stolen card, expired card veya issuer unavailable simüle etmesini beklemek.
• Sadece success test edip secure_mode: true akışını atlamak.
• Sandbox kartlarını production'a göndermek.
• Production kart verisini sandbox'a göndermek.
• Kullanıcı UI'ını normalized error yerine raw provider string'lerine göre tasarlamak.

Related docs

• Sandbox Network
• Sandbox Issuer Resolution
• 3DS Simulation
• Testing Declines
• Routing Simulation