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

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

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)
customer_email	String	✅	Електронна пошта платника (є опційним параметром у випадку, якщо її введення є обов’язковим на чекауті)
products.taxes.type	String		Тип податку (допустимі значення vat, non-vat)
products.taxes.prc	Number		Податкова ставка % (допустимі значення 0, 5, 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",
    "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. Перевірте дані та відправте форму.
   Після відправки форми застосування ПРРО буде увімкнено для відповідної конфігурації.

інформація

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