Інструкція з фіскалізації транзакцій (EasyPay + Checkbox: відмінності між версіями

Матеріал з apidocs
Перейти до: навігація, пошук
Немає опису редагування
Немає опису редагування
Рядок 14: Рядок 14:
[[Файл:Ключ ліцензії.png|центр|міні|600x600пкс]]
[[Файл:Ключ ліцензії.png|центр|міні|600x600пкс]]
'''<br>  
'''<br>  
PIN-код касира'''[[Файл:Пін код.png|центр|міні|600x600пкс]]
 
'''PIN-код касира'''
 
'''[[Файл:Пін код.png|центр|міні|600x600пкс]]
'''serviceKey''', з якого будуть фіскалізуватися транзакції
'''serviceKey''', з якого будуть фіскалізуватися транзакції


Рядок 23: Рядок 26:
* Зміна відкривається '''автоматично''' разом із першою фіскалізованою транзакцією за день
* Зміна відкривається '''автоматично''' разом із першою фіскалізованою транзакцією за день
* Зміна '''автоматично закривається о 23:45'''
* Зміна '''автоматично закривається о 23:45'''
== 4. Загальна схема роботи ==
[[Файл:Схема.png|центр|міні|400x400пкс]]
# Мерчант створює замовлення (<code>createOrder</code>) з параметрами фіскалізації
# EasyPay ініціює фіскалізацію в сервісі Checkbox
# Checkbox формує фіскальний чек
# Статус фіскалізації та URL чека:
#* надсилаються в callback, або
#* доступні через метод <code>fiscalization/check</code>
# У разі повернення коштів використовується метод <code>CancelOrder</code>

Версія за 09:01, 20 січня 2026

1. Попередні умови

Для фіскалізації транзакцій мерчант повинен:

  • Бути зареєстрованим у сервісі Checkbox: https://checkbox.ua
  • Мати в Checkbox:
    • зареєстровану касу
    • створеного касира


2. Дані, які потрібно надати EasyPay

Після реєстрації в Checkbox необхідно надіслати менеджеру EasyPay на email:

Ключ ліцензії каси (licenseKey)


PIN-код касира

serviceKey, з якого будуть фіскалізуватися транзакції

⚠️ Без передачі цих даних фіскалізація працювати не буде.

3. Робота зі змінами

  • Зміна відкривається автоматично разом із першою фіскалізованою транзакцією за день
  • Зміна автоматично закривається о 23:45


4. Загальна схема роботи

  1. Мерчант створює замовлення (createOrder) з параметрами фіскалізації
  2. EasyPay ініціює фіскалізацію в сервісі Checkbox
  3. Checkbox формує фіскальний чек
  4. Статус фіскалізації та URL чека:
    • надсилаються в callback, або
    • доступні через метод fiscalization/check
  5. У разі повернення коштів використовується метод CancelOrder