У лютому 2026 року було запущено програму Національний чек або єЧек що дозволяє передавати та відображати фіскальний чек у банківському застосунку покупця.
Далі розповідаємо деталі щодо програми, як це працює у Вчасно.Каса та як виконати підключення.
Більше деталей як працює програма за посиланням.
У даній таблиці описано для яких банків та протоколів взаємодії з терміналами даних банків підтримується отримання ідентифікатора для доставки єЧеку при підключення терміналу і роботі з ним через Device Manager.
| Протокол | Банки що надають термінали з даним протоколом | Підтримка єЧеку |
|---|---|---|
| PrivatBank JSON | Приватбанк | Підтримується✅ |
| Ingenico BPOS1 | Ощадбанк Укрсиббанк VST Банк А-Банк Банк Південний Sense Банк Райффайзенбанк Банк ПУМБ МТБ Банк Укргазбанк |
Наразі не доступно❌ |
| Printec POSAPI | Райффайзенбанк Банк ПУМБ Sense Банк МТБ Банк Полтава Банк Укргазбанк |
Наразі не доступно❌ |
| SSI JSON | Monobank Укрексімбанк МТБ Банк Полтава Банк Ощадбанк Райффайзенбанк Банк ПУМБ VST Банк А-Банк Банк Південний Таскомбанк |
Наразі не доступно❌ |
| SmartOne JSON | Перша Еквайрингова Компанія (ПЕК) | Наразі не доступно❌ |
| SimPays ККМ | Таскомбанк Sense Банк |
Наразі не доступно❌ |
| A-Bank JSON | А-Банк | Наразі не доступно❌ |
"task": 1);"task": 2).Наступні чеки не будуть відображатись у застосунках банків так як не враховані наразі реалізаторами програми єЧек:
"task": 14);"task": 15);"task": 16).Банк робить окремі реалізації для кожного із видів еквайрингу (класичні термінали, Android термінали що працюють в режимі 3в1, термінал у смартфоні (tap2phone), інтернет еквайринг, оплата по qr і тд). Тобто у банку може працювати повернення інформації про ідентифікатор BID для класичного еквайрингу, але не буде для tap2phone.
Так так банки виступають з одного боку як емітенти платіжних засобів (карток), а з іншого як еквайри у торгівців програма буде працювати при розрахунку картками банку відмінного від банку еквайра за умови що банк емітент долучився до програми.
Чеки не будуть моментально доставлятись у застосунок банку якщо ПРРО працює в офлайн режимі. Покупець отримає чек лише після переходу ПРРО з режиму офлайн до режиму онлайн, відповідно краще видавати надрукований чек.
При використанні підключеного принтера в пакетному режимі друк автоматично пропускатись не буде. Ви можете відлючити принтер або пропускати друк і друкувати чеки окремо за допомогою завдань 22 та 23, в разі потреби.
Звертаємо увагу що у банка-еквайра можуть бути різні процеси налаштування коректної роботи програми національний чек (єЧек) для різних видів еквайрингу. В даному розділі описано налаштування при використанні класичних або android POS терміналів.
У вас може бути один із 4-х варіантів роботи з терміналом:
Що потрібно для коректної доставки чеку у застосунок банку:
В такому випадку вам потрібно лише оновити Device Manager до версії 7.1 або вище і все запрацює автоматично якщо доступний даний функціонал для вашого терміналу згідно таблиці.
Для того щоб запрацювало відображення чеків потрібно в запиті на фіскалізацію чеку вказувати унікальний ідентифікатор транзакції з боку банку (BID) передача якого у запити на фіскалізацію та отримання його з терміналу доступно тільки з версії 7.1 або вище. Перевірити чи для вашого терміналу уже доступний даний функціонал можна у таблиці у розділі Підтримка отримання признаку єЧеку у терміналах банків
Інші дані, вказані як обов'язкові у документації на сайті програми, заповнюються з боку ПРРО автоматично за наявності у запиті значення BID.
У відповіді після завершення оплати чи повернення по терміналу у ключ info.bank_trn_id буде повернуто необхідне значення.
Приклад:
{
"transaction_id": "cc507ba9-258f-47db-a8f5-73235171dfea",
"transaction_search": 0,
"info": {
"dt": "26.02.2026 15:14:48",
"termid": "S1K90HCY",
"bankid": "S1K90HCY",
"bankname": "ПриватБанк",
"payid": "070133",
"cancelid": "000545",
"refundid": "108646576676",
"cardmask": "522119228XXXXXX0",
"paysys": "MasterCard",
"sum": 1,
"discount": 0,
"sumcash": 0,
"curr": "ГРН",
"restxt": "APPROVED",
"sliptxt": "",
"isprint": 1,
"devinfo": "",
"deb_amount": 0,
"deb_num": 0,
"cred_amount": 0,
"cred_num": 0,
"canc_amount": 0,
"canc_num": 0,
"tx_num": 0,
"receipt": " Вчасно Каса \n ш.Харкiвське,буд.201/203 \n м.Київ \n ТОВ ВЧАСНО СЕРВIС \n 41231992 \nОПЛАТА\nСУМА: 1.00 ГРН\nПiдпис власника картки не потрiбен!\nMASTERCARD XXXXXXXXXXXX8620 \nAID: A0000000041010\nТЕРМIНАЛ: S1K90HCY 26/02/2026 15:14:48\nКОД АВТОРИЗАЦІЇ: 070133 ЧЕК N: 545\nRRN: 108646576676 \nEXTERNAL RRN: \n(c) Ingenico Group TA7E v.157.102 04/07/\nP5\n",
"hstFld63Sf89": "",
"merch": "S1K90HCY",
"submerch": "",
"reference": "",
"purchase_dt": "20260226151448",
"pan": "",
"acquirerid": "",
"agreementNum": "",
"scenario_data": "",
"commission": 0,
"transaction_id": "cc507ba9-258f-47db-a8f5-73235171dfea",
"oper_jwt": "",
"bank_trn_id": "h7v108646576676"
},
"ver": 6,
"resp_ver": 4,
"source": "",
"device": "Terminal",
"tag": "",
"task_status": 1,
"type": 3,
"task": 1,
"dt": "20260226151453209",
"res": 0,
"res_action": 0,
"errortxt": "",
"aq_errortxt": "",
"warnings": []
}
Його потрібно передати у запиті на фіскалізацію у ключ fiscal.bank_trn_id
Приклад:
{
"source": "TEST",
"device": "postgres1",
"tag": "",
"type": 1,
"fiscal": {
"task": 1,
"bank_trn_id": "h7v108646576676",
"receipt": {
"sum": 1,
"rows": [
{
"name": "Товар",
"cnt": 1,
"price": 1,
"cost": 1,
"taxgrp": 3
}
],
"pays": [
{
"type": 2,
"sum": 1,
"currency": "ГРН",
"change": 0,
"paysys": "MasterCard",
"rrn": "108646576676",
"cardmask": "522119228XXXXXX0",
"term_id": "S1K90HCY",
"bank_id": "S1K90HCY",
"bank_name": "ПриватБанк",
"auth_code": "070133",
"commission": 0.01,
"oper_type": "",
"show_additional_info": false,
"purchase_dt": "20260226151448"
}
],
"allow_zero_sum": true,
"not_check_safe": false,
"disable_taxes_control": false,
"autoround": false
}
}
}
Якщо ключ передано кореткно у відповіді його буде повернуто в об'єкті info.
Готово
Для того щоб запрацювало відображення чеків потрібно запиті на фіскалізацію чеку вказувати унікальний ідентифікатор транзакції з боку банку (BID).
Інші дані, вказані як обов'язкові у документації на сайті програми, заповнюються з боку ПРРО автоматично за наявності у запиті значення BID.
У відповіді після завершення оплати чи повернення по терміналу будуть повертатись необхідні дані.
Для терміналів Приватбанку по JSON протоколу потрібно лише ось це значення:
Сценарій 2: Тільки Національний чек Поле adv має вигляд: { "natr":"h7v102902308142"}
Його необхідно передати у запиті на фіскалізацію у ключ fiscal.receipt.bank_trn_id
Приклад:
{
"source": "TEST",
"device": "postgres1",
"tag": "",
"type": 1,
"fiscal": {
"task": 1,
"bank_trn_id": "h7v108646576676",
"receipt": {
"sum": 1,
"rows": [
{
"name": "Товар",
"cnt": 1,
"price": 1,
"cost": 1,
"taxgrp": 3
}
],
"pays": [
{
"type": 2,
"sum": 1,
"currency": "ГРН",
"change": 0,
"paysys": "MasterCard",
"rrn": "108646576676",
"cardmask": "522119228XXXXXX0",
"term_id": "S1K90HCY",
"bank_id": "S1K90HCY",
"bank_name": "ПриватБанк",
"auth_code": "070133",
"commission": 0.01,
"oper_type": "",
"show_additional_info": false,
"purchase_dt": "20260226151448"
}
],
"allow_zero_sum": true,
"not_check_safe": false,
"disable_taxes_control": false,
"autoround": false
}
}
}
Якщо ключ передано кореткно у відповіді його буде повернуто в об'єкті info.
В такому випадку функціонал електронного чеку вам не буде доступний, потрібно підключити термінал одним із 3-х способів вказаних вище