Fiscalization

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

5. Створення платежу з фіскалізацією

---

Для фіскалізації транзакції в методі: POST /api/merchant/createOrder потрібно передати обʼєкт fiscalization.

5.1. Приклад запиту createOrder

{
  "order": {
    "serviceKey": "MERCHANT-TEST-XXXX",
    "orderId": "Fiscalization29",
    "description": "Test for fiscalization",
    "amount": 3,
    "isOneTimePay": false,
    "additionalItems": {
      "Merchant.UrlNotify": "http://notifysigncheckexample.com"
    }
  },

  "fiscalization": {
    "licenseKey": "test8d2f483fafef",
    "receiptType": "Url",
    "receipt": {
      "goods": [
        {
          "good": {
            "code": "9999",
            "name": "Wine",
            "price": 1.5
          },
          "quantity": 2
        }
      ],
      "payments": [
        {
          "type": "CASHLESS",
          "value": 3
        }
      ]
    }
  }
}

6. Обʼєкт fiscalization — опис полів

---

6.1 Загальна структура

Поле	Тип	Обов'язкове	Опис
licenseKey	string	✅	Ключ ліцензії каси Checkbox
receiptType	string	✅	Завжди "Url"
receipt	object	✅	Дані фіскального чека

6.2 receipt

Поле	Тип	Обовʼязкове	Опис
goods	array	✅	Перелік товарів
payments	array	✅	Інформація про оплату

6.3 goods[ ]

Поле	Тип	Обовʼязкове	Опис
good.code	string	✅	Код товару
good.name	string	✅	Назва товару
good.price	decimal	✅	Ціна за одиницю
quantity	decimal	✅	Кількість (до 3 знаків після коми)