Платіжні системи

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

Ця сторінка розташована в Налаштування → Інтеграції → Платіжні системи.

Чому платіжні системи важливі

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

Підключених платіжних провайдерів можна використовувати в таких місцях:

• Оформлення замовлення на клієнтському порталі: онлайн-способи оплати можна увімкнути лише після налаштування відповідного провайдера.
• Бронювання: спроби онлайн-оплати створюють записи оплат, повʼязані з бронюванням.
• Рахунки та платіжні посилання: клієнти можуть відкрити посилання на оплату провайдера із записів оплат.
• Оновлення статусу оплати: зворотні виклики провайдера оновлюють статус оплати бронювання, коли оплата успішна, невдала, прострочена або скасована.

Що ви побачите

Сторінка групує провайдерів у два розділи:

• Глобальні системи: Stripe для оплати карткою в будь-якій із 14 валют Requiply.
• Українські системи: Plata by mono, LiqPay та WayForPay.

Кожна картка провайдера містить:

• Назву провайдера та логотип.
• Стан налаштування: Налаштовано або Ще не налаштовано.
• Інструкція: відкриває в новій вкладці браузера покрокову інструкцію Requiply з налаштування цього провайдера мовою вашого інтерфейсу. Картка Stripe не має посилання на інструкцію: кроки налаштування Stripe наведено нижче в розділі Stripe.
• Налаштувати: відкриває форму з даними доступу для цього провайдера. Коли провайдера налаштовано, кнопка називається Керувати і відкриває ту саму форму.

Поточний каталог провайдерів:

Відкриття інструкції

Натисніть Інструкція на картці провайдера, коли потрібна допомога з пошуком даних доступу в обліковому записі провайдера. Requiply відкриє в новій вкладці власну покрокову інструкцію для цього провайдера: англійську чи українську версію відповідно до мови вашого інтерфейсу.

Інструкції з налаштування:

Налаштування провайдера

Натисніть Налаштувати на картці провайдера, щоб відкрити діалог налаштування. Діалог показує логотип вибраного провайдера і дані доступу, які потрібні Requiply для нього.

Після натискання Зберегти Requiply перевіряє дані доступу в платіжного провайдера, перш ніж зберегти інтеграцію. Якщо перевірка успішна, провайдер стає активним для вашої організації, а картка може перейти в стан Налаштовано. Якщо перевірка не вдалася, Requiply показує помилку і не зберігає провайдера як активного.

Натисніть Скасувати, щоб закрити діалог налаштування без збереження змін.

Поля провайдерів

Plata by mono

Requiply перевіряє токен у Monobank перед збереженням. Токен із недійсними дозволами чи неправильним значенням буде відхилено. Токени з бізнес-кабінету Monobank, зокрема облікових записів юридичних осіб, також проходять перевірку. Якщо такий токен раніше відхилили, спробуйте зберегти його ще раз.

LiqPay

Requiply перевіряє публічний і приватний ключі LiqPay перед збереженням провайдера.

WayForPay

Requiply перевіряє дані мерчанта WayForPay перед збереженням провайдера.

Stripe

Requiply перевіряє секретний ключ у Stripe перед збереженням. Webhook signing secret під час збереження не перевіряється: якщо він неправильний або вебхука немає, клієнти все одно можуть платити, але оплата в Requiply залишається в статусі Очікується, бо оновлення від Stripe не надходять або відхиляються.

Додавання вебхука Requiply у Stripe

Stripe повідомляє Requiply про оплачені, невдалі, прострочені та повернені платежі через вебхук. Додайте його, перш ніж зберігати інтеграцію:

1. У Stripe Dashboard відкрийте Developers → Webhooks і додайте endpoint (у новіших версіях Dashboard це називається event destination).
2. Укажіть URL endpoint https://app.requiply.com/api/payment-integrations/stripe/update-status.
3. Виберіть такі події: checkout.session.completed, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, checkout.session.expired, а також charge.refunded.
4. Збережіть endpoint, відкрийте його Signing secret і вставте його в поле Webhook signing secret у Requiply.

Валюти та суми

Stripe стягує з клієнтів оплату у валюті вашої організації. Підтримуються всі 14 валют Requiply, зокрема індійська рупія (INR). JPY стягується в цілих єнах, а ISK у цілих кронах, тому суми в цих валютах округлюються до цілої одиниці.

Stripe також має мінімальну суму стягнення для кожної валюти, наприклад 0,50 USD чи EUR, 0,30 GBP, 2,50 DKK, 3,00 NOK або 50 JPY. Платіжне посилання на суму, меншу за мінімум, буде відхилено. Повні правила див. у розділі Stripe's supported currencies.

Оновлення даних доступу

Щоб замінити токен, приватний ключ чи секрет мерчанта, натисніть Керувати на картці того самого провайдера, введіть нові дані доступу і натисніть Зберегти. Requiply оновить наявну активну інтеграцію, щойно нові дані доступу пройдуть перевірку.

Після налаштування збережені секретні значення на сторінці не показуються. Зберігайте захищену копію в обліковому записі платіжного провайдера або в менеджері паролів.

Відключення провайдера

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

Де використовуються платіжні інтеграції

Типові сценарії

Перше підключення онлайн-оплат

1. Перейдіть у Налаштування → Інтеграції → Платіжні системи.
2. Виберіть провайдера, яким користується ваша організація.
3. Натисніть Інструкція, якщо потрібна допомога з пошуком необхідних даних доступу.
4. Натисніть Налаштувати.
5. Введіть дані доступу провайдера.
6. Натисніть Зберегти.
7. Переконайтеся, що картка провайдера перейшла в стан Налаштовано.
8. Перейдіть на вкладку оплат у налаштуваннях порталу і за потреби увімкніть відповідний онлайн-спосіб оплати.

Оновлення даних доступу провайдера

1. Перейдіть у Налаштування → Інтеграції → Платіжні системи.
2. Натисніть Керувати на провайдері, якого треба оновити.
3. Введіть новий токен, ключі чи дані мерчанта.
4. Натисніть Зберегти.
5. Переконайтеся, що налаштування пройшло успішно.

Якщо налаштування не вдалося

У такому разі:

• Переконайтеся, що дані доступу скопійовано з правильного облікового запису провайдера.
• Перевірте, що обліковий запис провайдера активний і може створювати платежі.
• Переконайтеся, що валюту організації підтримує провайдер, яким ви хочете користуватися.
• Для Stripe вставляйте секретний ключ (sk_...), а не публічний (pk_...).
• Для LiqPay та WayForPay перевірте, що публічні й секретні дані доступу належать тому самому обліковому запису мерчанта.
• Відкрийте інструкцію провайдера і повторіть кроки налаштування з панелі провайдера.

Оплати Stripe залишаються в статусі «Очікується»

Якщо клієнти платять через Stripe, але оплата в Requiply залишається в статусі Очікується:

• Перевірте, що вебхук у Stripe вказує на https://app.requiply.com/api/payment-integrations/stripe/update-status і слухає події, перелічені в розділі Додавання вебхука Requiply у Stripe.
• Перевірте, що signing secret, збережений у Requiply, належить саме цьому вебхуку і тому самому режиму (тестовому чи робочому), що й секретний ключ.
• Після виправлення вебхука натисніть Керувати на картці Stripe і збережіть правильний signing secret.