# Stripe Billing + Krokul CRM

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

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

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

### Виграна угода запускає підписку

Коли угоду у воронці підписок виграно, Krokul знаходить або створює Stripe Customer для контрагента й створює Subscription з ідентифікаторами цін Stripe з рядків угоди та їхньою кількістю. UUID угоди йде в metadata підписки. Далі цикл білінгу веде Stripe.

### Кожне оплачене продовження стає оплатою в Krokul

Stripe надсилає invoice.paid, коли рахунок за продовження сплачено. Krokul читає підписку з події, записує факт оплати на початкову угоду з номером і сумою рахунку та зберігає ідентифікатор рахунку Stripe як зовнішній ключ. Картка контрагента показує оплачені періоди одним списком.

### Невдале списання доходить до людини

Подія invoice.payment_failed додає в угоду коментар із сумою. Коли статус підписки переходить у past_due, Krokul створює задачу власнику контрагента зателефонувати клієнту. Тим часом Smart Retries повторюють списання з картки в Stripe.

### Кінець пробного періоду й зміни плану

Stripe надсилає customer.subscription.trial_will_end за три дні до кінця пробного періоду, і Krokul відкриває задачу підтвердити спосіб оплати. Події customer.subscription.updated і customer.subscription.deleted оновлюють копію підписки на контрагенті лише для читання. Звіт рухів MRR у Krokul враховує підвищення, зниження чи відтік.

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

| Stripe Billing | Krokul | Напрям | Коли |
|---|---|---|---|
| Customer | Контрагент, зовнішній ключ | Krokul → Stripe | Перша підписка клієнта |
| Subscription з ідентифікаторами цін і metadata | Виграна угода з рядками | Krokul → Stripe | Угоду виграно |
| invoice.paid | Факт оплати на угоді | Stripe → Krokul | Рахунок за продовження сплачено |
| invoice.payment_failed | Коментар в угоді | Stripe → Krokul | Списання не пройшло |
| Статус підписки past_due | Задача менеджеру клієнта | Stripe → Krokul | Продовження лишається несплаченим |
| customer.subscription.trial_will_end | Задача підтвердити спосіб оплати | Stripe → Krokul | За три дні до кінця пробного періоду |
| customer.subscription.updated, .deleted | Копія підписки й рух MRR | Stripe → Krokul | План змінено чи завершено |

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

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

1. Підключіть застосунок Krokul ключем API Krokul, а Stripe обмеженим ключем із правом запису клієнтів і підписок.
2. Від тригера Krokul Deal Won викличте Create Subscription у Zapier або Create subscription в Albato, потім збережіть ідентифікатори Stripe дією Krokul Set External Key.
3. Від Updated Subscription чи Canceled Subscription у Zapier, Watch Events у Make або Stripe Trigger у n8n викличте пошук Krokul Find Client Company і дію Create Task чи Record Payment.

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

1. Видайте ключ API Krokul з правами на угоди, контрагентів, оплати й задачі та створіть у Stripe вебхук-ендпоінт для подій customer.subscription і invoice.
2. Підпишіть вебхук Krokul на card.won з фільтром pipelineUuid, перевіряйте x-crm-signature і створюйте підписку Stripe з UUID угоди в metadata.
3. Перевіряйте заголовок Stripe-Signature на кожній події, зберігайте ідентифікатори Stripe через externalRef/api-upsert, потім викликайте payment/api-create з cardUuid з metadata або task/api-create.

**Тригери:** New Subscription; Updated Subscription; Canceled Subscription; New Invoice; Invoice Payment Failed; Watch Events; Subscription created; Update Subscription.

**Дії:** Create Subscription; Cancel Subscription; Create Price; Find Subscription; Create an Invoice; Finalize a Draft Invoice; Create subscription; Find subscription by ID.

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

Stripe підписує кожен вебхук у заголовку Stripe-Signature міткою часу й HMAC-SHA256 від мітки, зʼєднаної з сирим тілом, на ключі секрету ендпоінта. Ендпоінт, що не відповів, Stripe у бойовому режимі пробує знову до трьох днів зі зростаючою паузою. Порядок подій не гарантовано. З боку Krokul metadata підписки несе UUID угоди, зовнішні ключі тримають ідентифікатори Stripe, а журнал доставок Krokul повторює крок, що впав.

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

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

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

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

### Чим ця сторінка відрізняється від сторінки Stripe?

Сторінка Stripe описує разові посилання на оплату й Checkout з угоди. Ця сторінка описує регулярні підписки й рахунки, які Stripe Billing виставляє щоперіоду.

### Хто надсилає клієнту рахунки за продовження?

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

## Обмеження

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

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

- [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)
- [Paddle](https://krokul.com/uk/integrations/paddle/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)

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

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

---

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