UK
Подивитися демо

NovaPay + Krokul CRM

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

  • НативнаКонектор, вбудований у Krokul. Ви підключаєте його в «Маркетплейсі» ключем або входом у сервіс, код не потрібен.

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

Сесія 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, metadataKrokul → NovaPayКонтакт угоди й угодаМенеджер створює посилання на оплату
Платіж у сесії (Add payment): сума в гривнях, описKrokul → NovaPayПланова оплата угодиОдразу після створення сесії
Посилання на сторінку оплатиNovaPay → KrokulПосилання в блоці «Оплати»У відповідь на додавання платежу
Постбек: status, metadata, payments[].amountNovaPay → KrokulОплата-факт, стрічка угоди, подія payment.receivedКлієнт оплатив
Статус holded, Complete hold, Void sessionNovaPay ↔ KrokulПланова оплата, кнопки «Списати» і «Скасувати холд»Кошти заблоковано; рішення менеджера
Expire sessionKrokul → NovaPayПопереднє посилання плануМенеджер створює нове посилання
Get statusNovaPay → KrokulЗвірка відкритих посиланьДля сесій без постбека

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

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

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

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

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

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

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

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

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

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

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

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

Обмеження

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

Чогось бракує?

Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.

Запит отримано. Відповімо на вашу пошту.

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

Подивитися демо