2. PaySoft Merchant Interface
PaySoft Merchant Interface служить для прийому Платежів на сайті Продавця. Він заснований на передачі HTML-форм між сервером (сайтом) Продавця та сервером PaySoft :
1) Продавець на своєму сайті дозволяє Клієнту сформувати замовлення.
2) Продавець відправляє Клієнта на сайт PaySoft з одночасним відправленням форми запиту платежу.
3) PaySoft, за необхідністю авторизує Клієнта як свого користувача.
4) PaySoft надсилає Продавцю на Result URL форму попереднього запиту (але лише якщо відповідну опцію встановлено в налаштуваннях Кабінету Продавця) та одержує або не одержує у відповідь від Продавця підтвердження можливості прийому платежу.
5) У випадку одержання від Продавця підтвердження Фінансова установа здійснює прийом платежу від Клієнта.
6) У випадку успішного прийому платежу PaySoft:
- негайно надсилає Продавцю інформацію про це на Result URL у формі сповіщення про платіж;
- направляє Клієнта назад на сайт Продавця на Success URL і відправляє Продавцю на ту ж сторінку форму успішного платежу.
УВАГА! Вищеозначені дії відбуваються асинхронно, тобто незалежно одна від одної. Існує ймовірність отримання «форми успішного платежу» до отримання «форми сповіщення про платіж» (наприклад, у разі проблем зі з’єднанням між системою PaySoft та сайтом Продавця), а також неотримання «форми успішного платежу» у випадку, якщо користувач будь-яким чином запобіг відправленню зазначеної форми (наприклад, закрив сторінку відразу після підтвердження оплати).
7) У випадку відмови Клієнта від оплати або виникнення помилок, які унеможливили прийом платежу, п. 6 не виконується, а замість цього PaySoft :
- направляє Клієнта назад на сайт Продавця на Fail URL і відправляє Продавцю на ту ж сторінку форму неуспішного платежу.
Таким чином, Result URL - це секретна сторінка на сервері Продавця, а Success URL і Fail URL - публічні сторінки на сервері Продавця.
Час між отриманням «Форми попереднього запиту» та «Форми сповіщення про платіж» у звичайних випадках складає долі секунди, крім оплати через термінал самообслуговування (або банківську касу). У цьому випадку взаємодія Продавця та PaySoft майже не відрізняється від описаної вище, але Продавець має прийняти до уваги наступні нюанси:
- між формуванням замовлення на сайті Продавця та внесенням платежу може пройти необмежено багато часу;
- перед прийомом платежу PaySoft так само надсилає «Форму попереднього запиту», як у звичайному випадку, але час між «Формою попереднього запиту» та «Формою сповіщення про платіж» може сягати декількох годин (це пов’язано зі специфікою роботи терміналів самообслуговування).
Сайт PaySoft є багатомовним, за замовчуванням обрано російську мову. Для зміни мови необхідно додати відповідний маркер у цільовий Action інтерфейсу сайту PaySoft.
Список доступних маркерів:
- ru – російська мова;
- uk – українська мова;
- en – англійська мова;
Приклади застосування маркеру: