Sahte Ödeme Altyapısı Sandbox’ı
Bir ödeme API’sinin nasıl yanıt verdiğini öğrenin: yayımlanmış test kartlarıyla onayları, retleri ve 3-D Secure’u tamamen çevrimdışı simüle edin.
🔒 Eğitim amaçlı simülatör: hiçbir bankayla, kart ağıyla veya ödeme sağlayıcısıyla iletişim kurmaz. Yalnızca yayımlanmış test kartı numaraları kabul edilir.
Yayımlanmış test kartı numaraları
| Kart numarası | Kart ağı | Simüle edilen sonuç | |
|---|---|---|---|
| 4242 4242 4242 4242 | Visa | Ödeme başarılı | |
| 4000 0000 0000 0002 | Visa | Reddedildi: generic_decline | |
| 4000 0000 0000 9995 | Visa | Reddedildi: insufficient_funds | |
| 4000 0000 0000 0069 | Visa | Reddedildi: expired_card | |
| 4000 0000 0000 0127 | Visa | Reddedildi: incorrect_cvc | |
| 4000 0000 0000 0119 | Visa | Hata: processing_error | |
| 4000 0025 0000 3155 | Visa | 3-D Secure doğrulaması gerektirir | |
| 5555 5555 5555 4444 | Mastercard | Ödeme başarılı | |
| 3782 822463 10005 | American Express | Ödeme başarılı |
Ödeme akışı nasıl çalışır?
Sunucunuz bir payment intent oluşturup onaylar, ödeme altyapısı bir durumla yanıt verir ve daha sonra bir webhook arka ucunuza nihai sonucu bildirir. Siparişleri tarayıcı yönlendirmesine göre değil, webhook’a göre tamamlayın.
{
"method": "POST",
"path": "/v1/payment_intents",
"body": {
"amount": 2000,
"currency": "usd",
"confirm": true,
"payment_method_data": {
"type": "card",
"card": {
"number": "4242424242424242",
"exp_month": 12,
"exp_year": 2030,
"cvc": "123"
}
}
}
}{
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"object": "payment_intent",
"livemode": false,
"amount": 2000,
"currency": "usd",
"status": "succeeded",
"payment_method": {
"type": "card",
"card": {
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2030
}
},
"latest_charge": {
"id": "ch_test_8h2j4k6l1m3n5p7q9r0s2t4u",
"authorization_code": "T4K2Q9",
"outcome": {
"network_status": "approved_by_network",
"type": "authorized"
}
}
}{
"id": "evt_test_1a2b3c4d5e6f7g8h9i0j1k2l",
"object": "event",
"type": "payment_intent.succeeded",
"livemode": false,
"data": {
"object": {
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"status": "succeeded",
"amount": 2000,
"currency": "usd"
}
}
}{
"id": "evt_test_9z8y7x6w5v4u3t2s1r0q9p8o",
"object": "event",
"type": "payment_intent.payment_failed",
"livemode": false,
"data": {
"object": {
"id": "pi_test_7f6e5d4c3b2a1z0y9x8w7v6u",
"status": "requires_payment_method",
"last_payment_error": {
"type": "card_error",
"code": "card_declined",
"decline_code": "insufficient_funds",
"message": "Your card has insufficient funds."
}
}
}
}Sahte Ödeme Altyapısı Sandbox’ı hakkında
Bu sahte ödeme altyapısı sandbox’ı, geliştiricilerin gerçek paraya dokunmadan bir kart ödeme API’sinin nasıl yanıt verdiğini öğrenmesini sağlar. Yayımlanmış test kartı numaralarından birini seçin, gelecekteki herhangi bir son kullanma tarihi, bir CVC ve bir tutar girin ve Ödemeyi simüle et düğmesine basın. Sayfa, tipik bir payment intent yapısında bir JSON nesnesi döndürür: bir id, bir durum, kart ağı ve son dört hane, başarısız işlemler için bir ret kodu ve mesajı, onaylar için de sahte bir provizyon kodu. 3-D Secure kartı, requires_action durumunu ele almayı deneyebilmeniz için simüle edilmiş bir doğrulama adımı gösterir ve her sonuç ilgili webhook olayını içerir. Simülatör tamamen tarayıcınızda çalışır: hiçbir bankayla, kart ağıyla veya ödeme sağlayıcısıyla iletişim kurmaz ve yalnızca tabloda listelenen yayımlanmış test numaralarını kabul eder. Gerçek kart numaraları yerel olarak reddedilir ve hiçbir yere gönderilmez.
FAQ
Sandbox bir karttan ücret çekiyor veya bankayla iletişim kuruyor mu?
Hayır. Her şey tarayıcınızda simüle edilir. Visatk’e, bir bankaya, bir kart ağına veya bir ödeme sağlayıcısına hiçbir istek gönderilmez ve hiçbir para hareket etmez.
Kart numaram neden reddediliyor?
Sandbox yalnızca tablodaki yayımlanmış test numaralarını kabul eder. Gerçek bir kart dahil diğer tüm numaralar, asla onaylanmış sayılmaması için yerel olarak reddedilir.
Bu numaraları gerçek ödeme sağlayıcımda kullanabilir miyim?
Bunlar, sağlayıcıların test modlarında kullanılan ve yaygın olarak yayımlanmış test numaralarıdır. Yalnızca sağlayıcınızın sandbox ortamındaki test API anahtarlarıyla çalışırlar; canlı modda her zaman reddedilirler.