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