Песочница для интеграторов

Песочница — настоящая компания на нашей платформе, заведённая на неделю. Тот же API, те же коды ошибок, те же ограничения по тарифу. Регистрироваться, вводить почту и ждать ответа не нужно: ключ выдаётся сразу, вместе с программой, точкой продаж и тремя гостями, у которых уже есть карты и покупки.

Что внутри

1. Ключ API со всеми правами

   Чеки, возвраты, поиск карты, заведение гостя — всё, что умеет открытый API. Урезанный набор прав отличал бы песочницу от боевой компании, а она для того и нужна, чтобы отличий не было.

2. Три гостя с картами и покупками

   Телефоны, штрихкоды и балансы приходят в ответе. Проводить чек есть по кому с первой минуты — искать в пустой базе некого.

3. Кабинет с паролем

   Чтобы посмотреть глазами, что чек дошёл: сводка, карточка гостя, история начислений. Вход — почта и пароль из ответа.

4. Страница выдачи карты

   Публичный адрес программы: можно пройти путь гостя целиком и поставить карту в свой телефон.

Как проверить, что всё работает

Проведите чек по любому из выданных штрихкодов. Заголовок Idempotency-Key обязателен — он защищает от двойного начисления при повторной отправке. Готовую команду с вашим ключом и первым из выданных гостей печатает сама выдача — её достаточно скопировать.

curl -X POST https://api.snovacard.ru/api/v1/transactions \
  -H "x-api-key: ВАШ_КЛЮЧ" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: demo-$(date +%s)" \
  -d '{"cardBarcode":"ШТРИХКОД_ГОСТЯ","amount":1000,"redeemPoints":0}'

Idempotency-Key — любая строка, уникальная для чека: номер чека из кассы, UUID, что угодно. В примере это секунды текущего времени, чтобы команда работала в любой оболочке без дополнительных утилит; повторная отправка с тем же ключом вернёт прежний ответ и баллы второй раз не начислит.

В ответе — начисленные баллы, новый баланс и сработавшие правила. Дальше стоит проверить списание: спросите карту по телефону, посмотрите maxRedeemPercent и проведите чек с redeemPoints.

Чем песочница отличается от боевой компании

1. Живёт неделю

   Потом удаляется вместе с гостями, картами и историей. Продлить нельзя — берите новую, это одна кнопка.

2. Код показывается на странице

   Никаких сообщений наружу: ни письма, ни SMS, ни звонка — код виден прямо на форме выдачи. На боевой компании он уходит гостю, и каналы выбирает владелец.

3. Оператор персональных данных — мы

   Заведения за песочницей нет, поэтому в согласии названы наши реквизиты. У настоящего клиента там его юридическое лицо и его ИНН.

4. Не больше трёх в сутки с одного адреса

   Ручка открыта без авторизации, и предел защищает её от перебора. Нужно больше — напишите нам, договоримся.

Частые вопросы