¶ Платежные системы
Начиная с релиза БЮЛ ЕПС 5.0.1.38 все настройки по интеграции с платежными системами были вынесены в отдельный справочник «Настройки интеграции с платежными системами», который находится на вкладке «Настройки и сервисы» в разделе «Платежные системы»
¶ Перенос старых настроек в новый справочник
Перенос настроек требуется при обновлении на релиз БЮЛ ЕПС 5.0.1.38
Если вы оформляете залоги в программах ППЮЛ и все настройки у вас находятся непосредственно там, выполнять дальнейшие действия требуется в ППЮЛ.
Если вы принимаете решение вести централизованный учет настроек интеграции и заполнять их в БЮЛ, а затем выгружать на точки в ППЮЛ, то после описанных ниже действий переходите к разделу Обмен с ППЮЛ
Для переноса настроек необходимо выполнить следующие действия:
- Создать новый элемент справочника «Настройки интеграции с платежными системами»
- Заполнить Организацию
- Нажать на кнопку «Заполнить по текущим настройкам»
Необходимо убедиться, что все перенесено корректно!
После этого можно «Записать и закрыть» справочник.
¶ Настройка справочника
Настройки можно разделять по Организациям. В рамках одной Организации доступно добавление только одного элемента справочника.
По кнопке «Логирование обращение к сервису» будет открыта форма списка регистра сведений, который предназначен для хранения всех запросов, которые были отправлены в банк. В данный регистр добавлено сохранение отправленного запроса и полученного ответа.
Для сервисов, запросы которых подписываются с помощью RSA - необходима программа OpenSSL, установленная на сервере или клиенте (в зависимости от выбранного варианта подписи). Если выбран вариант подписи на сервере и режим работы базы данных клиент-сервер, у сервера 1С должен быть доступ к каталогу с OpenSSL.
Так же необходимы Приватный (Private) и Публичный (Public) ключи.
Приватный ключ – ключ RSA сформированный с помощью OpenSSL. Сформировать можно командой $ openssl genrsa -out privatekey.pem 4096, либо обратиться за помощью к системному администратору, либо к представителю сервиса, для которого он будет использоваться.
Публичный ключ – ключ RSA сформированный на основании приватного ключа с помощью OpenSSL. Сформировать можно командой $ openssl rsa -in privatekey.pem - pubout -out publickey.pem, либо обратиться за помощью к системному администратору, либо к представителю сервиса, для которого он будет использоваться.
Публичный ключ НЕ является обязательным для работы выплат, в программу его можно загрузить для хранения и последующей возможности сохранить из 1С без нового формирования.
Если используются индивидуальные настройки для Филиалов, то: путь к OpenSSL, выполнение подписи на клиенте/сервере, Приватный и Публичный ключи указываются построчно для каждого филиала.
В справочнике можно настроить подключение ко всем сервисам интеграции. Каждому сервису соответствует своя вкладка. Заполнение информации о подключении можно производить двумя способами:
- Заполнить общие настройки, которые будут действовать для всех филиалов
- Заполнить настройки для каждого филиала индивидуально
Внимание! Как только добавляется хоть одна индивидуальная настройка для филиала - общие настройки перестают действовать.
На рисунке указаны блок с общими настройками и блок с индивидуальными. При таком заполнении общие настройки учитываться не будут.
Но, общие настройки можно использовать для упрощения при заполнении индивидуальных, если большая часть данных повторяется. Для этого необходимо заполнить табличную часть строками с указанием необходимых филиалов, выделить строки и нажать кнопку «Заполнить общими настройками», расположенную над табличной частью.
Чтобы исключить филиал из использования сервиса, добавьте строку с этим филиалом в табличную часть и не устанавливайте флаг "Использовать".
Для сервисов с возможностью выплаты через СБП необходимо выполнить дополнительную настройку в справочнике Филиалы.
ВАЖНО!!! Варианты выплаты (на карту или СБП) зависят от настроек в справочнике и Видов обратного эквайринга, указанных в табличной части в Филиале. Если вариант выплат – Все, то в табличной части должно быть две строки (с флагом СБП и без соответственно). Либо если в настройках указан конкретный вид выплаты – то и в табличной части должен быть указан соответствующий вид обратного эквайринта. В противном случае при несовпадении настроек выплата на данный сервис будет недоступна.
¶ Обмен с ППЮЛ
Настройки интеграции с платежными системами можно вести как централизованно в программе БЮЛ, так и непосредственно на точках в ППЮЛ.
Обратите внимание, что автоматически из БЮЛ настройки в ППЮЛ не выгружаются.
Если вы принимаете решение вести централизованный учет настроек интеграции и заполнять их в БЮЛ, а затем выгружать на точки в ППЮЛ, то после заполнения справочника в БЮЛ необходимо зарегистрировать данные настройки на выгрузку. Для этого необходимо записать справочник и нажать на кнопку «Зарегистрировать на выгрузку».
Внимание! Выгружаются абсолютно все настройки, заполненные в справочнике.
После этого выполнить обмен с ППЮЛ обычным способом.
Обратите внимание, что в ППЮЛ нет табличной части с Филиалами, так как программа ППЮЛ рассчитана на работу с одним филиалом.
Настройки, заполненные в ППЮЛ обратно в БЮЛ не выгружаются.
¶ Сервис Т-Банк E2C
Сервис позволяет осуществлять выплаты на карты клиентам в операциях по залогу (обратный эквайринг) через Т-Банк.
Для оформления заявки на подключения сервиса, либо для получения информации по условиям обслуживания можно написать заявку на почтовый адрес eacq_support@tbank.ru.
В заявке необходимо указать:
- ИНН организации;
- Контактный номер;
- ФИО контактного лица.
Перед настройкой данного сервиса можно ознакомиться с общими настройками справочника.
¶ Настройки для работы сервиса Т-Банк E2C
Настройки для работы сервиса находятся на вкладке – Т-Банк справочника «Настройки интеграции с платежными системами».
- Флаг «Использовать» сделает в документе «Операция по залогу» с видом операции «Залог» и в обработке «Групповое формирование залогов» видимыми действия по работе с сервисом;
- Переключатель «Вариант пополнения» позволяет указать какой способ для выплаты будет доступен. На карту/Через СБП - будет открываться конкретный вариант, Все - приемщик сможет сам выбирать;
- Переключатель «Выполнять подпись» (На клиенте / На сервере). В зависимости от выбранного варианта поиск сертификата электронной подписи и подпись запросов будет происходить: на клиенте или на сервере;
- Переключатель «Вариант подписи» позволяет выбрать что будет использоваться для подписи запросов (до релиза 5.0.1.38 по умолчанию использовался вариант КриптоПро);
- В поле «Идентификатор терминала» необходимо внести значение из настроек терминала, которое указано в личном кабинете на официальном сайте банка;
- В поле «Серийный номер сертификата» должен быть указан номер сертификата ЭЦП, который установлен на данном компьютере. При нажатии кнопки «Найти» будет выведена форма со всеми найденными сертификатами. Необходимо выбрать сертификат в соответствии с ранее выбранным вариантом подписи.
- Флаг «Тестовый» влияет на то, на какой адрес будут отправляться запросы – на адрес, предназначенный для тестов или на боевой;
Изменения по релизу БЮЛ ЕПС 5.0.1.38
Добавлена возможность подписывать запросы RSA сертификатом. Для этого, кроме соответствующего сертификата так же необходимо загрузить в программу Приватный ключ (Private key) и указать путь к OpenSSL (подробнее тут).
¶ Пополнение карты клиента при выдаче займа
Если в настройках интеграции с платежными системами выставлен флаг «Использовать», то при запуске документа/обработки будет происходить проверка, есть ли на текущий момент времени доступ к сервису. Если доступа к сервису нет, то оператору будет выведено информационное сообщение о том, что выдача займа возможна только через наличный расчет (при отсутствии других подключенных сервисов). Также будет заблокирована возможность пробития безналичной оплаты.
Пополнение карты клиента будет доступно после оформления/проведения операции.
В Групповом формировании операций по залогу в таблице «Список билетов» в колонке «Эквайринг», будет отражаться – прошла ли успешно операция по пополнению карты клиента.
Так же если документ/обработка открывается под полными правами или у приемщика есть право просмотра остатка на счете - будет показан остаток, актуальность которого можно обновить, нажав на кнопку.
Для просмотра остатка на счете пользователю под правами «Приемщик ломбарда» требуется установка специальных настроек, которые находятся в карточке справочника Филиал.
Последовательность действий оператора для пополнения карты клиента:
- Кнопка «Пополнение карты клиента» и выбор из выпадающего списка вида сервиса «Т-Банк». При этом действии происходят следующие проверки:
• Не введена ли полная оплата наличными. В этом случае оператор увидит предупреждающее сообщение, обращения к сервису не будет;
• Оформлены ли все документы. Создан ли документ «Операция по залогу» для каждого билета; - В случае если пройдены все этапы пункта 1, происходит проверка – выбрана ли уже карта, на которую требуется перевести сумму займа. Если карта не выбрана, то оператору открывается окно в соответствии с настройками (с пополнением карты/ выплатой через СБП/ и тем и тем). Если карта выбрана, то задается вопрос о том, используется ли текущая карта или требуется повторный выбор.
Если операция выполняется под полными правами или приемщику доступен просмотр остатка на счете, то на форме будет выведен текущий остаток.
В случае нехватки средств для проведения выплаты будет выведено предупреждение и заблокирована возможность продолжения операции. В данном случае ее можно или отменить или узнав о пополнении баланса обновить его.
- Если список карт пуст или в нем нет нужной карты, оператор может добавить новую. При этом ему доступен выбор вида привязки карты. По умолчанию привязка карта будет осуществляться без проверок. Допустимо выбрать вид «При сохранении карты сделать списание и затем отмену на 1 руб.». При этом у клиента должна пройти операции по списанию, а затем отмены списания 1 рубля. При выполнении метода от банка мы получаем url-адрес со страницей привязки карты.
ВАЖНО!!! Страница открывается в браузере, который указан в реестре компьютера как используемый по умолчанию. Если используется устаревшая версия браузера, страница откроется, но часть действий будет недоступна.
В случае если операция добавления карты прошла успешно, то оператор может обновить список карт в перечне и выбрать для оформления пополнения нужную карту, если она не добавилась автоматически (зависит от того, как отработает страница в браузере).
- После выбора карты в программе происходит создание документа «Операции с платежными системами» для документа «Операция по залогу». При этом если для документа «Операция по залогу» уже создан документ «Операции с платежными системами», то повторное создание не происходит. После того как определен документ «Операции с платежными системами», происходит отправка транзакции к банку.
В документе, помимо данных шапки, хранятся данные по документу основанию, номеру заказа в нашей системе (номер и дата документа, должны быть уникальны в рамках терминала) и идентификатору пополнения в системе банка.
Если выплата проходила через СБП, то будет установлен флаг СБП и заполнено поле Телефон.
Результаты проведения транзакции можно будет увидеть в таблице «Список билетов» групповой обработки, в колонке «Эквайринг» или сообщением об успешно проведенной операции в документе.
- Если какие-то операции в процессе выполнения транзакций прошли неуспешно, то в таблице «Список билетов» у этих операций не будет поднят флаг «Эквайринг». При повторном нажатии кнопки «Пополнение карты клиента» произойдет последовательное выполнение алгоритма с 1 этапа.
ВНИМАНИЕ!!! Сервис Т-Банк E2C не содержит в себе команд по отмене проведенной транзакции. Обнуление операции, которая прошла по эквайрингу заблокировано.
- Для того чтобы зайти в список документов «Операции с платежными системами», необходимо:
- Под пользователем с полными правами зайти «Настройки и сервисы» - «Платежные системы» - «Операции с платежными системами»;
- Под пользователем с правами приемщикам ломбарда «Ломбард» - «Прочее» - «Операции с платежными системами»
¶ Доп. функционал по работе с сервисом Т-Банк E2C
Сервис Т-Банк E2C помимо команд по добавлению клиента/карты клиента, а так же проведения пополнения карты, позволяет выполнять следующие операции:
- Получить статус транзакции. Данная команда по номеру транзакции в системе Банка (Payment Id) позволяет получить информацию о статусе пополнения карты;
- Поиск клиента. Позволяет получить информацию о том, зарегистрирован ли клиент в выбранном терминале Банка. Проверка происходит по идентификатору клиента, который записан в реквизите «Customer key»;
- Удалить клиента. Позволяет произвести удаление клиента;
- Список карт клиента. Данная команда возвращает карты, которые привязаны к клиенту. Поиск происходит по идентификатору клиента, который записан в реквизите «Customer key»;
- Удалить карту. Удаляет карту, которая привязана к клиенту. Удаление происходит по идентификатору карты в системе Банка (Card Id);
- Обновить доступные к выплате средства. Получает сколько средств на счете доступно для выплаты.
Работа с этими командами реализована в обработке «Работа с сервисом Т-Банк E2C». Обработку можно открыть, выбрав «Настройки и сервисы» - «Платежные системы» - «Работа с сервисом Т-Банк E2C».
¶ Сервис Lombard Payments
Перед настройкой данного сервиса можно ознакомиться с общими настройками справочника.
¶ Настройки для работы сервиса
Настройки для работы сервиса находятся на вкладке – Lombard Payments справочника «Настройки интеграции с платежными системами».
- Флаг «Использовать» сделает в документе «Операция по залогу» с видом операции «Залог» и в обработке «Групповое формирование залогов» видимыми действия по работе с сервисом;
- В поле «ID сети Организации» указывается уникальный номер организации, который предоставляет сервис;
- В поле «Адрес шлюза» необходимо указать адрес, на который будут отправляться запросы;
- Флаг «Использовать защищенное соединение» влияет на то, будут ли отправляемые запросы иметь тип «https»;
- В поле «Ключ сети» указывается уникальное значение, которое предоставляет сервис;
- В поле «ID сети» указывается уникальный идентификатор подразделения;
- В поле «Время жизни сессии» указывается время, на которое проверяется текущая сессия на предмет активности. Время указывается в минутах. Если при проверке будет определяться, что текущая сессия уже неактивна, пользователю потребуется повторная авторизация;
Сервис «Lombard Payments» требует авторизации пользователей для отправки запросов. При первичной авторизации для пользователя выделяется уникальный номер сессии. Пока сессия активна, пользователь может отправлять запросы. История входа хранится в регистре сведений «История входа Lombard Payments».
В нем фиксируются время входа пользователя в систему, идентификатор сети (идентификатор организации/идентификатор подразделения), идентификатор аккаунта (идентификатор пользователя в системе «Lombard Payments»), идентификатор сессии и время ее окончания.
¶ Пополнение карты клиента при выдаче займа
Если в настройках интеграции с платежными системами выставлен флаг «Использовать», то при запуске документа/обработки будет происходить проверка, есть ли на текущий момент времени доступ к сервису. Если доступа к сервису нет, то оператору будет выведено информационное сообщение о том, что выдача займа возможна только через наличный расчет (при отсутствии других подключенных сервисов). Также будет заблокирована возможность пробития безналичной оплаты. Так же будет происходить проверка – существует ли активная сессия для пользователя. Если сессии нет, либо она уже не активна, то пользователю будет выведено окно авторизации.
В окне пользователю необходимо указать номер телефона, который был указан при регистрации сотрудника в системе «Lombard Payments», и пароль. Если в личном кабинете сервиса «Lombard Payments» настроена двухфакторная авторизация, то потребуется подтверждение входа через код, отправленный в SMS.
Пополнение карты клиента будет доступно после оформления/проведения операции.
В Групповом формировании операций по залогу в таблице «Список билетов» в колонке «Эквайринг», будет отражаться – прошла ли успешно операция по пополнению карты клиента.
Последовательность действий оператора для пополнения карты клиента:
- Кнопка «Пополнение карты клиента» (в случае, если используется 1 сервис) или выбор из выпадающего списка вида сервиса «Lombard Payments» (если используется несколько сервисов). При этом действии происходят следующие проверки:
• Не введена ли полная оплата наличными. В этом случае оператор увидит предупреждающее сообщение, обращения к сервису не будет;
• Оформлены ли все документы. Создан ли документ «Операция по залогу» для каждого билета; - В случае если пройдены все этапы пункта 1, происходит проверка – выбрана ли уже карта, на которую требуется перевести сумму займа. Если карта не выбрана, то оператору открывается окно с выбором карты. Если карта выбрана, то задается вопрос о том, используется ли текущая карта или требуется повторный выбор.
- Если список карт пуст или в нем нет нужной карты, оператор может добавить новую. Для этого необходимо указать номер карты и эмбосированное имя (имя клиента на латинице, указанное на лицевой стороне карты). После этого нажать кнопку «Добавить карту». Если добавление карты прошло успешно, пользователю будет выведено соответствующее сообщение.
- После выбора карты происходит выбор шлюза для оплаты.
Под шлюзом понимается сочетание банка (Русский стандарт, Открытие) и доступного лимита. Лимиты на выдачу настраиваются в личном кабинете на сайте сервиса.
- Если выбранный на этапе 4 шлюз прошел проверку, то оператор увидит окно с возможностью распечатать заявления на пополнение карты. Если клиент отказался на этом этапе, то оператор может нажать кнопку «Отменить», если клиент подписал документ, необходимо выбрать операцию «Продолжить».
- После выбора карты в программе происходит создание документа «Операции с платежными системами» для документа «Операция по залогу». При этом если для документа «Операция по залогу» уже создан документ «Операции с платежными системами», то повторное создание не происходит. После того как определен документ «Операции с платежными системами», происходит отправка транзакции к банку.
В документе, помимо данных шапки, хранятся данные по документу основанию и идентификатору пополнения в системе «Lombard Payments».
- Если какие-то операции в процессе выполнения транзакций прошли неуспешно, то в таблице «Список билетов» у этих операций не будет поднят флаг «Эквайринг». При повторном нажатии кнопки «Пополнение карты клиента» произойдет последовательное выполнение алгоритма с 1 этапа.
ВНИМАНИЕ!!! Сервис «Lombard Payments» не содержит в себе команд по отмене проведенной транзакции. Обнуление операции, которая прошла по эквайрингу заблокировано.
- Для того чтобы зайти в список документов «Операции с платежными системами», необходимо:
- Под пользователем с полными правами зайти «Настройки и сервисы» - «Платежные системы» - «Операции с платежными системами»;
- Под пользователем с правами приемщикам ломбарда «Ломбард» - «Прочее» - «Операции с платежными системами».
¶ Доп. функционал по работе с сервисом Lombard Payments
Работа с дополнительными возможностями сервиса «Lombard Payments» реализована в обработке «Работа с сервисом "Lombard Payments"». Обработку можно открыть, выбрав «Настройки и сервисы» - «Платежные системы» - «Работа с сервисом "Lombard Payments"». Под приемщиком ломбарда через «Ломбард - «Сервис» - «Работа с сервисом "Lombard Payments"».
В обработке можно посмотреть логирование обращений к сервису, а так же историю входов. Для пользователя с правами «Приемщик ломбарда» запрещено редактировать данные последнего регистра. С помощью кнопки «Авторизация» можно вызвать форму авторизации сервиса.
¶ Сервис KVELL
Сервис позволяет осуществлять выплаты на карты клиентам в операциях по залогу (обратный эквайринг) через Альфа-банк.
Контакты:
- Эл. почта: hello@kvell.ru;
- Номера телефонов: +74951202250, + 79263032544;
Перед настройкой данного сервиса можно ознакомиться с общими настройками справочника.
¶ Настройки для работы сервиса
Настройки для работы сервиса находятся на вкладке – KVELL справочника «Настройки интеграции с платежными системами».
- Флаг «Использовать» - сделает в документе «Операция по залогу» с видом операции «Залог» и в обработке «Групповое формирование залогов» видимыми действия по работе с сервисом;
- Переключатель «Вариант пополнения» позволяет указать какой способ для выплаты будет доступен. На карту/Через СБП - будет открываться конкретный вариант, Все - приемщик сможет сам выбирать;
- APY KEY – api-key из личного кабинета KVELL;
- SECRET KEY - секретный ключ, используемый для формирования электронной подписи из личного кабинета KVELL;
- Тестовый терминал – запрос будет выполняться к тестовому сервису KVELL
Для подписи запросов необходимо загрузить в программу Приватный ключ (Private key) и указать путь к OpenSSL (подробнее тут).
¶ Пополнение карты клиента при выдаче займа в обработке «Групповое формирование залогов»
Если в настройках интеграции с платежными системами выставлен флаг «Использовать», то при запуске документа/обработки будет происходить проверка заполнения настроек (путь к OpenSSL, идентификатор терминала, секретный ключ). Если эти настройки не заполнены, то оператору будет выведено информационное сообщение о том, что выдача займа возможна только через наличный расчет (при отсутствии других подключенных сервисов). Так же будет заблокирована возможность пробития безналичной оплаты.
Пополнение карты клиента будет доступно после оформления/проведения операции.
В Групповом формировании операций по залогу в таблице «Список билетов» в колонке «Эквайринг», будет отражаться – прошла ли успешно операция по пополнению карты клиента.
Так же если документ/обработка открывается под полными правами или у приемщика есть право просмотра остатка на счете - будет показан остаток, актуальность которого можно обновить, нажав на кнопку.
Для просмотра остатка на счете пользователю под правами «Приемщик ломбарда» требуется установка специальных настроек, которые находятся в карточке справочника Филиал.
Последовательность действий оператора для пополнения карты клиента:
- Кнопка «Пополнение карты клиента» (в случае, если используется 1 сервис) или выбор из выпадающего списка вида сервиса «KVELL» (если используется несколько сервисов). При этом действии происходят следующие проверки:
• Не введена ли полная оплата наличными. В этом случае оператор увидит предупреждающее сообщение, обращения к сервису не будет;
• Оформлены ли все документы. Создан ли документ «Операция по залогу» для каждого билета;
- В случае если пройдены все этапы пункта 1, происходит проверка – выбрана ли уже карта, на которую требуется перевести сумму займа. Если карта не выбрана, то оператору открывается окно в соответствии с настройками (с пополнением карты/ выплатой через СБП/ и тем и тем). Если карта выбрана, то задается вопрос о том, используется ли текущая карта или требуется повторный выбор.
Если выбран вариант выплаты через СБП, то открывается форма «Выплата через СБП».
Телефон по умолчанию заполняется из залогодателя, но есть возможность его изменить (введенный телефон будет сохранен в документе Пополнение карты клиента). Далее выбирается банк получателя. Его можно выбрать из избранных банков, либо при отсутствии подходящего – из выпадающего списка в поле Банк.
При «Выполнении платежа» сначала проводится проверка возможности выплаты. Запрос может обрабатываться некоторое время.
После выполнения проверки или будет сообщено об ошибке, или будет отправлен запрос в банк на выплату денег.
- После выбора карты в программе происходит создание документа «Операции с платежными системами» для документа «Операция по залогу».
При этом если для документа «Операция по залогу» уже создан документ «Операции с платежными системами», то повторное создание не происходит. После того как определен документ «Операции с платежными системами», происходит отправка транзакции к банку.
В документе, помимо данных шапки, хранятся данные по документу основанию и идентификатору пополнения в системе «KVELL». Если выплата проходила через СБП, то тудет установлен флаг СБП и заполнено поле Телефон.
- Если какие-то операции в процессе выполнения транзакций прошли неуспешно, то в таблице «Список билетов» у этих операций не будет поднят флаг «Эквайринг». При повторном нажатии кнопки «Пополнение карты клиента» произойдет последовательное выполнение алгоритма с 1 этапа.
ВНИМАНИЕ!!! Сервис «KVELL» не содержит в себе команд по отмене проведенной транзакции. Обнуление операции, которая прошла по эквайрингу заблокировано.
- Для того чтобы зайти в список документов «Пополнение карты клиента», необходимо:
- Под пользователем с полными правами зайти «Настройки и сервисы» - «Платежные системы» - «Операции с платежными системами»;
- Под пользователем с правами приемщикам ломбарда «Ломбард» - «Прочее» - «Операции с платежными системами».
¶ Сервис Сбер
Сервис позволяет осуществлять выплаты на карты клиентам в операциях по залогу (обратный эквайринг) через Сбер в БЮЛ ЕПС начиная с версии 5.0.1.18 и ППЮЛ ЕПС начиная с версии 2.1.1.17.
Для проведения операций через платежный шлюз Сбербанка, необходимо обратиться на указанные ниже контакты для оформления заявления и регистрации платежного шлюза на стороне Банка:
- Романюк Илья
1.2. Моб.тел.: 8-968-708-0133
1.3. Email: Romanyuk.I.E@sberbank.ru - Гомес Артур
2.1. Моб.тел.: 8-919-724-8986
2.2. Email: aegomes@sberbank.ru
Перед настройкой данного сервиса можно ознакомиться с общими настройками справочника.
¶ Настройки для работы сервиса
Для работы сервиса Сбер необходимо установить компоненту, предоставляемую Сбер. В архиве с компонентой в папке doc находятся 2 инструкции:
- 1006.2_Описание – в ней можно прочитать правила установки компоненты;
- Создание связки в ЛК – в ней можно прочитать, как добавлять бизнес карты в личном кабинете.
Изменения по релизу БЮЛ ЕПС 5.0.1.32. Добавлена поддержка библиотеки версии 1.007.03. Она доступна для скачивания по ссылке https://disk.yandex.ru/d/TIkyIPoOfhwsvQ. В архиве с компонентой в папке doc находятся 2 инструкции:
- 1.007.03_Описание – в ней можно прочитать описание и принцип работы платежной системы
- readMe – в нем описаны правила удаления старой компоненты (если такая была) и установки новой
Если планируется смс подтверждение по каждой операции, тогда компоненту необходимо устанавливать на клиентских машинах. Если смс подтверждения не будет, тогда компоненту устанавливаем на сервере.
ВНИМАНИЕ!!! Компонента Сбер работает только с сертификатами Минцифры РФ, которые необходимо установить, скачав с официального сайта https://www.sberbank.ru/ru/certificates.
Настройки для работы сервиса находятся на вкладке – Сбер справочника «Настройки интеграции с платежными системами».
- Флаг «Использовать» сделает в документе «Операция по залогу» с видом операции «Залог» и в обработке «Групповое формирование залогов» видимыми действия по работе с сервисом;
- Переключатель «Выполнять подпись на:». Установка в значение «клиенте» обязательна при использовании смс подтверждения, в иных случаях, тумблер выставляется в зависимости от расположения компоненты Сбер и формата используемой базы;
- Логин - предоставляется при заключении договора, содержит «-api»;
- Пароль - предоставляется представителями Сбер;
- Идентификатор карты - идентификатор бизнес карты (bindingId) в личном кабинете Сбер;
- Флаг «Тестовый сервер» - позволяет выполнять отправку запросов к тестовому серверу Сбер.
¶ Пополнение карты клиента при выдаче займа
Если в настройках интеграции с платежными системами выставлен флаг «Использовать», то при запуске обработки будет происходить запрос авторизации в Сбер. Если при авторизации возникнет ошибка, то оператору будет выведено информационное сообщение о том, что выдача займа возможна только через наличный расчет (при отсутствии других подключенных сервисов). Также будет заблокирована возможность пробития безналичной оплаты.
Пополнение карты клиента будет доступно после оформления/проведения операции.
В Групповом формировании операций по залогу в таблице «Список билетов» в колонке «Эквайринг», будет отражаться – прошла ли успешно операция по пополнению карты клиента.
Последовательность действий оператора для пополнения карты клиента:
- Кнопка «Пополнение карты клиента» (в случае, если используется 1 сервис) или выбор из выпадающего списка вида сервиса «Сбер» (если используется несколько сервисов). При этом действии происходят следующие проверки:
• Не введена ли полная оплата наличными. В этом случае оператор увидит предупреждающее сообщение, обращения к сервису не будет;
• Оформлены ли все документы. Создан ли документ «Операция по залогу» для каждого билета;
- В случае если пройдены все этапы пункта 1, происходит проверка – выбрана ли уже карта, на которую требуется перевести сумму займа. Если карта не выбрана, то оператору открывается окно с выбором карты. Если карта выбрана, то задается вопрос о том, используется ли текущая карта или требуется повторный выбор;
- После выбора карты в программе происходит создание документа «Операции с платежными системами» для документа «Операция по залогу». При этом если для документа «Операция по залогу» уже создан документ «Операции с платежными системами», то повторное создание не происходит. После того как определен документ «Операции с платежными системами», происходит отправка транзакции к банку;
В документе, помимо данных шапки, хранятся данные по документу основанию и идентификатору пополнения в системе «Сбер».
- Если какие-то операции в процессе выполнения транзакций прошли неуспешно, то в таблице «Список билетов» у этих операций не будет поднят флаг «Эквайринг». При повторном нажатии кнопки «Пополнение карты клиента» произойдет последовательное выполнение алгоритма с 1 этапа;
ВНИМАНИЕ!!! Сервис «Сбер» не содержит в себе команд по отмене проведенной транзакции.
- Для того чтобы зайти в список документов «Пополнение карты клиента», необходимо:
- Под пользователем с полными правами зайти «Настройки и сервисы» - «Платежные системы» - «Операции с платежными системами»;
- Под пользователем с правами приемщикам ломбарда «Ломбард» - «Прочее» - «Операции с платежными системами».
¶ Сервис Pay2Me
Сервис позволяет осуществлять выплаты на карты клиентам в операциях по залогу через сервис Pay2Me в БЮЛ ЕПС, начиная с версии 5.0.1.26, и ППЮЛ ЕПС, начиная с версии 2.1.1.25.
Для оформления заявки на подключение сервиса, либо для получения информации по условиям обслуживания, можно написать заявку на почтовый адрес или обратиться по телефонам:
- Бондаренко Екатерина Николаевна:
1.1. Email: bondarenkoen@psbank.ru;
1.2. тел: +79646260367; - Петухова Татьяна Сергеевна:
2.1. Email: petukhovats@psbank.ru;
2.2. тел: +79646260367; - Симонова Наталья Анатольевна:
3.1. Email: simonovana@psbank.ru
3.2. тел: +79104947545;
В заявке необходимо указать:
- ИНН организации;
- Контактный номер;
- ФИО контактного лица.
Перед настройкой данного сервиса можно ознакомиться с общими настройками справочника.
¶ Настройки для работы сервиса
Настройки для работы сервиса находятся на вкладке – Pay2Me справочника «Настройки интеграции с платежными системами».
- Флаг «Использовать» - сделает в документе «Операция по залогу» с видом операции «Залог» и в обработке «Групповое формирование залогов» видимыми действия по работе с сервисом.
- Переключатель «Вариант пополнения» позволяет указать какой способ для выплаты будет доступен. На карту/Через СБП - будет открываться конкретный вариант.
Обратите внимание! При смене варианта пополнения необходимо связаться с представителями Pay2Me для предоставления нового терминала, так как каждый настроен на определенный вариант выплаты. Вариант "Все" не поддерживается.
- Адрес шлюза - адрес шлюза для отправки запросов к сервису. Шлюзы равнозначны, допустимо переключение между ними при возникновении технических проблем;
- APY KEY – api-key из личного кабинета Pay2Me;
- SECRET KEY - секретный ключ, используемый для формирования электронной подписи из личного кабинета Pay2Me;
Для подписи запросов необходимо загрузить в программу Приватный ключ (Private key) и указать путь к OpenSSL (подробнее тут).
¶ Пополнение карты клиента при выдаче займа в обработке «Групповое формирование залогов»
Если в настройках интеграции с платежными системами выставлен флаг «Использовать», то при запуске обработки будет происходить проверка заполнения настроек (путь к OpenSSL, идентификатор терминала, секретный ключ). Если эти настройки не заполнены, то оператору будет выведено информационное сообщение о том, что выдача займа возможна только через наличный расчет (при отсутствии других подключенных сервисов). Также будет заблокирована возможность пробития безналичной оплаты.
Пополнение карты клиента будет доступно после оформления/проведения операции.
В Групповом формировании операций по залогу в таблице «Список билетов» в колонке «Эквайринг», будет отражаться – прошла ли успешно операция по пополнению карты клиента.
Так же если документ/обработка открывается под полными правами или у приемщика есть право просмотра остатка на счете - будет показан остаток, актуальность которого можно обновить, нажав на кнопку.
Для просмотра остатка на счете пользователю под правами «Приемщик ломбарда» требуется установка специальных настроек, которые находятся в карточке справочника Филиал.
Последовательность действий оператора для пополнения карты клиента:
- Кнопка «Пополнение карты клиента» (в случае, если используется 1 сервис) или выбор из выпадающего списка вида сервиса «Pay2Me» (если используется несколько сервисов). При этом действии происходят следующие проверки:
• Не введена ли полная оплата наличными. В этом случае оператор увидит предупреждающее сообщение, обращения к сервису не будет;
• Оформлены ли все документы. Создан ли документ «Операция по залогу» для каждого билета; - В случае если пройдены все этапы пункта 1, происходит проверка – выбрана ли уже карта, на которую требуется перевести сумму займа. Если карта не выбрана, то оператору открывается окно с выбором карты. Если карта выбрана, то задается вопрос о том, используется ли текущая карта или требуется повторный выбор.
- После выбора карты в программе происходит создание документа «Операции с платежными системами» для документа «Операция по залогу». При этом если для документа «Операция по залогу» уже создан документ «Операции с платежными системами», то повторное создание не происходит. После того как определен документ «Операции с платежными системами», происходит отправка транзакции к банку.
В документе, помимо данных шапки, хранятся данные по документу основанию и идентификатору пополнения в системе «Pay2Me».
- Если какие-то операции в процессе выполнения транзакций прошли неуспешно, то в таблице «Список билетов» у этих операций не будет поднят флаг «Эквайринг». При повторном нажатии кнопки «Пополнение карты клиента» произойдет последовательное выполнение алгоритма с 1 этапа.
ВНИМАНИЕ!!! Сервис «Pay2Me» не содержит в себе команд по отмене проведенной транзакции. Обнуление операции, которая прошла по эквайрингу заблокировано.
- Для того чтобы зайти в список документов «Пополнение карты клиента», необходимо:
- Под пользователем с полными правами зайти «Настройки и сервисы» - «Платежные системы» - «Операции с платежными системами»;
- Под пользователем с правами приемщикам ломбарда «Ломбард» - «Прочее» - «Операции с платежными системами».