# Recurly + Krokul CRM

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

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

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

### Підписана угода відкриває підписку Recurly

Угода, виграна у воронці підписок, надсилає в Recurly одну покупку. У ній акаунт із кодом контрагента Krokul і підписка з кодом плану й кількістю з угоди. Recurly повертає account code та ідентифікатор підписки. Krokul зберігає обидва як зовнішні ключі, тож повторне збереження тієї ж угоди нічого в Recurly не змінює.

### Зміни підписки потрапляють на контрагента

JSON-вебхуки Recurly несуть лише тип обʼєкта, тип події й ідентифікатори. На подію підписки на зразок renewed, paused, canceled чи expired Krokul дочитує підписку з API Recurly й оновлює її копію для читання на контрагенті. Звіт рухів MRR у Krokul тоді враховує зміну із сумою, яку тримає Recurly.

### Оплачені й прострочені рахунки

Коли Recurly надсилає charge_invoice.paid, Krokul записує оплату-факт в угоду, з якої почалась підписка. Подія charge_invoice.past_due йде менеджеру клієнта задачею з номером рахунку й залишком. Recurly далі стягує борг власним dunning.

### Невдалий платіж карткою бачить власник клієнта

Сповіщення про платіж із типом події failed додає активність до контрагента. Менеджер бачить відхилене списання поруч із відкритими угодами й останніми дзвінками. Перед допродажем це важливо знати.

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

| Recurly | Krokul | Напрям | Коли |
|---|---|---|---|
| Account (account code) | Контрагент, зовнішній ключ | Krokul → Recurly | Перша підписка клієнта |
| Subscription з кодом плану | Виграна угода у воронці підписок | Krokul → Recurly | Угоду виграно |
| Події підписки (renewed, paused, canceled, expired) | Підписка для читання й рух MRR | Recurly → Krokul | Recurly змінює підписку |
| Рахунок оплачено (charge_invoice.paid) | Оплата-факт в угоді | Recurly → Krokul | Рахунок оплачено |
| Рахунок прострочено (charge_invoice.past_due) | Задача менеджеру клієнта | Recurly → Krokul | Минув строк оплати рахунку |
| Невдалий платіж | Активність на контрагенті | Recurly → Krokul | Списання відхилено |

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

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

1. Підключіть застосунок Krokul ключем API Krokul.
2. Від тригера Krokul Deal Won викличте Create Account у Zapier чи Create an Account у Make або Create subscription в Albato для плану угоди.
3. У зворотний бік почніть із New Subscription, New Invoice чи New Transaction у Zapier або Watch Transactions у Make і завершіть діями Krokul Record Payment чи Add Activity.

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

1. Створіть приватний ключ API Recurly і JSON-ендпоінт вебхуків. У Krokul видайте ключ API з правами на угоди, контрагентів і оплати.
2. Підпишіть вебхук Krokul на card.won з фільтром pipelineUuid на воронку підписок і перевіряйте x-crm-signature на кожній доставці.
3. Створіть покупку Recurly для цієї угоди й збережіть account code та ідентифікатор підписки через externalRef/api-upsert.
4. На кожен вебхук Recurly перевіряйте recurly-signature, дочитуйте обʼєкт за ідентифікатором, знаходьте угоду через externalRef/api-resolve і пишіть payment/api-create з її cardUuid або activity/api-create.

**Тригери:** New Account; New Subscription; New Invoice; New Transaction; Push Notification; Watch Accounts; Watch Transactions; Invoice paid.

**Дії:** Create Account; Update Account; Create an Account; Create subscription; Create Invoice.

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

Recurly підписує JSON-вебхуки значенням HMAC-SHA256 у заголовку recurly-signature з окремим секретом для кожного ендпоінта, а також підтримує облікові дані HTTP Basic. XML-повідомлення підпису не мають. Невдалу доставку Recurly повторює до десяти разів зі зростанням пауз. З боку Krokul externalRef/api-upsert привʼязує account code до контрагента, підписані вебхуки ведуть журнал доставок, а пісочниця тримає тестові підписки.

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

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

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

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

### Krokul теж виставляє підписки. Яка система рахує клієнта?

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

### Навіщо Krokul звертається до Recurly після кожного вебхука?

JSON-сповіщення Recurly містять лише тип обʼєкта, тип події й ідентифікатори. Krokul читає поточну підписку, рахунок чи платіж з API Recurly, перш ніж щось змінити.

### Чи входять підписки Recurly у звіт MRR у Krokul?

Так. Підписки Recurly зʼявляються у звіті рухів MRR із сумами, які тримає Recurly, поруч із договорами, що їх Krokul виставляє сам.

## Обмеження

Плани, платіжні шлюзи, дані карток і dunning лишаються в Recurly. Вебхуки charge invoice приходять лише з сайтів Recurly, де ввімкнено функцію Credit Invoices.

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

- [Chargebee](https://krokul.com/uk/integrations/chargebee/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)
- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)

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

Recurly є торговою маркою Recurly, Inc. Krokul не афілійований з Recurly.

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

---

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