# Revolut Business + Krokul CRM

Так. Krokul CRM інтегрується з Revolut Business через Revolut Business API та його вебхуки з тим доступом, який погодила ваша компанія. Кожну завершену вхідну транзакцію Krokul зіставляє з відкритим рядком плану оплат і записує як отриману в угоді. У Zapier і Make застосунок Krokul працює разом із тамтешніми застосунками Revolut Business.

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

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

### Завершена вхідна транзакція оплачує угоду

Коли на Account надходять гроші, Revolut Business надсилає `TransactionCreated`, а потім `TransactionStateChanged`. Щойно вхідна Transaction переходить у стан completed, з’єднання Krokul порівнює її суму й валюту з відкритими рядками плану оплат. Якщо збіг рівно один, Krokul проводить на цьому рядку оплату-факт і надсилає подію `payment.received`.

### Гроші в очікуванні чекають стану completed

Transaction у Revolut починається в стані pending і може закінчитися як completed, declined, failed чи reverted. Надходження в pending Krokul показує на відповідному рядку як очікувані гроші, а факт проводить лише на completed. Якщо проведену транзакцію згодом повернуто (reverted), Krokul ставить бухгалтеру задачу в угоді.

### Дві однакові суми йдуть до бухгалтера

Коли та сама сума чекає оплати у двох угодах або не підходить жоден рядок, надходження лишається незіставленим у реєстрі оплат із задачею для бухгалтера. Бухгалтер вибирає рядок, а Krokul запам’ятовує ID цієї Transaction у Revolut, тож одне надходження ніколи не проводиться двічі.

### Рахунок для зарахування друкується в рахунках клієнтам

Кожен Account у Revolut Business, який бачить з’єднання, з’являється в Krokul як банківський рахунок для зарахування. Менеджер вибирає його в чернетці рахунку, і клієнт платить саме на той рахунок, транзакції якого Krokul уже відстежує.

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

| Revolut Business | Krokul | Напрям | Коли |
|---|---|---|---|
| Transaction (вхідна, completed) | Оплата-факт, що закриває рядок плану оплат | Revolut → Krokul | Вебхук `TransactionStateChanged` у completed, один відповідний рядок |
| Transaction (pending) | Очікувані гроші на відповідному рядку | Revolut → Krokul | Вебхук `TransactionCreated` |
| Transaction без єдиного збігу | Незіставлене надходження й задача | Revolut → Krokul | Відповідних рядків нуль або кілька |
| Transaction reverted чи declined | Задача в угоді | Revolut → Krokul | Вебхук `TransactionStateChanged` |
| Account | Банківський рахунок для зарахування в рахунку клієнту | Revolut → Krokul | Під час налаштування з’єднання |

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

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

1. Підключіть застосунок Krokul на платформі ключем API Krokul.
2. Почніть Zap із тригера Revolut Business New Transaction і відфільтруйте вхідні транзакції в стані completed. Find Account підкаже, на який рахунок Revolut прийшли гроші.
3. Завершіть дією Krokul Record Payment або Create Task, коли жодна угода не підходить. У Make є застосунок Revolut Business, і кроки Krokul там ті самі.

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

1. Випустіть у Krokul ключ API зі scope на оплати й підпишіть вебхук Revolut v2 на `TransactionStateChanged`. Перевіряйте підпис Revolut HMAC-SHA256 до розбору тіла.
2. Для завершеної вхідної Transaction прочитайте відкриті рядки через `payment/api-readList` з `openPlans: true` і проведіть збіг через `payment/api-create` з `cardUuid` угоди.
3. Збережіть ID транзакції Revolut на оплаті через `externalRef/api-set`, щоб повторна доставка знаходила вже наявний запис.
4. Якщо факт потрібен іншій системі, підпишіть вебхук Krokul на `payment.received` і перевіряйте `x-crm-signature` на кожній доставці.

**Тригери:** New Transaction.

**Дії:** Find Account.

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

У вебхуках Revolut Business v2 підписуються на `TransactionCreated`, `TransactionStateChanged`, `PayoutLinkCreated` і `PayoutLinkStateChanged`. Кожне сповіщення підписане HMAC-SHA256 від префікса версії, мітки часу й сирого тіла, тож перевіряйте підпис до розбору. Зміна стану може прийти раніше за подію створення, якщо доставку повторювали, тому міст пише в Krokul ідемпотентно через `externalRef/api-upsert` з ключем за ID транзакції Revolut.

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

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

### Чи підключається Krokul до Revolut Business напряму?

Krokul підключається через Revolut Business API з тим доступом, який ваша компанія погоджує в Revolut. Він читає рахунки й транзакції в межах цього доступу, і доступ можна відкликати з боку Revolut.

### Які події Revolut використовує Krokul?

Вебхуки `TransactionCreated` і `TransactionStateChanged`. У Zapier ту саму роботу для власних потоків виконує тригер Revolut Business New Transaction.

### Що буде, якщо та сама сума чекає оплати у двох угодах?

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

### Чи може Krokul створити переказ чи виплату в Revolut?

Ні. Krokul записує вхідні оплати й повернення за угодами. Вихідними грошима керують у Revolut Business.

## Обмеження

Перекази, витрати з карток і виплати лишаються в Revolut Business: Krokul читає вхідні гроші й не рухає їх. Транзакція Revolut вважається отриманою лише в стані completed.

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

- [Wise Business](https://krokul.com/uk/integrations/wise-business/index.md)
- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)
- [PayPal](https://krokul.com/uk/integrations/paypal/index.md)
- [GoCardless](https://krokul.com/uk/integrations/gocardless/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)

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

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

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

---

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