Як працює
Callback оплати
WayForPay надсилає дані платежу та merchantSignature на унікальну Service URL вашої інтеграції.
Запис платежу
Успішний платіж прикріплюється до наявного orderReference або зберігається окремо для звірки.
Без дублів
Повторне повідомлення оновлює той самий платіж, не дублює сповіщення й не створює замовлення.
Перевірка підпису
- Алгоритм
- HMAC-MD5 по полях замовлення
- Поле
- merchantSignature
- merchantAccount
- надходить від WayForPay і входить у підпис; окремо в CRM не зберігається
- Дані картки
- PAN, recToken, repayUrl і підпис не зберігаються
Безпека
- Перевірка merchantSignature до запису платежу
- SecretKey перевіряє вхідний підпис і підписує accept-відповідь; у UI не повертається
- Ідемпотентний запис і прив'язка за orderReference
- Генерація підписаного тестового payload
Підключення
- 1
Додайте адаптер WayForPay
Вкажіть лише SecretKey і створіть адаптер — callback працює одразу. Service URL зʼявиться на сторінці адаптера; merchantAccount потрібен тільки для необовʼязкової локальної перевірки.
- 2
Вставте Service URL
Для API передавайте serviceUrl у Purchase або wayforpay.run(...). У кабінеті: Платіжні інструменти → Платіжна кнопка → Додаткові налаштування → Service URL.
- 3
Проведіть контрольну оплату
Локальний приклад можна згенерувати за бажанням; він не активує інтеграцію. Контрольна оплата перевірить налаштування саме вашого кабінету WayForPay і зʼявиться у «Комерція → Оплати» або в наявному замовленні.
Часті запитання
Чим відрізняється від LiqPay?
WayForPay використовує HMAC-MD5 по власному набору полів, зокрема merchantAccount. Це окремий контракт провайдера, а не схема підпису LiqPay.
Чи можна протестувати без реальної оплати?
Так. Локально можна перевірити SecretKey і підпис без запису оплати. Це необовʼязкова діагностика: інтеграція приймає коректно підписані повідомлення одразу після створення. Доставку Service URL і підписану accept-відповідь підтвердить реальна або тестова оплата провайдера.
Чи треба спочатку створювати замовлення в CRM?
Ні. Якщо замовлення вже існує, передайте його externalId як orderReference — оплата прикріпиться до нього. Інакше оплата збережеться окремо для звірки й не створить замовлення автоматично.
Чи може CRM зробити refund або завершити hold?
Ні. Інтеграція лише приймає повідомлення на Service URL і повертає підписану accept-відповідь. Refund, Settle, Charge, інвойси та платіжний віджет залишаються у WayForPay або на вашому сайті.
Підключіть WayForPay
Контролюйте оплати WayForPay в одному журналі та звіряйте їх із замовленнями.
Почати безкоштовно