Пісочниця платіжного шлюзу (імітація)
Дізнайтеся, як відповідає платіжний API: імітуйте схвалення, відмови та 3-D Secure з опублікованими тестовими картками — повністю офлайн.
🔒 Навчальний симулятор: він не звертається ні до банку, ні до платіжної системи, ні до платіжного провайдера. Приймаються лише опубліковані тестові номери карток.
Опубліковані тестові номери карток
| Номер картки | Платіжна система | Імітований результат | |
|---|---|---|---|
| 4242 4242 4242 4242 | Visa | Платіж успішний | |
| 4000 0000 0000 0002 | Visa | Відмова: generic_decline | |
| 4000 0000 0000 9995 | Visa | Відмова: insufficient_funds | |
| 4000 0000 0000 0069 | Visa | Відмова: expired_card | |
| 4000 0000 0000 0127 | Visa | Відмова: incorrect_cvc | |
| 4000 0000 0000 0119 | Visa | Помилка: processing_error | |
| 4000 0025 0000 3155 | Visa | Потрібна автентифікація 3-D Secure | |
| 5555 5555 5555 4444 | Mastercard | Платіж успішний | |
| 3782 822463 10005 | American Express | Платіж успішний |
Як працює платіжний процес
Ваш сервер створює й підтверджує payment intent, шлюз відповідає статусом, а згодом вебхук повідомляє вашому бекенду остаточний результат. Виконуйте замовлення за вебхуком, а не за редиректом браузера.
{
"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."
}
}
}
}Про інструмент «Пісочниця платіжного шлюзу (імітація)»
Ця пісочниця-імітація платіжного шлюзу дає змогу розробникам вивчити, як відповідає API карткових платежів, не торкаючись реальних грошей. Виберіть один з опублікованих тестових номерів карток, введіть будь-який майбутній термін дії, CVC і суму та натисніть «Імітувати платіж». Сторінка повертає JSON-об’єкт у формі типового payment intent: id, статус, платіжна система й останні чотири цифри, код і повідомлення про відмову в разі невдачі та фіктивний код авторизації в разі схвалення. Картка 3-D Secure показує імітацію перевірки, щоб ви могли потренуватися в обробці статусу requires_action, а кожен результат містить відповідну подію вебхука. Симулятор повністю працює у вашому браузері: він не звертається ні до банку, ні до платіжної системи, ні до платіжного провайдера й приймає лише опубліковані тестові номери з таблиці. Справжні номери карток відхиляються локально й нікуди не надсилаються.
FAQ
Чи списує пісочниця гроші з картки або звертається до банку?
Ні. Усе імітується у вашому браузері. Жодні запити не надсилаються ні Visatk, ні банку, ні платіжній системі, ні платіжному провайдеру, і гроші не рухаються.
Чому мій номер картки відхилено?
Пісочниця приймає лише опубліковані тестові номери з таблиці. Будь-який інший номер, зокрема справжня картка, відхиляється локально й ніколи не вважається схваленим.
Чи можна використовувати ці номери в мого реального платіжного провайдера?
Це широко опубліковані тестові номери, що використовуються в тестових режимах провайдерів. Вони працюють лише з тестовими ключами API в пісочниці вашого провайдера; у бойовому режимі їх завжди відхиляють.