UK
Подивитися демо

Adyen + Krokul CRM

Так. Krokul CRM інтегрується з Adyen. Менеджер створює платіж Adyen Pay by Link для рядка плану оплат, а вебхук AUTHORISATION з результатом записує оплату-факт в угоду. Повернення й чарджбеки з Adyen приходять у ту саму угоду, тож борг клієнта в Krokul збігається з тим, що провів Adyen. Звʼязка працює через застосунок Krokul у Make або через API і вебхуки Krokul.

  • Через API і вебхукиВи підключаєте сервіс застосунком Krokul у платформі автоматизації, публічним API і підписаними вебхуками. Кроки для цього сервісу є на сторінці.

Платформи автоматизаціїMake

Що отримує команда

Рядок плану оплат стає посиланням Adyen

Менеджер обирає Adyen на рядку плану оплат угоди. Krokul викликає Pay by Link API з мерчант-акаунтом, сумою в мінімальних одиницях і номером угоди як reference та отримує ідентифікатор посилання, його URL і час завершення. Посилання без явного строку живе 24 години, тому Krokul ставить дату, яку менеджер погодив із клієнтом.

AUTHORISATION закриває рядок

Результат платежу Pay by Link Adyen повідомляє у вебхуку AUTHORISATION, що несе paymentLinkId в additionalData і прапорець success. Якщо success дорівнює true, Krokul знаходить рядок плану за ідентифікатором посилання й записує оплату-факт. Борг контрагента зменшується, і подія payment.received спрацьовує для всіх підписаних. Значення false натомість додає коментар. Рядок лишається відкритим.

Списання й повернення тримають суму точною

Мерчанти з відкладеним списанням отримують вебхук CAPTURE, коли кошти списано, і Krokul позначає оплату як списану. Вебхук REFUND із success true проводить повернення до оплати, яку Krokul раніше записав під тим самим pspReference. Якщо після повернення рахунок оплачено не повністю, рахунок знову відкривається, а угода показує чисту суму.

Чарджбек бачить менеджер клієнта

Вебхук CHARGEBACK створює задачу власнику угоди з merchant reference, сумою й строком спору з Adyen. Менеджер говорить із клієнтом, поки фінансова команда готує захист у Customer Area Adyen. CHARGEBACK_REVERSED закриває задачу й відновлює оплату.

Що передається між системами

AdyenНапрямKrokulКоли
Посилання на оплату (/paymentLinks: id, url, expiresAt)Krokul → AdyenРядок плану оплат в угодіМенеджер запитує посилання
AUTHORISATION з paymentLinkIdAdyen → KrokulОплата-факт в угодіПокупець оплачує посилання
CAPTUREAdyen → KrokulОплата позначена списаноюAdyen списує кошти
REFUNDAdyen → KrokulПовернення, привʼязане до оплатиПовернення в Adyen успішне
CHARGEBACK, CHARGEBACK_REVERSEDAdyen → KrokulЗадача й статус оплати в угодіСпір відкрито чи скасовано
merchantReferenceKrokul → AdyenНомер угоди, зовнішній ключКожне посилання й платіж

Як підключити сьогодні

Застосунок Krokul у Make

  1. Підключіть застосунок Krokul ключем API Krokul, а застосунок Adyen ключем API Adyen для вашого мерчант-акаунта.
  2. Почніть сценарій із тригера Krokul Document Created для рахунку й викличте Create a Payment Link з номером угоди як reference.
  3. Для зворотного шляху почніть із Watch Events у застосунку Adyen, відфільтруйте AUTHORISATION і REFUND та завершіть дією Krokul Record Payment.

Власний потік через API і вебхуки Krokul

  1. Створіть у Adyen обліковий запис API з доступом до Checkout і стандартний вебхук із HMAC-ключем. У Krokul видайте ключ API з правами на угоди, документи й оплати.
  2. Підпишіть вебхук Krokul на document.created, перевіряйте x-crm-signature і викликайте POST /paymentLinks на суму рахунку з номером угоди як reference.
  3. Збережіть ідентифікатор посилання Adyen на документі через externalRef/api-upsert.
  4. На кожен вебхук Adyen перевіряйте additionalData.hmacSignature, відповідайте статусом 2xx, знаходьте угоду через externalRef/api-resolve і пишіть payment/api-create з її cardUuid або payment/api-refund.

Тригери

  • Watch Events

Дії

  • Create a Payment Link
  • Get a Payment Link
  • Update a Payment Link Status
  • Capture an Authorised Payment
  • Refund a Captured Payment
  • Get Disputes
  • Make an API Call

Питання й відповіді

Чи інтегрується Krokul з Adyen?

Так. Krokul інтегрується з Adyen через застосунок Krokul у Make і через свої API та вебхуки, для посилань на оплату, авторизацій, повернень і чарджбеків.

Як Krokul дізнається, до якої угоди належить платіж Adyen?

Кожне посилання несе номер угоди як reference в Adyen, а Krokul зберігає ідентифікатор посилання як зовнішній ключ. Вебхук AUTHORISATION повертає paymentLinkId, тож Krokul знаходить рядок плану без здогадок.

Що відбувається з невдалим платежем Adyen?

Вебхук AUTHORISATION приходить із success, що дорівнює false. Krokul додає коментар в угоду, а рядок плану лишається неоплаченим, доки клієнт не оплатить посилання ще раз або менеджер не створить нове.

Чи змінює повернення Adyen рахунок у Krokul?

Так. Успішний вебхук REFUND проводить повернення до початкової оплати, а рахунок, який після повернення оплачено не повністю, знову відкривається в угоді.

Обмеження

Мерчант-акаунти, способи оплати, правила ризику й виплати лишаються в Adyen. Суми Adyen передає в мінімальних одиницях валюти, і Krokul переводить їх в основні одиниці на угоді.

Чогось бракує?

Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.

Запит отримано. Відповімо на вашу пошту.

Adyen є торговою маркою Adyen N.V. Krokul не афілійований з Adyen.

Подивитися демо