# Adyen + Krokul CRM

Так. Krokul CRM інтегрується з Adyen. Менеджер створює платіж Adyen Pay by Link для рядка плану оплат, а вебхук AUTHORISATION з результатом записує оплату-факт в угоду. Повернення й чарджбеки з Adyen приходять у ту саму угоду, тож борг клієнта в Krokul збігається з тим, що провів Adyen. Звʼязка працює через застосунок Krokul у Make або через 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 з paymentLinkId | Оплата-факт в угоді | Adyen → Krokul | Покупець оплачує посилання |
| CAPTURE | Оплата позначена списаною | Adyen → Krokul | Adyen списує кошти |
| REFUND | Повернення, привʼязане до оплати | Adyen → Krokul | Повернення в Adyen успішне |
| CHARGEBACK, CHARGEBACK_REVERSED | Задача й статус оплати в угоді | Adyen → Krokul | Спір відкрито чи скасовано |
| merchantReference | Номер угоди, зовнішній ключ | Krokul → 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.

### Для інтеграторів

Adyen підписує стандартні вебхуки HMAC-ключем, і підпис лежить в additionalData.hmacSignature. Його обчислено з pspReference, originalReference, мерчант-акаунта, merchant reference, суми, валюти, eventCode і success. Вебхук без успішної відповіді за 10 секунд потрапляє в чергу повторів Adyen, тому приймач спершу підтверджує. Обробка йде потім. З боку Krokul externalRef/api-upsert тримає pspReference поруч з оплатою, а журнал доставок вебхуків повторює будь-який крок, що впав.

[Документація API](https://app.krokul.com/api/v1/docs)

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

### Чи інтегрується 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 переводить їх в основні одиниці на угоді.

## Пов’язані сервіси

- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)
- [PayPal](https://krokul.com/uk/integrations/paypal/index.md)
- [Paddle](https://krokul.com/uk/integrations/paddle/index.md)
- [GoCardless](https://krokul.com/uk/integrations/gocardless/index.md)
- [Wise Business](https://krokul.com/uk/integrations/wise-business/index.md)
- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)

[Платежі й банки](https://krokul.com/uk/integrations/category/payments/index.md)

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

Оновлено: 2026-10-15

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs