Підключення програмного РРО

Як налаштувати роботу ПРРО

1. Зареєструйте касу в нашого партнера-провайдера ПРРО

   Доступні сервіси ПРРО
   Наразі доступний один сервіс — Cash Desk

2. Внесіть нові параметри в API-запит

Додатково до стандартного набору параметрів платіжного запиту, необхідно передавати більше даних про товар для всіх платежів та повернень: методи purchase, auth, capture, refund.

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		Штрих-код товару (опційний для фіскалізації, але обов’язковий для програми “Національний кешбек”)
customer_email	String	✅	Електронна пошта платника (є опційним параметром у випадку, якщо її введення є обов’язковим на чекауті)
products.taxes.type	String		Тип податку (допустимі значення vat, non-vat). Якщо субʼєкт господарювання не є платником ПДВ має передаватися значення non-vat
products.taxes.prc	Number		Податкова ставка % (допустимі значення 0, 7, 14, 20)

Приклад Body запиту на Tranzzo:

{
  "pos_id": "00000000-0000-0000-0000-000000000000",
  "mode": "direct",
  "method": "purchase",
  "amount": 100,
  "currency": "UAH",
  "cc_number": "4111111111111111",
  "exp_month": 12,
  "exp_year": 24,
  "card_cvv": "123",
  "order_id": "123456789",
  "description":"Опис товару",
  "payway": "cc",
  "order_3ds_bypass": "supported",
  "customer_email": "[email protected]",
  "products": [{
    "id": "1",
    "name": "product name",
    "unit": "pc",
    "bar_code":"4876534567183",
    "amount": 50,
    "taxes": [{"type":"vat", "prc": 20}],
    "qty": 2
  }],
  "server_url": "http://callback-stub:9000/consume"
}

Важливо

Обов’язково внесіть зміни до API-інтеграції перш ніж переходити до наступного кроку. Якщо ви увімкнете ПРРО до того, як внести зміни у API-запит, то платежі не будуть проходити через відсутність обов'язкових параметрів.

1. Підключіть ПРРО через мерчант-портал

1. Відкрийте загальні налаштування мерчантського облікового запису та оберіть пункт ПРРО.

2. Натисніть кнопку Нова конфігурація.

3. Заповніть форму:

   • Імʼя конфігурації: будь-яке значення на ваш вибір.
   • Надавач послуг: провайдер ПРРО, в якому ви зареєстрували касу (наразі доступний тільки Cash Desk).
   • Ідентифікатор каси (ПРРО ID):
     приклад даних із Cash Desk параметрів "num_fiscal": “100000000000”
   • API-токен із сервісу-провайдера ПРРО:
     приклад даних із Cash Desk “api_token” : "00000000-0000-0000-0000-000000000000
   • Область застосування: оберіть зі списку потрібну юридичну особу чи ФОП.
   • Переведіть в активне положення перемикач “Увімкнути використання ПРРО при проведення платежів”. Має виглядати як на скріншоті нижче.

4. Перевірте дані та відправте форму.
   Після відправки форми застосування ПРРО буде увімкнено для відповідної конфігурації.

   

5. Додайте ЕЦП для підписання фіскальних чеків відповідного субʼєку господарювання.
   

   • В розділі ПРРО оберіть вкладку ЕЦП.
   • Оберіть опцію “Додати ЕЦП”.
   • Введіть бажану назву ЕЦП та субʼєкт господарювання, якому він належить.
   • Завантажте файл ключа та введіть пароль до нього.
   • Підтвердіть завантаження, натиснувши кнопку “Надіслати”.

Після цього наступні фіскальні чеки відповідного субʼєкта господарювання будуть підписуватися завантаженим ключем до його заміни чи видалення, або до моменту спливу терміну дії.

інформація

Якщо ви не користуєтеся мерчант-порталом, то для підключення ПРРО напишіть своєму аканут-менеджеру або команді підтримки на [email protected]