Песочница
Песочница — это ключ приложения со средой sandbox. Он работает с настоящими событиями компании,
но всё, что вы продадите, помечается как тестовое.
Чем песочница отличается от боевой среды
| Поведение | Песочница | Боевая среда |
|---|---|---|
| Каталог и схемы | настоящие | настоящие |
| Заказ в отчётности организатора | не виден | виден |
| Письмо покупателю с билетами | не отправляется | отправляется |
Поле is_test в заказе | true | false |
| Срок жизни заказа | сутки, затем удаляется | постоянно |
Как проверить продажу целиком
- Забронируйте пару мест:
POST /v1/reservations. - Создайте заказ с
"payment": "external"— платёжный шлюз в песочнице не нужен. - Подтвердите оплату:
POST /v1/orders/{id}/confirmс любымexternal_payment_id. - Заберите билеты:
GET /v1/orders/{id}/tickets— они настоящие, со штрихкодами и местами. - Проверьте возврат:
POST /v1/orders/{id}/refund, полный или поticket_ids.
О чём помнить
- Тестовые заказы занимают настоящие места — пока заказ жив, купить это кресло нельзя. Поэтому мы удаляем тестовые заказы через сутки и освобождаем места; не тестируйте на событии, которое сегодня продаётся.
- Ошибки удобно проверять специально: запросите занятое место — получите 409
seat_taken; отправьтеpaid_amountс другой суммой — получите 422amount_mismatch. - Лимит запросов действует и в песочнице: превышение вернёт 429 — это хороший повод проверить, как ваша интеграция ждёт по
Retry-After.
Переход в боевую среду
Отдельное приложение со средой production и новый ключ. Ключи песочницы и боевой среды
невозможно перепутать: они принадлежат разным приложениям, и тестовый заказ никогда не попадёт в отчётность.
Вопросы по интеграции — api@ctickets.ru.
Ключи и журнал запросов — в кабинете организатора, раздел «API и интеграции».