# NovaPay + Krokul CRM

Так. Krokul CRM має нативний конектор до інтернет-еквайрингу NovaPay. З угоди Krokul відкриває сесію оплати на клієнта, додає платіж на суму плану й дає посилання на платіжну сторінку, а підписаний постбек NovaPay переводить планову оплату у факт.

**Статус:** Нативна.

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

### Сесія NovaPay на клієнта угоди

Менеджер натискає «Посилання на оплату» в блоці «Оплати». Krokul створює в NovaPay сесію з ім’ям і телефоном контакту угоди, адресою постбека й посиланням на угоду в metadata, а потім додає до сесії платіж на суму планової оплати. Клієнт отримує посилання на сторінку оплати NovaPay.

### Постбек NovaPay закриває план

Коли клієнт оплатив, NovaPay надсилає постбек на адресу Krokul. Krokul перевіряє підпис публічним ключем NovaPay, бере суму з payments[].amount і угоду з metadata, звіряє їх із планом і проводить оплату фактом. Подія `payment.received` іде в облік, а повне покриття рахунку дає `invoice.paid`.

### Холд, який списують після відвантаження

Сесія зі статусом holded означає, що гроші заблоковано на картці клієнта. Krokul лишає оплату плановою, а коли товар відвантажено, менеджер натискає «Списати», і Krokul викликає Complete hold. Скасувати холд можна тим самим місцем через Void session.

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

Якщо сума угоди змінилась, менеджер створює нове посилання. Krokul закриває попередню сесію методом Expire session, щоб клієнт не заплатив за старою сумою.

### Звірка, якщо постбек загубився

Для сесій, які довго лишаються без постбека, Krokul запитує Get status і проводить оплату за фактичним станом сесії. Менеджер не шукає платіж у кабінеті NovaPay вручну.

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

| NovaPay | Krokul | Напрям | Коли |
|---|---|---|---|
| Сесія (Create session): merchant_id, client_phone, ім’я, callback_url, metadata | Контакт угоди й угода | Krokul → NovaPay | Менеджер створює посилання на оплату |
| Платіж у сесії (Add payment): сума в гривнях, опис | Планова оплата угоди | Krokul → NovaPay | Одразу після створення сесії |
| Посилання на сторінку оплати | Посилання в блоці «Оплати» | NovaPay → Krokul | У відповідь на додавання платежу |
| Постбек: status, metadata, payments[].amount | Оплата-факт, стрічка угоди, подія `payment.received` | NovaPay → Krokul | Клієнт оплатив |
| Статус holded, Complete hold, Void session | Планова оплата, кнопки «Списати» і «Скасувати холд» | NovaPay ↔ Krokul | Кошти заблоковано; рішення менеджера |
| Expire session | Попереднє посилання плану | Krokul → NovaPay | Менеджер створює нове посилання |
| Get status | Звірка відкритих посилань | NovaPay → Krokul | Для сесій без постбека |

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

### Підключення (нативно, без коду)

1. У кабінеті торговця NovaPay відкрийте «Налаштування» → «Мої компанії» → «Мерчанти та ключі». Візьміть Merchant ID і згенеруйте ключі.
2. У Krokul відкрийте «Маркетплейс» → «NovaPay» і заповніть ідентифікатор мерчанта, ваш приватний ключ для підпису запитів, публічний ключ NovaPay для постбеків і публічну адресу Krokul.
3. Для першої перевірки впишіть у поле «Базова адреса API» тестовий контур https://api-qecom.novapay.ua/v1. Порожнє поле означає бойовий контур.
4. Створіть посилання з угоди й пройдіть тестову оплату. Відмови NovaPay Krokul показує текстом у журналі інтеграції.

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

Посилання NovaPay створює публічний роут `payment/api-link`, той самий, що й для інших провайдерів. Коли гривню приймають кілька підключених провайдерів, у виклик додають `provider: "novapay"`. Номер сесії NovaPay зберігається зовнішнім ключем `externalRef`, а подію `payment.received` ваша система отримує підписаним вебхуком із журналом доставок.

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

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

### Чи пов’язана інтеграція NovaPay з накладеним платежем Нової пошти?

Ні. Інтеграція NovaPay у Krokul працює з інтернет-еквайрингом, тобто із сесією, посиланням і постбеком. Накладений платіж задається у формі ТТН інтеграції з Новою поштою.

### Що робить Krokul, якщо постбек NovaPay прийшов без правильного підпису?

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

### Чи можна виставити посилання NovaPay у доларах чи євро?

Ні. Для NovaPay Krokul приймає лише гривню. Для іншої валюти підключіть провайдера, який її приймає, і Krokul вибере його за валютою оплати.

### Як перевірити інтеграцію NovaPay без реальних грошей?

Вкажіть у налаштуваннях тестовий контур NovaPay і пройдіть оплату з угоди. Усі запити й відповіді видно в журналі інтеграції.

## Обмеження

NovaPay у Krokul приймає оплати в гривнях. Ця інтеграція про інтернет-еквайринг. Накладений платіж задається у формі ТТН інтеграції з Новою поштою.

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

- [monobank](https://krokul.com/uk/integrations/monobank/index.md)
- [LiqPay](https://krokul.com/uk/integrations/liqpay/index.md)
- [WayForPay](https://krokul.com/uk/integrations/wayforpay/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)
- [ПриватБанк](https://krokul.com/uk/integrations/privatbank/index.md)

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

NovaPay є торговою маркою її власника. Krokul не афілійований із NovaPay.

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

---

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