Як працює
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?
Так, якщо на сторінці адаптера збережено merchantAccount і домен сайту: тоді кнопка «Посилання на оплату» на замовленні чи рахунку виставить рахунок WayForPay і поверне посилання, яке менеджер надішле покупцю. Посилання діє добу, а оплата прикріпиться сама. Одна особливість WayForPay: після оплати покупець залишиться на сторінці результату провайдера — його метод створення рахунку не приймає адреси повернення.
Чи може CRM зробити refund або завершити hold?
Ні. Інтеграція лише приймає повідомлення на Service URL і повертає підписану accept-відповідь. Refund, Settle, Charge, інвойси та платіжний віджет залишаються у WayForPay або на вашому сайті.
Підключіть WayForPay
Контролюйте оплати WayForPay в одному журналі та звіряйте їх із замовленнями.
Почати безкоштовно