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

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

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

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

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

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

Передумови

Перед налаштуванням підготуйте:

  • обліковий запис мерчанта WayForPay;
  • Merchant account;
  • Merchant secret key;
  • домен мерчанта;
  • активний банківський рахунок у гривні в QUINCEFIN.

Параметри мерчанта видає WayForPay. Формат запиту та підпису описано в офіційній документації Purchase. Для перевірки тестового платежу використовуйте тестові реквізити WayForPay, а не дані реальної картки.

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

  1. Відкрийте Налаштування → Інтеграції → Платіжні системи → WayForPay.
  2. Створіть новий профіль.
  3. Заповніть назву профілю.
  4. Вкажіть Merchant account і Merchant secret key з кабінету WayForPay.
  5. У полі Merchant domain введіть домен без протоколу та шляху, наприклад app.quincefin.com.
  6. Перевірте Callback URL.
  7. За потреби вкажіть Return URL, строк дії посилання та мову сторінки оплати.
  8. Збережіть профіль.

Стандартний callback URL:

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

QUINCEFIN передає цю адресу у WayForPay під час створення платежу. Не змінюйте її без потреби. Інший URL потрібен лише тоді, коли ваш екземпляр QUINCEFIN працює на іншому публічному домені.

Return URL — необов’язкова адреса, на яку клієнта буде повернено після оплати. Строк дії платіжного посилання задається у хвилинах.

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

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

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

Для WayForPay використовуйте рахунок у валюті UAH. Платіжні посилання в інших валютах ця інтеграція не створює.

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

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

Email і телефон клієнта передаються у WayForPay, якщо вони заповнені в контактній інформації партнера.

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

WayForPay надсилає callback у QUINCEFIN. Система перевіряє мерчанта, підпис, суму, валюту та статус платежу. Лише підтверджений платіж зі статусом Approved позначається як оплачений.

Після підтвердження QUINCEFIN:

  1. оновлює статус платіжного посилання;
  2. створює документ Надходження на банківський рахунок;
  3. пов’язує надходження з вихідним документом продажу;
  4. повертає WayForPay підписане підтвердження обробки callback.

Повторний callback не створює друге надходження для того самого платежу.

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

Перевірте:

  • профіль WayForPay активний і в ньому заповнені всі обов’язкові поля;
  • Merchant domain вказаний без https:// і без додаткового шляху;
  • у документі вибрано рахунок із профілем WayForPay;
  • валюта рахунку та документа — UAH;
  • сума документа більша за нуль;
  • користувач має доступ до інтеграції та документа.

Якщо оплата відбулася, але надходження не створилося, перевірте доступність callback URL і відповідність Merchant secret key чинному ключу мерчанта.

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