Перейти до основного вмісту

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

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

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

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

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

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

ParameterTypeRequiredDescription
products.idUUIDУнікальний ідентифікатор товару
products.nameStringНазва продукту
products.amount NumberВартість за одиницю товару/роботи/послуги
products.qtyNumberКількість (загальний amount платежу = product.qty * product.amount)
products.unitStringОдиниця вимірювання (допустимі значення kg, m, pc, l)
customer_emailStringЕлектронна пошта платника (є опційним параметром у випадку, якщо її введення є обов’язковим на чекауті)
products.taxes.typeStringТип податку (допустимі значення vat, non-vat)
products.taxes.prcNumberПодаткова ставка % (допустимі значення 0, 5, 20)

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

{
"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": "test@gmail.com",
"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. Перевірте дані та відправте форму.
    Після відправки форми застосування ПРРО буде увімкнено для відповідної конфігурації.

SBCR

інформація

Якщо ви не користуєтеся мерчант-порталом, то для підключення ПРРО напишіть своєму аканут-менеджеру або команді підтримки на support@finline.io