FAQ Інтеграція NovaPay | Поширені запитання при підключенні інтернет-еквайрингу

FAQ Інтеграція NovaPay | Поширені запитання при підключенні інтернет-еквайрингу

Зміст

Корисні посилання

 

Тестування оплати

Як перейти до продуктивного середовища

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

Адреса для звернення у продуктивне середовище – https://api-ecom.novapay.ua/v1

  1. Генерація продавцем пари RSA ключів, передача публічного ключа тех. спеціалістам NovaPay.

  2. Створення мерчанта для продавця у системі NovaPay.

  3. Передача продавцю його унікального ідентифікатора - merchant_id, який використовується при створенні запитів у продуктивному середовищі.

  4. Проведення перших транзакцій у продуктивному середовищі, перевірка коректності перерахування коштів та відображення реєстру.

  5. Інформування зацікавлених підрозділів про готовність послуги до запуску на сайт.

Які дані використовувати для тестування оплати у тестовому середовищі?

Тестування можна проводити з використанням тестових карток:

PAN

EXP

CVV

Статус

PAN

EXP

CVV

Статус

5269610000007956

05/24

755

Активна

4134170000013005

11/24

704

Активна

4134170000013088

11/24

045

Втрачена

При тестуванні система вимагає підтвердження за допомогою одноразового паролю. Як його можна отримати?

Тестові операції з сумою до 500 грн не вимагають підтвердження. Якщо для проведення тестування важливо провести оплату на суму, що перевищує 500 грн, необхідно звернутися до тех. спеціалістів NovaPay для отримання коду підтвердження.

Помилки

Чому може виникати відповідь 302?

Дана відповідь може виникати при звернення до тестового середовища за адресою http://apiqecom.novapay.ua/v1, тому що запит потребує переправлення за новою адресою https://apiecom.novapay.ua/v1.

Чому може виникати помилка 403?

Причинами отримання помилки 403 можуть бути:

  • Відбувається звернення від мерчанта, який не зареєстрований на сервері, на який відбувається звернення. Приклад: відбувається звернення на тестове середовище із merchant_id, який зареєстрований у продуктивному середовищі.

  • Відбувається надсилання запиту із невірним підписом x-sign. Приклад: відбувається звернення у тестове середовище із підписом, який був створений з використанням приватного ключа продавця для продуктивного середовища.

 

Callbacks

Яким чином продавець отримує інформацію про оновлення статусу платежу?

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

Чому не відбувається звернення на callback_url?

Для того, щоб перевірити, чи коректно були виконані налаштування сервера callback_url необхідно використати сервіс, призначений для відстеження запитів, приклад:

https://requestcatcher.com/

У випадку, якщо на вказаний сервіс коректно відбуваються звернення, причина виникнення проблеми - у налаштуваннях сервера для callback_url. У випадку, якщо сервіс не фіксує звернень, необхідно звернутись до тех. спеціаліста NovaPay для з’ясування причин виникнення проблеми.

У випадку, якщо сервіс не фіксує звернень, необхідно звернутись до тех. спеціаліста NovaPay для з’ясування причин виникнення проблеми.

Чому на callback_url відбувається звернення без інформації у запитах («пусті» звернення)?

Причиною виникнення проблеми може бути те, що сервер Callback_url передає інформацію про необхідність переправлення запиту (відповідь 301, 302). У такому випадку NovaPay дублює запит, у якому не передаються дані оригінального запиту.

Інше

Чи потрібно закодувати запит у base64?

Ні, закодувати необхідно лише підпис x-sign.

При тестуванні послуги «Надійна покупка» отримую відповідь «Помилка при розрахунку вартості доставки». З чим це може бути пов’язано?

Якщо при роботі у тестовому середовищі контрагент надсилає параметри delivery.recipient_city і delivery.recipient_warehouse, отримані через звернення по API «Нова Пошта», помилка може бути пов’язана із тим, що контрагент надсилає дані про відділення відправки, яке не записано у тестовій базі логістичної системи. Для тестування можна використовувати параметри наступних відділень:

  1. М. Одесса, відділення №1:

["recipient_city"]=> string(36) "db5c88d0-391c-11dd-90d9-001a92567626" " ["recipient_warehouse"]=> string(36) "1692286e-e1c2-11e3-8c4a-0050568002cf "

  1. М. Полтава, відділення №3:

["recipient_city"]=> string(36) "1ec09d90-e1c2-11e3-8c4a-0050568002cf"" ["recipient_warehouse"]=> string(36) "1ec09d90-e1c2-11e3-8c4a-0050568002cf "

  1. М. Луцьк, відділення №4:

["recipient_city"]=> string(36) "db5c893b-391c-11dd-90d9-001a92567626"" ["recipient_warehouse"]=> string(36) "1ec09d35-e1c2-11e3-8c4a-0050568002cf "

  1. М. Київ, відділення №4:

["recipient_city"]=> string(36) "7b422fc5-e1b8-11e3-8c4a-0050568002cf "" ["recipient_warehouse"]=> string(36) "8d5a980d-391c-11dd-90d9-001a92567626"

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

Так, на одному сайті може відбуватись прийом коштів на користь кількох контрагентів. Для використання такої схеми повинні виконуватись наступні умови:

  • Із кожним із контрагентів, на користь яких буде відбуватись переказ коштів, повинна бути підписана договірна частина.

  • Для кожного із контрагентів повинні бути згенеровані RSA ключі та створений мерчант із унікальним ідентифікатором в системі NovaPay.

  • Контроль за тим, на користь якого контрагента відбувається прийом коштів під час здійснення оплати клієнтом, здійснюється виключно з боку продавця

Чи може відбуватись перерахування коштів на користь контрагента коштів, які приймаються на декількох сайтах?

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

 

In NovaPay We Trust