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

← Попереднє редагування Наступне редагування →

ВізуальнийВікірозмітка

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

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

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

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

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

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

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

PIN-код касира

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

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

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

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

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

Мерчант створює замовлення (createOrder) з параметрами фіскалізації
EasyPay ініціює фіскалізацію в сервісі Checkbox
Checkbox формує фіскальний чек
Статус фіскалізації та URL чека:
- надсилаються в callback, або
- доступні через метод fiscalization/check
У разі повернення коштів використовується метод 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	✅	Інформація про оплату

@@ Рядок 121: / Рядок 121: @@
 ====  6.2 receipt ====
+<!-- 6.2 Обʼєкт receipt -->
+<table style="width:100%; border-collapse:collapse; border-spacing:0;">
+  <thead>
+    <tr style="border-bottom:1px solid #e6e6e6;">
+      <th style="text-align:left; padding:12px 16px;">Поле</th>
+      <th style="text-align:left; padding:12px 16px;">Тип</th>
+      <th style="text-align:left; padding:12px 16px;">Обовʼязкове</th>
+      <th style="text-align:left; padding:12px 16px;">Опис</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr style="border-bottom:1px solid #efefef;">
+      <td style="padding:16px;">goods</td>
+      <td style="padding:16px;">array</td>
+      <td style="padding:16px;">✅</td>
+      <td style="padding:16px;">Перелік товарів</td>
+    </tr>
+    <tr style="border-bottom:1px solid #efefef;">
+      <td style="padding:16px;">payments</td>
+      <td style="padding:16px;">array</td>
+      <td style="padding:16px;">✅</td>
+      <td style="padding:16px;">Інформація про оплату</td>
+    </tr>
+  </tbody>
+</table>