QUINCEFINСпробувати
Відкрити меню

Інтеграція з NovaPay

Інтеграція з NovaPay дозволяє створювати платіжні посилання безпосередньо з документів QUINCEFIN і автоматично фіксувати оплату після підтвердження платежу платіжною системою.

Виберіть свій сценарій

Для CSV-післяплат можна увімкнути Лише CSV-реєстри (без приймання оплат через API) без ключів мерчанта. На вкладці Клієнт-банк потрібно вибрати окремий рахунок платіжної системи та статті комісії.

У підтриманому реєстрі переказів є дата виплати, але немає дати оплати клієнтом. Перед проведенням потрібно окремо підтвердити використання дати виплати для операційного обліку. Це не визначає дату податкового доходу.

Після відповідного оновлення QFin, якщо платіж не знайдено в історії інтеграції, ЕН / ТТН із 14 цифр використовується для пошуку документа через збережену накладну Нової пошти у QFin. Накладна вже має бути прив’язана до документа покупця. Потрібен єдиний сумісний документ тієї самої організації та валюти; повна сума оплати до комісії має дорівнювати повній сумі документа. Неоднозначні збіги та вже враховані оплати потребують перевірки, а не повторного проведення.

Якщо ТТН або її зв’язку з документом у QFin немає, виберіть документ чи покупця з договором вручну після перевірки першоджерела. Знайдено в інтеграції: 0 не означає помилку читання файлу: перевірте також прив’язані оплати та статус Знайдено документ за ТТН. Деталі, обмеження і доступність оновлення — в інструкції імпорту CSV.

API-завантаження реєстрів післяплат не реалізоване. Нижче описано приймання онлайн-оплат. Не проводьте з CSV повторно надходження, яке вже оформлене через callback або вручну.

Що робить інтеграція

  • створює платіжне посилання з документа продажу;
  • зберігає платіж у QUINCEFIN і показує його статус;
  • приймає callback від NovaPay після оплати;
  • автоматично створює документ Надходження на банківський рахунок після успішної оплати.

Для яких сценаріїв підходить

NovaPay доцільно використовувати, коли менеджер або продавець:

  • оформлює Замовлення, Рахунок або Продаж у QUINCEFIN;
  • хоче одразу відправити клієнту готове платіжне посилання;
  • хоче, щоб після оплати гроші автоматично відобразилися у фінансовому обліку без ручного введення.

Передумови

Перед налаштуванням у QUINCEFIN потрібно отримати в кабінеті NovaPay параметри мерчанта:

  • Merchant ID;
  • приватний ключ для підпису запитів;
  • публічний ключ NovaPay для перевірки callback.

Також у клієнта в документі має бути заповнений телефон, тому що NovaPay використовує номер телефону покупця під час створення платіжної сесії.

QUINCEFIN бере телефон покупця з контактної інформації партнера. Для створення платіжної сесії номер має бути у форматі +380XXXXXXXXX.

Налаштування профілю NovaPay

  1. Відкрийте Налаштування → Інтеграції → Платіжні системи → NovaPay.
  2. Створіть новий профіль.
  3. Заповніть назву профілю, Merchant ID, приватний ключ і публічний ключ.
  4. За потреби увімкніть тестове середовище, якщо підключення виконується до sandbox NovaPay.
  5. Перевірте Callback URL для основного або тестового середовища.
  6. Збережіть профіль.

Поле Callback URL відображається у профілі для контролю. Саме на цю адресу NovaPay надсилатиме результат оплати:

https://app.quincefin.com/api/integrations/novapay/payment_result

Якщо у профілі ввімкнено тестове середовище, QUINCEFIN використовує тестову API-адресу NovaPay і окремий callback URL для sandbox-сценарію.

Прив’язка до банківського рахунку

Після створення профілю NovaPay його потрібно прив’язати до банківського рахунку:

  1. Відкрийте потрібний банківський рахунок у QUINCEFIN.
  2. У полі платіжного профілю виберіть NovaPay.
  3. Вкажіть створений профіль інтеграції.
  4. Збережіть рахунок.

Після цього рахунок можна використовувати для створення посилань на оплату.

Створення платіжного посилання

  1. Створіть або відкрийте документ продажу, наприклад Замовлення, Рахунок або Продаж.
  2. Вкажіть банківський рахунок, до якого прив’язано профіль NovaPay.
  3. У меню додаткових дій документа виберіть NovaPay.
  4. QUINCEFIN створить платіж у NovaPay і відкриє стандартне вікно платіжного посилання.
  5. Скопіюйте посилання та надішліть його клієнту.

У вікні деталей платежу можна побачити:

  • платіжний сервіс;
  • ідентифікатор платежу;
  • суму;
  • статус;
  • ознаку оплати;
  • кнопку копіювання посилання.

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

Що відбувається після оплати

Після успішної оплати NovaPay надсилає callback у QUINCEFIN. Система перевіряє підпис повідомлення, знаходить пов’язаний документ і створює документ Надходження на банківський рахунок.

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

Детальніше про фінансовий документ, який створюється автоматично після оплати, дивіться у статті Документ “Надходження на рахунок”.

Що перевірити перед відправкою посилання клієнту

  • у профілі NovaPay вказані правильні ключі для потрібного середовища;
  • банківський рахунок прив’язаний саме до цього профілю;
  • у документі продажу вказано правильного партнера;
  • у партнера є основний телефон у контактній інформації;
  • сума документа коректна і більша за нуль.

Якщо посилання не створюється

Перевірте такі речі:

  • у банківському рахунку вибрано платіжний профіль NovaPay;
  • у профілі NovaPay заповнено Merchant ID, приватний ключ і публічний ключ;
  • у документі є партнер з телефоном у форматі +380XXXXXXXXX;
  • користувач має доступ до інтеграції NovaPay;
  • сума документа більша за нуль.

Найтиповіші причини помилок:

  • телефон партнера відсутній або записаний не в тій формі;
  • для тестового профілю використано production-ключі або навпаки;
  • рахунок у документі не прив’язаний до профілю NovaPay;
  • callback URL не збігається з налаштуваннями мерчанта.

Пов’язана документація