Перейти к основному содержанию

Интеграция за 5 шагов

1

Подготовьте данные и среду

Соберите base URL API, данные терминала/устройства и идентификаторы, необходимые для вашего платежного потока.
2

Начните с Order Create

Используйте POST /order/create/ как первую точку интеграции:
  • Подготовьте обязательные поля товаров и оплаты
  • Передавайте метаданные чека (time, cashier и т.д.)
  • Сохраняйте фискальные значения ответа (terminal_id, receipt_count, fiscal_sign, qr_url)
Страница: Order Create
3

Подключите эндпоинты платежных провайдеров

При необходимости подключите маршруты конкретных провайдеров:
4

Добавьте отчеты и операционные действия

Интегрируйте операции, нужные вашему бизнес-процессу:
  • Открытие/закрытие/печать/info/sverka Z-отчета
  • Открытие денежного ящика
  • Эндпоинты info и banner
5

Проверьте сквозной процесс

Проверьте успешные и ошибочные сценарии:
  • успешный заказ с фискальным ответом
  • обработка сбоя принтера/устройства
  • отказ провайдера и retry-логика
  • последовательность закрытия отчета в конце дня

Быстрая навигация

Введение в API

Структура API и модель использования.

Billing Auth

Получить токен для billing API.

Z-Report Open

Начать процесс отчетности.

Cash Drawer

Эндпоинт операции устройства.
Соблюдайте единицы из документации точно (например, значения, умноженные на 100 или 1000), чтобы избежать ошибок фискальной валидации.