# Paddle + Krokul CRM

Так. Krokul CRM інтегрується з Paddle Billing. Виграна угода створює клієнта Paddle і транзакцію з погодженими цінами, а Paddle потім повідомляє в угоду й контрагента в Krokul про завершені оплати, невдалі списання, зміни підписки й повернення. Paddle працює як merchant of record і сам виставляє рахунок покупцю, тож Krokul веде продаж та історію оплат без другого рахунку. Звʼязка працює через застосунок Krokul у Make і n8n або через API і вебхуки Krokul.

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

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

### Виграна угода стає транзакцією Paddle

Коли угоду виграно у воронці, яку ви привʼязали до Paddle, Krokul створює клієнта Paddle з контрагента і транзакцію з ідентифікаторами цін і кількостями з рядків угоди. UUID угоди передається в custom_data. Для договору, який веде менеджер, транзакція має ручне стягнення, і Paddle надсилає власний рахунок, щойно транзакцію виставлено. Покупці самообслуговування натомість отримують посилання на оплату.

### transaction.completed записує оплату

Paddle надсилає transaction.completed після того, як обробив платіж. Krokul читає UUID угоди з custom_data, записує оплату-факт у цю угоду й зберігає ідентифікатор транзакції Paddle як зовнішній ключ. Борг контрагента зменшується, а коли план оплат покрито, приходить invoice.paid.

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

Подія transaction.payment_failed додає в угоду коментар із сумою й ідентифікатором транзакції Paddle. Коли підписка переходить у прострочення, subscription.past_due створює задачу власнику контрагента. Paddle далі повторює списання з картки на своєму боці.

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

Події subscription.created, subscription.updated, subscription.paused і subscription.canceled оновлюють копію підписки Paddle для читання на контрагенті. Звіт рухів MRR у Krokul враховує зміну із сумою, яку тримає Paddle. Один власник білінгу на клієнта не дає договору Krokul і підписці Paddle двічі стягнути гроші з однієї компанії.

### Повернення й кредити йдуть за оплатою

Повернення й кредити Paddle записує як adjustments. На adjustment.created Krokul знаходить оплату за ідентифікатором транзакції й проводить привʼязане до неї повернення. Після цього угода показує чисту суму.

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

| Paddle | Krokul | Напрям | Коли |
|---|---|---|---|
| Customer (ctm_) | Контрагент, зовнішній ключ | Krokul → Paddle | Перша транзакція клієнта |
| Transaction з ідентифікаторами цін і custom_data | Виграна угода з рядками | Krokul → Paddle | Угоду виграно |
| transaction.completed | Оплата-факт в угоді | Paddle → Krokul | Paddle обробив платіж |
| transaction.payment_failed | Коментар в угоді | Paddle → Krokul | Списання відхилено |
| subscription.created, .updated, .canceled | Підписка для читання й рух MRR | Paddle → Krokul | Підписка змінюється |
| subscription.past_due | Задача менеджеру клієнта | Paddle → Krokul | Продовження лишилось неоплаченим |
| adjustment.created | Повернення, привʼязане до оплати | Paddle → Krokul | Повернення чи кредит схвалено |

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

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

1. Підключіть застосунок Krokul ключем API Krokul, а застосунок Paddle ключем API Paddle.
2. Почніть із тригера Krokul Deal Won, викличте Get a Customer чи Create a Customer, потім Create a Transaction з ідентифікаторами цін з угоди.
3. Збережіть ідентифікатори клієнта й транзакції Paddle в угоді дією Krokul Set External Key.

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

1. Створіть ключ API Paddle і notification destination для подій транзакцій, підписок і adjustments. У Krokul видайте ключ API з правами на угоди, контрагентів і оплати.
2. Підпишіть вебхук Krokul на card.won з фільтром pipelineUuid, перевіряйте x-crm-signature і створюйте транзакцію Paddle з UUID угоди в custom_data.
3. Зберігайте ідентифікатори Paddle через externalRef/api-upsert, щоб повторна доставка нічого в Paddle не змінювала.
4. На кожну подію Paddle перевіряйте заголовок Paddle-Signature, відповідайте 200 протягом пʼяти секунд, потім пишіть payment/api-create з cardUuid із custom_data, payment/api-refund або task/api-create.

**Дії:** Create a Customer; Create a Transaction; Get a Customer; Create a Price; Create a Product; Get a Price.

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

Paddle підписує кожен вебхук заголовком Paddle-Signature, де лежать мітка часу й хеш HMAC-SHA256 від мітки, зʼєднаної із сирим тілом, на секреті notification destination. Підпис перевіряють до обробки. Адресат, що не відповів 200 за пʼять секунд, отримує повтори. Їх до 60 за три дні на робочих акаунтах і три за 15 хвилин у пісочниці. З боку Krokul custom_data несе UUID угоди, externalRef тримає ідентифікатори Paddle, а журнал доставок повторює крок, що впав.

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

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

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

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

### Хто надсилає рахунок, коли Paddle є merchant of record?

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

### Як платіж Paddle знаходить свою угоду в Krokul?

Krokul записує UUID угоди в custom_data транзакції Paddle. Подія transaction.completed повертає це значення, тож Krokul записує оплату в потрібну угоду.

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

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

## Обмеження

Ціни, оформлення оплати, розрахунок податків, рахунки покупцям і виплати лишаються в Paddle. Транзакції Paddle з ручним стягненням приймають лише USD, EUR і GBP.

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

- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)
- [Chargebee](https://krokul.com/uk/integrations/chargebee/index.md)
- [Recurly](https://krokul.com/uk/integrations/recurly/index.md)
- [Adyen](https://krokul.com/uk/integrations/adyen/index.md)
- [PayPal](https://krokul.com/uk/integrations/paypal/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)

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

Paddle є торговою маркою Paddle.com Market Limited. Krokul не афілійований з Paddle.

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

---

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