Інструкція з фіскалізації транзакцій (EasyPay + Checkbox: відмінності між версіями
Матеріал з apidocs
| Рядок 147: | Рядок 147: | ||
<!-- 6.3 Масив goods[] --> | <!-- 6.3 Масив goods[] --> | ||
<table style="width:100%; border-collapse:collapse; border-spacing:0;"> | <table style="width:100%; border-collapse:collapse; border-spacing:0;"> | ||
<tr style="border-bottom:1px solid #e6e6e6;"> | <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> | ||
| Рядок 154: | Рядок 153: | ||
<th style="text-align:left; padding:12px 16px;">Опис</th> | <th style="text-align:left; padding:12px 16px;">Опис</th> | ||
</tr> | </tr> | ||
<tr style="border-bottom:1px solid #efefef;"> | <tr style="border-bottom:1px solid #efefef;"> | ||
<td style="padding:16px;">good.code</td> | <td style="padding:16px;">good.code</td> | ||
| Рядок 180: | Рядок 177: | ||
<td style="padding:16px;">Кількість (до 3 знаків після коми)</td> | <td style="padding:16px;">Кількість (до 3 знаків після коми)</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
Версія за 09:12, 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 | ✅ | Інформація про оплату |
6.3 goods[ ]
| Поле | Тип | Обовʼязкове | Опис |
|---|---|---|---|
| good.code | string | ✅ | Код товару |
| good.name | string | ✅ | Назва товару |
| good.price | decimal | ✅ | Ціна за одиницю |
| quantity | decimal | ✅ | Кількість (до 3 знаків після коми) |