☰ Меню · История изменений
Ещё
История изменений
Изменения в API, сначала новые.
22 ноября 2026
cashierвPOST /v1/transactions,POST /v1/checks/calculateиPOST /v1/holds: строка или{id, name}, кто пробил чек. Сохраняется с чеком и холдом, возвращается вcashierи используется сигналами кассиров у владельца. Никогда не меняет кэшбэк и не входит в проверку идемпотентности.
17 ноября 2026
- Правило «за один визит гость либо копит, либо тратит»: чек со списанием не начисляет кэшбэк, а ответы
POST /v1/checks/calculateиPOST /v1/transactionsсодержатearn_blocked: "redeemed". Без правила этого поля нет.
16 ноября 2026
- Точки: владелец привязывает к точкам коды касс и коды магазинов. Отправляйте
store_idс чеками, расчётами и холдами, когдаregister_idнет или он не привязан к точке; в ответах естьlocationсmatched_by. См. как передавать точку и кассу. - Правила точек: свой процент, начисление выключено, оплата кэшбэком запрещена или ограничена на точке. Чек или холд с кэшбэком там, где это запрещено, отклоняется с
400 redeem_not_allowed_here, а расчёт отвечаетredeem_blocked_reason. Исключения для товаров и категорий на точке:GET /v1/catalog/location-rules. - Категория по названию: заведения с подробным порядком правил принимают в
line_items[].categoryи название категории, и её код. Название никогда не создаёт новую категорию; побеждает самое точное правило. - Товары по акции:
line_items[].promo: true; владелец решает, начисляют ли такие строки кэшбэк и можно ли оплатить их кэшбэком. - Типы скидок:
discount_typeна чеке и на строках; владелец задаёт для каждого типа, начисляет ли он кэшбэк и можно ли платить кэшбэком, иначе400 discount_redeem_not_allowed. - Кэшбэк как оплата или как скидка: в режиме скидки у каждой строки есть
redeem_allocated; режим вsettings.redeem_accounting. - Офлайн:
GET /v1/accountвозвращает вsettingsполяtimeout_seconds,offline_redeemиoffline_max_hours. См. Когда касса без связи. - Подарки:
POST /v1/checks/calculateотвечаетgifts.pendingиgifts.unlocks,POST /v1/transactionsотвечаетgifts.unlocked; отметить выдачу подарка:POST /v1/members/{member}/gifts/{gift_id}/give. Событияgift.unlockedиgift.given.
5 ноября 2026
- В каждой транзакции и в
POST /v1/checks/calculateестьline_itemsс тем, что начислила каждая позиция:amount,cashback_earned,earn_percent,redeemable,quantity_refunded. - Возвраты по позициям:
POST /v1/transactions/{external_id}/refundsпринимаетline_itemsс артикулом и количеством; кэшбэк следует за тем, что каждая позиция реально начислила. - Префикс номера карты: владелец задаёт его в правилах для касс, новые карты начинаются с него;
settings.card_prefixвGET /v1/account. - Правила на товар: владелец переопределяет категорию на одном товаре, навсегда или между датами;
GET /v1/catalog/productsвозвращает их вrules. - Кэшбэк может уйти в минус: возврат или отмена снимают кэшбэк, который гость уже потратил,
cashback.balanceстановится отрицательным, а следующий чек сначала гасит долг. - Кабинет: поздравления с днём рождения на языке карты, события и ДР без картинки (текст поверх оформления карты), уровни по штампам, которые меняются в момент набора штампов.
- Кабинет: автокампании (купил товар, перестал покупать, расписание по сегменту) с журналом отправок; когорты покупателей с LTV; сегменты по купленным товарам и по балансу кэшбэка.
- Возврат позиций:
POST /v1/transactions/{external_id}/returnsпринимает возвращённыеline_itemsи двигает кэшбэк по тому, что начислила каждая позиция; тот же движок, что у возврата с позициями, отдельным эндпоинтом.
24 октября 2026
- Заказы с собой:
type: pickupсlocation,pickup_at,guestиday_number. - У каждого заказа есть
paymentиhistory.GET /v1/ordersпринимает?type=и?location=. - Блюдо с обязательным выбором, добавленное без него, отклоняется с
needs_optionsещё до вас.
9 октября 2026
- Отменённый или полностью возвращённый чек больше не считается визитом и тратой, поэтому возвраты не поднимают уровень кэшбэка гостя.
- Неизвестные пути внутри
/v1отвечают JSON404 endpoint_not_foundвместо страницы сайта; самGET /v1описывает API. - Ошибки валидации говорят, что именно отправить, например что
amountэто целое число в минимальных единицах.
7 октября 2026
- Правила заведения для касс: списание через резерв, номера чеков по кассам, лимит для поздних чеков, лимиты кэшбэка на чек и в день, обязательный скан карты, ручные корректировки. У каждого ключа могут быть свои значения.
GET /v1/accountвозвращает правила вsettings. - Резервы:
POST /v1/holds, подтверждение черезhold_id, снятие, автоматическое истечение. POST /v1/checks/calculateпоказывает, что сделает чек, ничего не записывая.- Частичные возвраты:
POST /v1/transactions/{external_id}/refunds. - Каталог: выгрузка товаров по артикулу. Для каждой категории владелец решает, начисляет ли она кэшбэк, можно ли оплатить её кэшбэком и какой у неё свой процент.
- В объекте участника появились
levels,next_level,heldиavailableкэшбэка. - У каждого чека, скана и расчёта есть
displayс готовым текстом для кассира и чека. - Новые права
members:adjust,catalog:read,catalog:write; новые событияtransaction.refunded,balance.adjusted.
6 октября 2026
- API v1 по адресу
/api/v1для программ любого типа: кэшбэк, штампы, скидки за визиты, VIP-уровни. - Участники: регистрация со своим номером карты, поиск по карте, штрихкоду, телефону или id, история, выдача наград.
- Формат штрихкода карты для каждой программы: QR или Code 128 с номером карты либо QR с серийным номером.
- Транзакции с
line_items, отмена чеков, списание кэшбэка с учётом лимитов программы. - Киоски и сканеры:
POST /v1/scans,POST /v1/visits, правоdevices:write. - API меню с вашими артикулами в
external_id, массовая синхронизация цен и стоп-листа. - Заказы со столов из QR-меню со статусами для POS.
- Вебхуки с подписью и повторными доставками,
Idempotency-Key, пагинация по курсору, права ключей. - Прежний POS API по адресу
/api/pos/v1продолжает работать.