# Stripe + Krokul CRM

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

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

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

### Картка угоди видає посилання на оплату Stripe

Менеджер відкриває план оплат угоди й вибирає провайдером Stripe. Krokul створює Stripe Checkout Session для цього рядка із сумою, валютою й посиланням на угоду в metadata і показує посилання з терміном дії. Посилання йде клієнту наступним листом чи повідомленням.

### Завершена Checkout Session закриває план оплат

Коли клієнт платить, Stripe надсилає з’єднанню Krokul `checkout.session.completed`. Krokul перевіряє підпис Stripe, знаходить рядок плану за metadata й проводить на ньому оплату-факт. Борг компанії-клієнта зменшується, іде подія `payment.received`, а коли рахунок покрито, слідом іде `invoice.paid`.

### Повернення в Stripe доходить до угоди

Повернення, оформлене в Stripe Dashboard, приходить як повернення за Charge. Krokul знаходить раніше записану оплату за ID у Stripe і проводить прив’язане до неї повернення. Угода показує чисту суму, а рахунок знову відкривається, якщо після повернення його вже не покрито.

### Невдала оплата Invoice стає задачею

Для клієнтів, яким виставляють рахунки через Stripe Invoices, `invoice.payment_failed` створює задачу менеджеру клієнта в угоді. У задачі названо Invoice і суму, тож клієнт дізнається про проблему від людини ще до наступного нагадування.

### Компанія-клієнт стає Stripe Customer

Перше посилання на оплату для компанії-клієнта створює Stripe Customer з назвою компанії й email для рахунків, а Krokul зберігає Customer ID зовнішнім ключем. Наступні посилання використовують той самий Customer, тож Stripe веде одну історію оплат на клієнта.

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

| Stripe | Krokul | Напрям | Коли |
|---|---|---|---|
| Checkout Session (посилання на оплату) | Рядок плану оплат в угоді | Krokul → Stripe | Менеджер надсилає посилання на оплату з угоди |
| Customer | Компанія-клієнт | Krokul → Stripe | Перше посилання для компанії-клієнта |
| Завершена Checkout Session | Оплата-факт, що закриває рядок плану | Stripe → Krokul | Подія Stripe `checkout.session.completed` |
| Оплачений Invoice | Оплата-факт на рахунку | Stripe → Krokul | Подія Stripe `invoice.paid` |
| Повернення за Charge | Повернення, прив’язане до записаної оплати | Stripe → Krokul | Повернення оформлено в Stripe |
| Невдала оплата Invoice | Задача в угоді | Stripe → Krokul | Подія Stripe `invoice.payment_failed` |

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

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

1. Додайте застосунок Krokul і підключіть його ключем API Krokul.
2. Почніть із тригера Krokul, наприклад Deal Won чи Document Created, і додайте дію Stripe, наприклад Create Payment Link чи Create Invoice.
3. Для зворотного шляху почніть із тригера Stripe, наприклад Checkout Session Completed чи New Refund, і візьміть дію Krokul Record Payment, Create Task чи Save External Key.

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

1. Випустіть у Krokul ключ API зі scope на угоди, компанії-клієнтів і оплати.
2. Спрямуйте вебхук Krokul на свій міст для card.won і перевіряйте заголовок x-crm-signature кожної доставки спільним секретом.
3. На цю подію створіть Checkout Session через Stripe API з UUID угоди в metadata, а Stripe Customer ID закріпіть за компанією-клієнтом через externalRef/api-upsert.
4. Коли Stripe повідомляє про checkout.session.completed, викличте payment/api-create з cardUuid із metadata, щоб оплата-факт потрапила в потрібну угоду.

**Тригери:** Checkout Session Completed; New Payment; New Invoice; Invoice Payment Failed; New Refund; New Event; New Customer.

**Дії:** Create Customer; Update Customer; Create Invoice; Create Payment Link; Create Checkout Session; Find Customer; Find Invoice.

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

Stripe підписує кожну подію вебхука в заголовку `Stripe-Signature`, а Krokul підписує свої доставки HMAC-SHA256 від мітки часу й тіла, тож власний міст може перевірити обидва кінці. Публічний API Krokul приймає оплати з полем `kind` зі значенням `fact`, а повернення через `payment/api-refund`. Зовнішні ключі виду `stripe.acct_…` розводять два акаунти Stripe. Тестова компанія з ключем API дає перевірити міст у тестовому режимі Stripe.

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

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

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

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

### Чи може менеджер надіслати посилання на оплату Stripe з картки угоди?

Так. Krokul створює Stripe Checkout Session для вибраного рядка плану оплат і показує посилання в угоді. Оплачена сесія сама закриває цей рядок.

### Чому сума в Stripe виглядає в 100 разів більшою за суму угоди?

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

### Що відбувається в Krokul після повернення в Stripe?

Krokul проводить повернення, прив’язане до початкової оплати. Якщо рахунок більше не покрито, він знову стає неоплаченим, і `invoice.paid` може спрацювати після наступної повної оплати.

## Обмеження

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

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

- [PayPal](https://krokul.com/uk/integrations/paypal/index.md)
- [GoCardless](https://krokul.com/uk/integrations/gocardless/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)
- [Wise Business](https://krokul.com/uk/integrations/wise-business/index.md)

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

Stripe є торговельною маркою Stripe, Inc. Krokul не пов’язаний зі Stripe.

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

---

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