Разделы документации
Тестовый режим
Тестовый ключ работает с отдельными событиями и билетами, а письма отправляет только вам. Так интеграцию можно проверить до запуска продаж.
Чем тест отличается от боя
- Ключ
bt_test_…видит только тестовые события, заказы, билеты и устройства. Боевой ключ их не видит, и наоборот. - Письма по тестовым заказам уходят только на адреса сотрудников организации и подтверждённые тестовые адреса. На другие адреса письмо не отправляется, а заказ и билеты выпускаются как обычно.
- На странице тестового билета стоит плашка «ТЕСТ · билет не настоящий».
- Устройство контролёра работает в одном режиме: тестовое проверяет только тестовые события, боевое — только боевые.
- Всё остальное одинаково: те же методы, ответы, ошибки и лимиты.
Тестовые события в боевой режим не переносятся. К запуску создайте события заново боевым ключом.
Тестовые адресаты
Адреса, на которые уходят тестовые письма, добавляют в кабинете: настройки → тестовые адресаты → Добавить адрес. На адрес придёт письмо со ссылкой, адрес подтвердится, когда её откроют. Адреса сотрудников организации подходят и без подтверждения. Через API список адресатов не меняется.
Как проверить интеграцию
- Создайте тестовый ключ, событие и опубликуйте его: быстрый старт.
- Отправьте заказ на свой адрес из тестовых адресатов. Проверьте письмо и страницу билета.
- Повторите тот же запрос с тем же
Idempotency-Key. Должен прийти тот же заказ и заголовокIdempotent-Replayed: true. - Проверьте ответы вашего сайта на
409 sold_out: поставьте тарифу маленькую квоту и купите больше. - Отмените билет через
POST /v1/tickets/{id}/cancel: QR перестанет пускать, гостю уйдёт письмо. - Подключите телефон контролёра в тестовом режиме и проверьте QR на входе: контролёры.
- Замените ключ на боевой
bt_live_…и создайте боевые события.