Сбербанк ЕПС, протокол 2. ОСМП

Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.

Изменения (20)

просмотр истории страницы
{info}При интеграции со Сбербанк "Единый платежный сервис", эта платежная система соответствует следующим протоколам предлагаемым Сбербанком и его агентами:
* Протокол №2 "Описание протокола информационного взаимодействия по on-line запросам ЕПС к серверу Клиента №2"
* Порядок_взаимодействия_с_Получателем_тип_Б_004_от_26.09.2017.pdf{info} Приложение_16_(прот_2).docx

{info}Так же по этому протоколу работает платежная система "Расчетные Решения" (сайты www.nbcouec.ru и nko-rr.ru):
* Порядок_взаимодействия_с_Получателем_тип_Б_004_от_26.09.2017.pdf
* Порядок_взаимодействия_с_Получателем_тип_Б_005_от_03.11.2017.pdf{info}

{toc}

h1. Настройка работы Сбербанк (ОСМП)

http://168.254.14.44:1444/osmp.pdf
{code}
Адрес _168.254.14.44_ та кже замените на внешний адрес биллинга{info}

h1. Настройка со стороны Сбербанка

В анкете от Сбербанка необходимо указать следующие настройки:
* *Наличие BASIC-авторизации*: Нет
* *Порт*: 1443
* *Метод передачи данных*: POST
* *Использование MD5*: Нет
* *Тип SSL-соединения*: Двустороннее

h1. Прохождение тестов Сбербанка

* В некоторых случаях при интеграции Сбербанк генерирует документ под конкретного клиента, где клиент указывает все настройки (адрес обработчика, версию TLS, выбор протокола и т.д.). В этом же документе есть вкладка "Данные для подключения", где нужно выбрать тип SSL-соединения - односторонее или двустороннее. При выборе двустороннего типа также предлагается загрузить либо сертификат (.cer), либо хранилище сертификата (.pfx). В случае, если по .cer не получается соединиться и возникает ошибка handshake, рекомендуется выбрать тип "Хранилище сертификатов" - после этого автотесты Сбербанка проходят.
* Если требуется использовать односторонний SSL, нужно указать путь к обработчику с односторонней проверкой: https://<IP биллинга>:2443/sbrf.php
* Также есть нагрузочное тестирование. Если сервер не очень мощный, большое кол-во оплат может не проходить. В этом случае нужно, чтобы все пользователи вышли из биллинга. После выхода проходит 100% оплат.


h1. XSD-схемы ответов на запросы

Но часть полей может отсутствовать, в зависимости от настроек биллинга и проводимой операции (CHECK или PAY), например:
* В ответе на check будут recsum, balance и fio, а в ответе на PAY их не будет.
* В ответе на PAY будут prv_txn и sum, в ответе на CHECK их не будет.

{warning}
Обработчик биллинга не поддерживает Basic-авторизацию.
{warning}

h2. Параметры запросов платежной системы

|| Параметр || Значение \\ || Назначение || Примечание || check || payment ||
| *ACTION* | Возможные значения:check,payment | Определяет тип запроса | check – поиск Плательщика (проверка идентификатора);
| *command* | Возможные значения: check, pay. | Определяет тип запроса | check -- поиск Плательщика (проверка идентификатора);\\
payment -- создание платёжной транзакции | + | + |
| *ACCOUNT* | Строка (определяется сценарием платежа) | Лицевой счет Плательщика | | + | + |
| *AMOUNT* | Число | Сумма платежа | Разделитель “.” (точка) | | + |
| *sum* | Число | Сумма платежа | Разделитель “.” (точка) | + | + |
| *PAY_ID* *txn_id* | Число (содержит только цифры, длина максимум 20 знаков) | Идентификатор платежной транзакции | Положительное длинное целое число. Генерируется платёжной системой и используется для идентификации платёжных транзакций. | + | + |
| *PAY_DATE* | Дата и время | Дата и время операции в платежной системе | Дата и время операции в платежной системе по часовому поясу платежной системы в формате “DD.MM.YYYY_HH24:MI:SS”. Между датой и временем стоит символ “_” (подчеркивание) | | + |
| *txn_date* | Дата и время | Дата и время операции в платежной системе | Дата и время операции в платежной системе (формат ГГГГММДДЧЧММСС, часовой пояс всегда MCK UTC+3) | \- | + |
Пример проверки наличия абонента с номером договора TEST
{code}http://ip-биллинга:1444/sbrf.php?command=check&txn_id=1&account=TEST&sum=10.00{code}