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