Підключення WayForPay у Kiero Store
WayForPay — платіжний провайдер для Kiero Store. Підключення налаштовується в адміністрації магазину, у розділі Оплати (/admin/payments). Store надсилає платіжні запити й обробляє повідомлення провайдера; OMS отримує підтверджені замовлення та результати операцій. Секретний ключ продавця й дані карток до OMS не передаються.
Що підготувати
Потрібні права власника або адміністратора Store та власний обліковий запис продавця WayForPay. Ця інтеграція Store потребує UAH; перевірте наявність цін каталогу в цій валюті. За іншої валюти магазину підключення недоступне. Вибір валюти не конвертує ціни товарів і не активує обліковий запис продавця.
Створіть магазин у кабінеті WayForPay та виконайте вимоги провайдера для активації. Актуальні вимоги до вашого облікового запису наведені в офіційній інструкції активації. Комісії, умови виплат і ліміти визначає провайдер окремо від налаштувань Kiero.
Де знайти Merchant Login і Merchant Secret Key
- Увійдіть у кабінет WayForPay.
- Відкрийте Налаштування магазину → Ваш магазин → Реквізити мерчанта.
- Скопіюйте Merchant Login у поле Ідентифікатор продавця (Merchant Login) у Store.
- Скопіюйте Merchant Secret Key у поле секретного ключа. Це не пароль від кабінету.
Дивіться офіційну інструкцію щодо реквізитів мерчанта. Не надсилайте секретний ключ підтримці та не додавайте його до знімків екрана, публічних сторінок чи коментарів замовлень OMS.
Підключення та ввімкнення оплат
- У розділі Оплати Store відкрийте Підключення WayForPay.
- Введіть ідентифікатор продавця (Merchant Login) та Merchant Secret Key і натисніть Підключити.
- Дочекайтеся автоматичної перевірки. Кнопка Оновити стан підключення отримує поточний результат; для збереженого підключення вводити ключ повторно не потрібно.
- Коли підключення буде готове, перевірте показаний обліковий запис. Підтвердьте приймання реальних оплат через нього й натисніть Увімкнути приймання оплат.
- Переконайтеся, що сторінка показує активний WayForPay. До цього не вважайте, що магазин уже приймає реальні платежі.
Kiero визначає домен і технічні параметри повідомлень. Майстер не потребує ручного налаштування webhook або тестової покупки. Збереження іншого облікового запису не перемикає чинні оплати одразу; заміна відбувається після перевірки та вашого підтвердження.
Що означає стан
| Стан | Що робити |
|---|---|
| Перевіряємо обліковий запис | Зачекайте й оновіть стан. |
| Некоректні реквізити | Перевірте Merchant Login і Merchant Secret Key потрібного магазину. |
| Немає доступу до API | Зверніться до WayForPay з показаним кодом; код 1117 потребує перевірки доступу до API. |
| Обліковий запис обмежено | Перевірте активацію й ліміти в WayForPay; якщо код 1118 залишається, зверніться до провайдера. |
| Очікування перевірки сервісу | Дочекайтеся технічної перевірки Kiero; повторне збереження ключа не вмикає оплати. |
| Підключення готове | Перевірте обліковий запис і підтвердьте приймання оплат. |
| Активне | Підключення ввімкнено; операції й надалі залежать від дозволів та лімітів провайдера. |
За тимчасової недоступності API оновіть стан пізніше. Не замінюйте коректні реквізити багато разів, намагаючись прибрати тимчасову помилку.
Замовлення, історія та повернення
Після підтвердження платежу замовлення й результат операції надходять до OMS. Саме повернення покупця на сайт не доводить успіх: система має отримати перевірений результат провайдера. У розділі Оплати Store є історія WayForPay для налаштованого облікового запису.
У реалізованому процесі повернення коштів потребує затвердженого рішення про повернення в OMS та підтвердження власника у Store. Невизначений результат повернення потрібно з’ясувати перед наступною спробою; не повторюйте повернення без перевірки. Дивіться повернення.
Стан перевірки на 19 жовтня 2026: налаштування, активація й захист повернень перевірені за кодом та локальними тестами. Документація проєкту ще не підтверджує реальні оплати й повернення у провайдера. Збереження реквізитів або успішна технічна перевірка не усувають цього обмеження.
Безпека та допомога
Вводьте ключ продавця лише у формі підключення. Якщо його розкрито, замініть через WayForPay та оновіть підключення Store. Для підтримки підготуйте показаний стан, ідентифікатор продавця та код помилки без ключів і даних карток.
Дивіться також інтеграції та Kiero Store.