Інструкція з фіскалізації транзакцій (EasyPay + Checkbox: відмінності між версіями
Матеріал з apidocs
Немає опису редагування |
|||
| Рядок 90: | Рядок 90: | ||
=== 6.1. Загальна структура === | === 6.1. Загальна структура === | ||
<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; font-weight:700;">Поле</th> | |||
<th style="text-align:left; padding:12px 16px; font-weight:700;">Тип</th> | |||
<th style="text-align:left; padding:12px 16px; font-weight:700;">Обов'язкове</th> | |||
<th style="text-align:left; padding:12px 16px; font-weight:700;">Опис</th> | |||
</tr> | |||
</thead> | |||
<tbody> | |||
<tr style="border-bottom:1px solid #efefef;"> | |||
<td style="padding:16px;">licenseKey</td> | |||
<td style="padding:16px;">string</td> | |||
<td style="padding:16px;">✅</td> | |||
<td style="padding:16px;">Ключ ліцензії каси Checkbox</td> | |||
</tr> | |||
<tr style="border-bottom:1px solid #efefef;"> | |||
<td style="padding:16px;">receiptType</td> | |||
<td style="padding:16px;">string</td> | |||
<td style="padding:16px;">✅</td> | |||
<td style="padding:16px;">Завжди <code style="background:#f3f3f3; padding:2px 6px; border-radius:6px;">"Url"</code></td> | |||
</tr> | |||
<tr style="border-bottom:1px solid #efefef;"> | |||
<td style="padding:16px;">receipt</td> | |||
<td style="padding:16px;">object</td> | |||
<td style="padding:16px;">✅</td> | |||
<td style="padding:16px;">Дані фіскального чека</td> | |||
</tr> | |||
</tbody> | |||
</table> | |||
Версія за 09:05, 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. Загальна структура
<thead> </thead> <tbody> </tbody>| Поле | Тип | Обов'язкове | Опис |
|---|---|---|---|
| licenseKey | string | ✅ | Ключ ліцензії каси Checkbox |
| receiptType | string | ✅ | Завжди "Url" |
| receipt | object | ✅ | Дані фіскального чека |