8.1. Payment Cashier Configuration

Введение

Для интеграции с Платёжной кассой требуется настроенный Главный Эндпоинт для отображения формы Кассы (также называемой Параллельной формой) и настроенные Вспомогательные Эндпоинты для каждого способа оплаты, отображаемого в Параллельной форме. Менеджер может настроить в Главном Эндпоинте, какой тип транзакции (sale, preauth) будет инициироваться для каждого способа оплаты и для какого списка стран этот способ оплаты будет отображаться. В одной Параллельной форме может быть несколько способов оплаты, например кредитная карта, банковский перевод и т. д., доступных Плательщику для выбора.

Parallel Form Master Endpoint Settings

Существует инструкция по конфигурации проекта для использования Parallel Form:

1. Чтобы настроить параллельную форму со способами оплаты в разных валютах, необходимо создать как минимум один проект для каждой валюты. Например, для обработки платежей в USD, EUR и JPY следует создать 3 разных проекта.

2. После создания проектов необходимо создать и подключить к соответствующим проектам все требуемые конечные точки для указанных способов оплаты. Эти конечные точки будут вспомогательными по отношению к основной конечной точке и будут называться вспомогательными.

3. Чтобы создать Master Endpoint, перейдите (Settings -> Configuration -> Master Endpoints -> + Master Endpoint).

4. Вспомогательные Эндпоинты, представляющие способы оплаты, должны быть подключены к Главному Эндпоинту, чтобы отображаться в Параллельной форме. Это можно сделать в настройках Главного Эндпоинта. Чтобы добавить новый Вспомогательный Эндпоинт, нажмите кнопку Добавить. Заполните форму с тремя полями: «Эндпоинт», «Способ оплаты» и «Справочное имя способа оплаты». В поле «Эндпоинт» следует выбрать один из доступных Эндпоинтов. Поле «Способ оплаты» определяет название способа оплаты, отображаемое на соответствующей вкладке Параллельной формы. Поле «Справочное имя способа оплаты» определяет внутреннее справочное имя этого способа оплаты, которое можно использовать для настройки стиля его отображения в шаблоне Параллельной формы.

5. После добавления Auxiliary Endpoint Менеджер также может выбрать тип инициируемой транзакции (sale, preauth) и задать список стран, в которых этот способ оплаты будет доступен. Чтобы выбрать список стран, нажмите кнопку с тремя точками напротив поля Auxiliary Endpoint.

6. Чтобы изменить шаблон Параллельной формы по умолчанию, перейдите к Главному Эндпоинту (Главный эндпоинт → Общие → Изменить → Шаблон платёжной формы). Чтобы изменить шаблон платёжной формы по умолчанию для конкретного способа оплаты, перейдите к экрану сведений соответствующего Вспомогательного Эндпоинта и задайте нужный Шаблон платёжной формы. Этот алгоритм возврата шаблона формы используется для всех типов шаблонов форм: оплаты, ожидания и завершения. Подробнее см. раздел «Логика отображения страницы оплаты» далее.

Примечание

Шаблон платёжной формы также можно задать в настройках Проекта (Проект → Общие → Изменить → Шаблон платёжной формы). Когда запрос отправляется на Главный Эндпоинт без указанного шаблона Параллельной формы, Главный Эндпоинт наследует шаблон Параллельной формы из настроек Проекта. Этот вариант не рекомендуется, поскольку обычно Главный Эндпоинт и Вспомогательные Эндпоинты подключены к одному Проекту, и таким образом все Эндпоинты унаследуют один и тот же шаблон формы.

Ниже приведён пример настроенного Master Endpoint с несколькими доступными способами оплаты, представленными подключёнными к нему Auxiliary Endpoints:

Ниже приведён пример успешной транзакции через Master Endpoint. Когда Плательщик открыл Parallel Form, основная транзакция инициировала вспомогательную транзакцию для способа оплаты, выбранного в форме. После получения вспомогательной транзакцией финального успешного статуса он вызвал финальный успешный статус основной транзакции:

Платёж Page Display Logic

Транзакции Платёжной кассы можно инициировать API-запросами или через Виртуальный терминал в интерфейсе. Когда Присоединяющаяся сторона (Торговец или платёжный посредник, представляющий Торговца) отправляет запрос на Главный Эндпоинт, система SBC возвращает URL Параллельной формы, HTML-содержимое которой определяется на уровне Главного Эндпоинта. Когда в Параллельной форме выбран способ оплаты, система SBC возвращает HTML-содержимое шаблона формы этого способа оплаты, заданного на уровне соответствующего Вспомогательного Эндпоинта (или вместо него отображает внешнюю платёжную форму).

У каждого способа оплаты своя логика отображения страницы оплаты. Payment Cashier может содержать несколько транзакций, инициированных в рамках одного платёжного сеанса, поскольку для Плательщика может быть доступно несколько способов оплаты. Когда Плательщик выбирает вкладку оплаты, инициируется соответствующая вспомогательная транзакция.

(1) Транзакции могут инициироваться API-запросами, пакетной загрузкой или через виртуальный терминал в UI. Для каждого метода оплаты предусмотрена собственная логика отображения платёжной страницы.

Примечание

Payment Cashier может иметь несколько транзакций, инициированных в одном платёжном сеансе, поскольку для плательщика может быть доступно несколько способов оплаты. Когда плательщик выбирает вкладку оплаты, инициируется соответствующая вспомогательная транзакция.

(3) Для оплаты кредитной картой форма отображается на стороне Платёжного Шлюза и может настраиваться. См. Payment Page Customization. Некоторые другие способы оплаты могут иметь дополнительные формы на стороне Платёжного Шлюза. Обратитесь в поддержку за подробностями.

(7) Некоторые методы оплаты требуют перенаправления плательщика на собственную форму. Эта форма не размещается Платёжным Шлюзом и не может быть настроена.

(9) Пока транзакция не достигнет финального статуса, Платёжный Шлюз отображает Wait Form для Плательщика.

(11) После того как транзакция достигает финального статуса, Платёжный Шлюз отображает Finish Form для Плательщика или Redirect на сайт Присоединяющейся стороны.

Примечание

Все шаблоны и макросы для кастомизации см. Forms Customization