Пісочниця (Sandbox)
Середовище пісочниці дозволяє тестувати інтеграцію без обробки реальних платежів або створення реальних замовлень.
Пісочниця vs Продакшн
| Функція | Пісочниця | Продакшн |
|---|---|---|
| Базова URL | Та сама (/v2/partners) | Та сама (/v2/partners) |
| API-ключі | Ключі з префіксом sandbox | Продакшн-ключі |
| Платежі | Імітовані (без реальних списань) | Реальна обробка платежів |
| Обмеження запитів | У 5 разів вищі за продакшн | Стандартні ліміти |
| Webhook-и | Доставляються як зазвичай | Доставляються як зазвичай |
| Дані замовлень | Тестові дані, періодично очищуються | Постійні |
Як це працює
Ваші середовища пісочниці та продакшну визначаються API-ключем, який ви використовуєте. Ключі API для пісочниці видаються окремо від продакшн-ключів у вашій партнерській панелі керування.
- Використовуйте ключі пісочниці під час розробки та тестування.
- Перейдіть на продакшн-ключі, коли будете готові до запуску.
- Обидва середовища використовують однакові ендпоінти та приймають однакові формати запитів.
Імітовані платежі
У режимі пісочниці вся обробка платежів імітується:
- CARD-платежі завжди схвалюються без звернення до платіжного процесора.
- GOOGLE_PAY та APPLE_PAY токени приймаються без перевірки.
- IDEAL, REVOLUT та BANCONTACT потоки завершуються негайно без перенаправлення.
- Реальні гроші не списуються, і реальний платіжний метод не потрібен.
Поради щодо тестування
- Використовуйте email-адреси з префіксом sandbox (наприклад,
sandbox-user@example.com) для даних клієнтів, щоб чітко розрізняти тестові замовлення. - Тестуйте доставку webhook у пісочниці, щоб перевірити, що ваш ендпоінт коректно обробляє навантаження.
- Імітуйте сценарії помилок, використовуючи спеціальні тестові значення, задокументовані у вашій партнерській панелі.
- Обмеження запитів у пісочниці в 5 разів перевищують продакшн-ліміти, що дає більше простору для швидкого тестування.