Simulovaná platební brána (sandbox)
Zjistěte, jak odpovídá platební API: simulujte schválení, zamítnutí a 3-D Secure se zveřejněnými testovacími kartami — zcela offline.
🔒 Vzdělávací simulátor: nekontaktuje žádnou banku, karetní síť ani poskytovatele plateb. Přijímána jsou pouze zveřejněná testovací čísla karet.
Zveřejněná testovací čísla karet
| Číslo karty | Síť | Simulovaný výsledek | |
|---|---|---|---|
| 4242 4242 4242 4242 | Visa | Platba proběhne | |
| 4000 0000 0000 0002 | Visa | Zamítnuto: generic_decline | |
| 4000 0000 0000 9995 | Visa | Zamítnuto: insufficient_funds | |
| 4000 0000 0000 0069 | Visa | Zamítnuto: expired_card | |
| 4000 0000 0000 0127 | Visa | Zamítnuto: incorrect_cvc | |
| 4000 0000 0000 0119 | Visa | Chyba: processing_error | |
| 4000 0025 0000 3155 | Visa | Vyžaduje ověření 3-D Secure | |
| 5555 5555 5555 4444 | Mastercard | Platba proběhne | |
| 3782 822463 10005 | American Express | Platba proběhne |
Jak funguje platební proces
Váš server vytvoří a potvrdí payment intent, brána odpoví stavem a webhook později sdělí vašemu backendu konečný výsledek. Objednávky vyřizujte podle webhooku, ne podle přesměrování v prohlížeči.
{
"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."
}
}
}
}O nástroji Simulovaná platební brána (sandbox)
Tento simulovaný sandbox platební brány umožňuje vývojářům poznat, jak odpovídá API karetních plateb, aniž by se dotkli skutečných peněz. Vyberte jedno ze zveřejněných testovacích čísel karet, zadejte libovolné budoucí datum platnosti, CVC a částku a stiskněte Simulovat platbu. Stránka vrátí objekt JSON ve tvaru typického payment intent: id, stav, karetní síť a poslední čtyři číslice, kód a zprávu o zamítnutí při neúspěchu a fiktivní autorizační kód při schválení. Karta 3-D Secure zobrazí simulované ověření, abyste si mohli vyzkoušet zpracování stavu requires_action, a každý výsledek obsahuje odpovídající událost webhooku. Simulátor běží celý ve vašem prohlížeči: nekontaktuje žádnou banku, karetní síť ani poskytovatele plateb a přijímá jen zveřejněná testovací čísla uvedená v tabulce. Skutečná čísla karet se odmítnou lokálně a nikam se neodesílají.
FAQ
Strhává sandbox peníze z karty nebo kontaktuje banku?
Ne. Vše se simuluje ve vašem prohlížeči. Žádný požadavek se neodesílá Visatk, bance, karetní síti ani poskytovateli plateb a žádné peníze se nepohybují.
Proč bylo mé číslo karty odmítnuto?
Sandbox přijímá jen zveřejněná testovací čísla z tabulky. Jakékoli jiné číslo, včetně skutečné karty, se odmítne lokálně, takže nikdy není považováno za schválené.
Mohu tato čísla použít u svého skutečného poskytovatele plateb?
Jde o široce zveřejněná testovací čísla používaná v testovacích režimech poskytovatelů. Fungují jen s testovacími klíči API v sandboxu poskytovatele; v ostrém režimu jsou vždy zamítnuta.