# GoCardless + Krokul CRM

Так. Krokul CRM інтегрується з GoCardless. Виграна угода надсилає клієнту запит на мандат, кожен рядок плану оплати стягується за цим мандатом як платіж Direct Debit, а підтверджений платіж GoCardless закриває рядок у Krokul. Працює це через застосунок Krokul у Zapier і Make або через API та вебхуки Krokul.

**Статус:** Через API і вебхуки. **Платформи автоматизації:** Zapier, Make.

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

### Виграна угода просить у клієнта мандат

Регулярні B2B-договори часто оплачуються через Direct Debit. Коли угоду виграно, Krokul створює в GoCardless запит на авторизацію мандата для контрагента й кладе посилання на угоду. Менеджер надсилає його разом із договором, і клієнт підтверджує мандат на сторінці GoCardless.

### Активний Mandate зберігається на контрагенті

GoCardless повідомляє, що мандат активний, коли банк клієнта його прийняв. Krokul записує Mandate ID на контрагента й позначає компанію готовою до стягнення. Наступний рахунок уже не чекає на папери.

### План оплати стягується сам

Кожен рядок плану оплати з датою і способом Direct Debit стає платежем GoCardless (Payment) за активним мандатом, а сам рядок іде в призначення. Поруч Krokul показує стан у GoCardless, тож бухгалтер бачить, що чекає на списання до дати стягнення.

### Підтверджений платіж закриває рядок, невдалий відкриває задачу

Коли GoCardless підтверджує, що банк стягнув гроші, Krokul записує фактичну оплату в рядок плану й надсилає `payment.received`. Невдалий Payment або скасований Mandate створює задачу для менеджера клієнта. Якщо GoCardless повідомляє, що спробує списати ще раз, Krokul чекає на повторну спробу і лише після неї створює задачу.

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

| GoCardless | Krokul | Напрям | Коли |
|---|---|---|---|
| Запит на авторизацію мандата | Виграна угода і її контрагент | Krokul → GoCardless | Угоду виграно |
| Mandate (активний, скасований) | Стан мандата на контрагенті | GoCardless → Krokul | Події GoCardless для `mandates` |
| Payment | Рядок плану оплати зі способом Direct Debit | Krokul → GoCardless | Рядок плану збережено з датою |
| Платіж підтверджено | Фактична оплата, що закриває рядок | GoCardless → Krokul | Подія GoCardless для `payments` з дією `confirmed` |
| Платіж не вдався | Задача на угоді | GoCardless → Krokul | Подія GoCardless для `payments` з дією `failed` |
| Повернення | Повернення, прив’язане до оплати | GoCardless → Krokul | Повернення зроблено в GoCardless |

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

### Застосунок Krokul у Zapier або Make

1. Підключіть застосунок Krokul ключем API Krokul.
2. Візьміть тригер Krokul Deal Won з дією GoCardless Create Mandate Authorisation Request або Document Created з Create Direct Debit Payment.
3. Зворотний шлях почніть із Payment Confirmed, Failed Payment чи Mandate Cancelled і дії Krokul Record Payment, Create Task або Save External Key.

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

1. Створіть access token у налаштуваннях розробника GoCardless і ключ API Krokul з доступом до контрагентів, оплат і задач.
2. Підпишіть вебхук Krokul на card.won, перевіряйте x-crm-signature своїм секретом, створюйте запит на мандат у GoCardless і зберігайте Mandate ID на контрагенті через externalRef/api-upsert.
3. Додайте свій приймач як webhook endpoint у GoCardless і перевіряйте заголовок Webhook-Signature у кожній події.
4. Для підтвердженого платежу викличте payment/api-create з cardUuid угоди. Для невдалого, де will_attempt_retry дорівнює false, відкрийте задачу через task/api-create.

**Тригери:** New Mandate Created; Mandate Activated; Mandate Cancelled; Payment Confirmed; Payment Paid Out; Failed Payment.

**Дії:** Create Mandate Authorisation Request; Create Direct Debit Payment; Create Subscription; Search for a Customer; Search for a Mandate; Search for a Payment.

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

Вебхуки GoCardless несуть `resource_type` (наприклад, `payments` чи `mandates`), `action` (наприклад, `confirmed` чи `cancelled`) і посилання на змінений об’єкт. Кожен запит підписано в заголовку `Webhook-Signature`. Подія невдалого платежу має прапорець `will_attempt_retry`. Для власного моста API Krokul зберігає Mandate ID як зовнішній ключ на контрагенті й приймає оплати з `kind`, що дорівнює `fact`. n8n і Albato звертаються до GoCardless звичайними HTTP-кроками.

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

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

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

Так. Krokul інтегрується з GoCardless через застосунок Krokul у Zapier і Make, а також через свої API та вебхуки.

### Коли платіж GoCardless вважається отриманим у Krokul?

GoCardless позначає платіж як confirmed, коли банк його стягнув, і як paid out, коли гроші вже йдуть до вас. У своєму потоці ви вибираєте один із двох моментів, і Krokul застосовує його до всіх клієнтів.

### Де Krokul зберігає мандат GoCardless?

На контрагенті, як зовнішній ключ разом зі станом мандата. Ним користуються всі рядки Direct Debit цього клієнта.

### Що буде, якщо списання Direct Debit не вдалося?

Krokul створює на угоді задачу для менеджера клієнта. Коли GoCardless планує повторну спробу, Krokul спершу чекає на її результат.

## Обмеження

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

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

- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)
- [PayPal](https://krokul.com/uk/integrations/paypal/index.md)
- [Chargebee](https://krokul.com/uk/integrations/chargebee/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)
- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)

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

GoCardless є торговельною маркою GoCardless Ltd. Krokul не пов’язаний з GoCardless.

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

---

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