# PayPal + Krokul CRM

Так. Krokul CRM інтегрується з PayPal. Рахунок, виставлений в угоді, іде клієнту рахунком PayPal, завершене списання PayPal проводиться оплатою-фактом і закриває план оплат, а повернення приходять назад в угоду. PayPal підключається через застосунок Krokul у Zapier, Make, n8n чи Albato або через вебхуки PayPal і API Krokul.

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

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

### Рахунок Krokul іде клієнту як PayPal Invoice

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

### Посилання на оплату одного рядка плану

Для авансу чи одного платежу з розстрочки менеджер надсилає посилання на оплату PayPal із плану оплат угоди. Посилання несе суму лише цього рядка, а клієнт платить на сторінці PayPal із балансу PayPal або карткою.

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

Коли гроші списано, PayPal надсилає `PAYMENT.CAPTURE.COMPLETED`. Krokul перевіряє подію, знаходить угоду за ID рахунку чи замовлення й проводить оплату-факт зі способом оплати PayPal. Рядок плану закривається, борг компанії-клієнта зменшується, а подія `payment.received` іде в кожну систему, що її слухає.

### Повернення в PayPal оновлює угоду

Повернення, оформлене в PayPal, приходить подією `PAYMENT.CAPTURE.REFUNDED`. Krokul проводить повернення, прив’язане до оплати, яку він записав за цим списанням. Угода показує чисту суму й ту частину, яку ще можна повернути.

### Відхилена оплата потрапляє до людини

Коли PayPal повідомляє про відхилену чи невдалу оплату, Krokul ставить задачу менеджеру клієнта в угоді, поруч із рахунком. Наступна розмова з клієнтом починається з фактів.

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

| PayPal | Krokul | Напрям | Коли |
|---|---|---|---|
| Рахунок (створений і надісланий) | Рахунок (документ) в угоді | Krokul → PayPal | Менеджер виставляє рахунок зі способом оплати PayPal |
| Посилання на оплату замовлення | Рядок плану оплат | Krokul → PayPal | Менеджер надсилає посилання на один рядок |
| Завершене списання | Оплата-факт, що закриває рядок плану | PayPal → Krokul | Подія PayPal `PAYMENT.CAPTURE.COMPLETED` |
| Статус рахунку (оплачено, оплачено частково) | Статус рахунку в угоді | PayPal → Krokul | Подія PayPal `INVOICING.INVOICE.PAID` з перевіркою статусу |
| Повернення за списанням | Повернення, прив’язане до оплати | PayPal → Krokul | Подія PayPal `PAYMENT.CAPTURE.REFUNDED` |
| Відхилена оплата | Задача в угоді | PayPal → Krokul | PayPal повідомляє про невдале чи відхилене списання |

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

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

1. Підключіть застосунок Krokul ключем API Krokul.
2. Візьміть тригер Krokul Document Created і дії PayPal Create Invoice та Send Invoice.
3. Зворотний напрям почніть із Payment Capture Webhooks чи Payment Refund Webhooks і візьміть дію Krokul Record Payment або Create Task.
4. Failed Payment Webhooks може ставити задачу менеджеру клієнта в угоді.

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

1. Створіть REST-застосунок у кабінеті розробника PayPal, і ключ API Krokul зі scope на документи й оплати.
2. Підпишіть вебхук Krokul на document.created, звірте його заголовок x-crm-signature, потім створіть і надішліть PayPal Invoice. Invoice ID закріпіть за документом через externalRef/api-upsert.
3. Підпишіть свій приймач у PayPal на PAYMENT.CAPTURE.COMPLETED, перевірте подію й проведіть гроші через payment/api-create, передавши cardUuid угоди й спосіб оплати PayPal.
4. PAYMENT.CAPTURE.REFUNDED проводьте через payment/api-refund до тієї оплати, яку воно повертає.

**Тригери:** New Invoice; Payment Sale Webhooks; Payment Capture Webhooks; Payment Refund Webhooks; Failed Payment Webhooks.

**Дії:** Create Invoice; Send Invoice; Create Payment; Search Invoice; Search Captured Payment.

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

PayPal надсилає `INVOICING.INVOICE.PAID`, коли рахунок оплачено повністю, частково або коли оплата ще очікується. Тому власний міст перевіряє статус рахунку, перш ніж проводити гроші, або слухає `PAYMENT.CAPTURE.COMPLETED`. В API Krokul `payment/api-create` приймає мітку `method`, а `payment/api-refund` прив’язує повернення до його оплати. Підписані вебхуки Krokul із журналом доставок і тестова компанія дають перевірити міст на пісочниці PayPal.

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

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

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

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

### Яка подія PayPal проводить оплату в Krokul?

Завершене списання (Capture). Подія PayPal про оплачений рахунок приходить і на часткову, і на очікувану оплату, тому Krokul читає статус рахунку, перш ніж щось за нею проводити.

### Чи гроші з PayPal відокремлені від банківських переказів?

Так. Кожна оплата з PayPal має спосіб оплати PayPal, і реєстр оплат може відфільтрувати її окремо.

### Чи можна перевірити зв’язку без справжніх грошей?

Так. У PayPal є пісочниця з окремими ключами застосунку, а тестова компанія в Krokul дає пройти весь потік до переходу на робочі ключі.

## Обмеження

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

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

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

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

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

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

---

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