Робота із програмою “Національний кешбек”
Загальні положення
Для прийому платежів з метою зарахування національного кешбеку торгова точка повинна бути зареєстрована в програмі "Національний кешбек".
Які мерчанти можуть зареєструватись в програмі:
Прийняття оплати здійснюються лише в торгових точках з дозволеними MCC-кодами (код категорії продавця), які регламентуються Постановою Кабінету Міністрів від 20.08.2024 № 952 «Про затвердження Порядку реалізації експериментального проєкту щодо надання державної грошової допомоги покупцям товарів українського виробництва в рамках Всеукраїнської економічної платформи «Зроблено в Україні».
Як зареєструватись:
Продавцям, щоб стати учасниками програми «Національний кешбек», необхідно виконати дії згідно інструкції:
- Подати заявку на приєднання до Переліку українських виробників через портал Дія («Бізнес» -> «Підприємництво» -> Перелік продавців).
- Заповнити форму і вказати дані про підприємство.
- До заявки потрібно додати:
- перелік комбінацій фіскального номера РРО із переліком комбінацій MerchantID+TerminalID (MID та TID надає провайдер, номер РРО - сервіс фіскалізації платежів)
- перелік адрес, де продається товар,
- банк,
- сайт,
- бренд
- Перевірити заяву, підписати електронним підписом.
З фіскальних чеків Дія отримує інформацію, співставляє її з даними податкових органів щодо товарів, що підпадають під Програму, та нараховує кешбек.
Для коректного нарахування кешбеку необхідно, щоб у чеку були присутні наступні обовʼязкові параметри для РРО:
- MID (Merchant ID – унікальний ідентифікатор мерчанта)
- TID (Terminal ID – унікальний ідентифікатор терміналу)
- RRN (Унікальний банківський ідентифікатор транзакції)
- Auth Code (код авторизації платежу)
- штрих-код продукту
Взаємодія з CashDesk
При використанні нашої інтеграції з CashDesk необхідно пересвідчитися в тому, що вказані параметри правильно передаються при формуванні запиту на проведення платежу:
| Parameter | Type | Required | Description |
|---|---|---|---|
products.id | UUID | ✅ | Унікальний ідентифікатор товару |
products.name | String | ✅ | Назва продукту/товару |
products.amount | Number | ✅ | Вартість за одиницю товару/роботи/послуги |
products.qty | Number | ✅ | Кількість (загальний amount платежу = product.qty * product.amount) |
products.unit | String | ✅ | Одиниця вимірювання (допустимі значення kg, m, pc, l) |
products.bar_code | String | ✅ | Штрих-код товару (опційний для фіскалізації, але обов’язковий для програми “Національний кешбек”) |
products.taxes.type | String | ✅ | Тип податку (допустимі значення vat, non-vat) |
products.taxes.prc | Number | ✅ | Податкова ставка % (допустимі значення 0, 5, 20) |
customer_email | String | ✅ | Електронна пошта платника (є опційним параметром у випадку, якщо її введення є обов’язковим на чекауті) |
Приклад Body запиту на Tranzzo:
{
"pos_id": "238afc85-a179-41d3-9ad7-e8ccaa803dc5",
"mode": "direct",
"method": "purchase",
"amount": 100,
"cc_number": "4111111111111111",
"exp_month": 4,
"exp_year": 25,
"card_cvv": "061",
"currency": "UAH",
"order_id": "123",
"payway": "сс",
"description": "fdsfsdsfsd",
"customer_lname": "Зайці",
"customer_fname": "Світлана",
"customer_patronym": "Степанівна",
"customer_tax_id": "taxID1",
"order_3ds_bypass": "supported",
"server_url": "https://webhook.site/016dd017-6d33-440f-9811-8c69808b6d42",
"customer_email": "[email protected]",
"products": [
{
"name": "Apple",
"amount": 10,
"currency": "UAH",
"qty": 9,
"id": "1",
"unit": "kg",
"bar_code":"4876534567183",
"taxes": [
{
"prc": 0,
"type": "vat"
}
]
},
{
"name": "Apple",
"amount": 0.5,
"currency": "UAH",
"qty": 10,
"id": "2",
"unit": "kg",
"taxes": [
{
"prc": 7,
"type": "vat"
}
]
},
{
"name": "Apple",
"amount": 4.75,
"currency": "UAH",
"qty": 1,
"id": "3",
"unit": "kg",
"bar_code": "4876534567183",
"taxes": [
{
"prc": 7,
"type": "vat"
}
]
},
{
"name": "Apple",
"amount": 0.5,
"currency": "UAH",
"qty": 0.5,
"id": "4",
"unit": "kg",
"taxes": [
{
"prc": 20,
"type": "vat"
}
]
}
]
}
Самостійна фіскалізація
Мерчантам, які фіскалізують платежі самостійно, для отримання обовʼязкових для передачі ПРРО-провайдеру параметрів за платежем необхідно:
- Виконати запит на створення одностадійного чи двостадійного платежу.
- З відповіді, після успішного процесингу платежу, отримати наступні параметри, що є обов’язковими для подальшої фіскалізації:
| Parameter | Required | Description |
|---|---|---|
cc_mask | ✅ | Маска картки платника |
bank_merchant_id | ✅ | Унікальний ідентифікатор мерчанта |
bank_terminal_id | ✅ | Ідентифікатор платіжного пристрою (TID) |
bank_name | ✅ | Назва банка-еквайєра |
rrn | ✅ | Ідентифікатор транзакції, який допомагає ідентифікувати платіж на стороні еквайера |
auth_code | ✅ | Ідентифікатор транзакції, який допомагає ідентифікувати платіж на стороні емітента |
payment_system | ✅ | Назва платіжної системи |
Приклад відповіді:
{
"customer_country": null,
"eci": "7",
"cc_token": "NDU5ZWNjYWI1MTcyNGQ4OGI4YjliZGZjMjBmZmQzY2Q6Q2xsSTZCcVZlOGNqeUNxMktT",
"customer_fname": "Світлана",
"external_terminal_name": null,
"cc_mask": "411111******1111",
"mode": "direct",
"pos_id": "238afc85-a179-41d3-9ad7-e8ccaa803dc5",
"transaction_id": "ccfdd2db-21f8-416b-a3a6-3e9ec9a987c2",
"user_action_url": null,
"billing_order_id": null,
"status_description": "Transaction is successful",
"result_url": "https://webhook.site/016dd017-6d33-440f-9811-8c69808b6d42",
"percent_fee": {
"amount": 1,
"currency": "UAH"
},
"method": "purchase",
"merchant_order_id": null,
"processed_amount": 100,
"recipient_fname": null,
"customer_phone": "380991213764",
"recipient_email": null,
"fixed_fee": {
"amount": 0,
"currency": "UAH"
},
"gateway_order_id": "21c4a20b-049e-4151-8a62-d6e0c4efc458",
"entity_id": "8abf38c1-380b-4694-877f-dd61c685e097",
"bank_merchant_id": "MID-0001",
"bank_terminal_id": "1763382",
"rrn": "1023624",
"auth_code": 783662,
"user_action_required": false,
"terminal_name": "STUB (sandbox)",
"processed_currency": "UAH",
"customer_email": "[email protected]",
"order_id": "9b39522d-4062-4b40-a03c-f3da07114b5d",
"status": "success",
"recipient_phone": null,
"recipient_cc_token": null,
"registry_ref_no": null,
"status_code": "1000",
"otp_url": null,
"description": "fdsfsdsfsd",
"created_at": "2024-12-13T08:40:38.379",
"customer_birthday": null,
"options_3ds": "supported",
"payment_id": "ccfdd2db-21f8-416b-a3a6-3e9ec9a987c2",
"processed_at": "2024-12-13T08:40:41.503",
"currency": "UAH",
"amount": 100,
"payway": "сс",
"payment_system": "VISA",
"cc_token_expiration": "2025-04-30T00:00:00",
"customer_lname": "Заяці",
"customer_patronym": "Степанівна",
"gateway": "msi:stub",
"bank_name": "АТ ПУМБ"
}
- Обовʼязкові параметри, що зазначені вище, мають бути обовʼязково передані до ПРРО-провайдера разом із масивом products для коректного нарахування Національного кешбеку.