Так. Krokul CRM інтегрується з WayForPay через API і вебхуки Krokul. Рахунок угоди стає рахунком WayForPay з посиланням invoiceUrl. Повідомлення WayForPay на serviceUrl Krokul приймає сам, перевіряє підпис, проводить оплату фактом і відповідає підписаним accept.
Менеджер відкриває рахунок у Krokul і натискає «Посилання на оплату». Krokul викликає WayForPay з transactionType CREATE_INVOICE і передає orderReference, суму, валюту, позиції документа як productName, productPrice і productCount, email контакту й serviceUrl. Посилання invoiceUrl з’являється в блоці «Оплати» угоди.
Після оплати WayForPay надсилає на serviceUrl JSON із transactionStatus, orderReference, amount і merchantSignature. Krokul перевіряє підпис HMAC_MD5 секретним ключем мерчанта і для статусу Approved закриває планову оплату фактом. Слідом іде подія payment.received, а повне покриття рахунку дає invoice.paid.
На кожне повідомлення Krokul повертає WayForPay JSON з orderReference, status accept, time і підписом. Якщо WayForPay усе ж надіслав повідомлення вдруге, Krokul знаходить orderReference серед уже проведених оплат і другого факту не створює.
Повідомлення зі статусом Declined лишає план відкритим, а в стрічці угоди з’являється запис про невдалу спробу. Менеджер знає, що клієнт пробував платити, і може надіслати посилання ще раз.
Раз на добу Krokul проходить відкриті планові оплати з orderReference і запитує CHECK_STATUS. Якщо оплата пройшла, а повідомлення не дійшло, Krokul проводить її за фактичним станом.
| WayForPay | Напрям | Krokul | Коли |
|---|---|---|---|
| CREATE_INVOICE: orderReference, amount, currency, productName, productPrice, productCount, clientEmail, serviceUrl | Krokul → WayForPay | Рахунок угоди й планова оплата | Менеджер створює посилання на оплату |
| invoiceUrl | WayForPay → Krokul | Посилання в блоці «Оплати» | У відповідь на CREATE_INVOICE |
| orderReference | WayForPay ↔ Krokul | Зовнішній ключ оплати | Під час створення рахунку |
| Повідомлення на serviceUrl, transactionStatus Approved | WayForPay → Krokul | Оплата-факт, подія payment.received | Клієнт оплатив |
| Відповідь accept з підписом | Krokul → WayForPay | Підтвердження прийому повідомлення | На кожне повідомлення |
| transactionStatus Declined | WayForPay → Krokul | Запис про невдалу спробу в стрічці | Оплата не пройшла |
| CHECK_STATUS | Krokul → WayForPay | Відкриті планові оплати | Раз на добу |
document.created. Кожна доставка має заголовок x-crm-signature, і ваш обробник звіряє його зі своїм секретом.externalRef/api-upsert.payment/api-create з cardUuid угоди.Ні. serviceUrl веде прямо в Krokul, який сам перевіряє підпис повідомлення й повертає WayForPay підписану відповідь accept.
Так, якщо в CREATE_INVOICE передано email клієнта. Krokul бере його з контакту угоди, а без email посилання invoiceUrl однаково з’являється в угоді.
WayForPay повторює його, доки не отримає accept. Крім того, Krokul раз на добу звіряє відкриті оплати запитом CHECK_STATUS.
Кожен рядок документа Krokul передає як productName, productPrice і productCount, тож клієнт на сторінці оплати бачить, за що платить.
WayForPay повторює повідомлення на serviceUrl, доки не отримає правильну відповідь, і робить це до чотирьох днів. Лист клієнту з рахунком WayForPay надсилає лише тоді, коли в рахунку є його email.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
WayForPay є торговою маркою її власника. Krokul не афілійований із WayForPay.