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

Skip to end of metadata
Go to start of metadata
При интеграции со Сбербанк "Единый платежный сервис", эта платежная система соответствует следующим протоколам предлагаемым Сбербанком и его агентами:
  • Протокол №2 "Описание протокола информационного взаимодействия по on-line запросам ЕПС к серверу Клиента №2"
  • Приложение_16_(прот_2).docx

Так же по этому протоколу работает платежная система "Расчетные Решения" (сайты www.nbcouec.ru и nko-rr.ru):

  • Порядок_взаимодействия_с_Получателем_тип_Б_004_от_26.09.2017.pdf
  • Порядок_взаимодействия_с_Получателем_тип_Б_005_от_03.11.2017.pdf

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

  1. Добавьте IP-адреса Сбербанка в список разрешенных и проведите прочие общие настройки платежных систем по статье "Платежные системы. Общее"
  2. Передайте адрес обработчика платежей Сбербанку зависит от используемого протокола, http или https:
  3. Если используется SSL:
Описание протокола ОСМП можно скачать по адресу:
 http://168.254.14.44:1444/osmp.pdf

Адрес 168.254.14.44 также замените на внешний адрес биллинга

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

В анкете от Сбербанка необходимо указать следующие настройки:

  • Наличие BASIC-авторизации: Нет
  • Порт: 1443
  • Метод передачи данных: POST
  • Использование MD5: Нет
  • Тип SSL-соединения: Двустороннее

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

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

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

В анкете отправляемой в Сбербанк, на вопрос "XSD-схемы ответов на запросы" скоприруйте следующий текст:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:elementname="response">
<xs:complexType>
<xs:sequence>
<xs:elementname="osmp_txn_id" type="xs:string"></xs:element>
<xs:elementname="result" type="xs:string"></xs:element>
<xs:elementname="prv_txn" type="xs:int"></xs:element>
<xs:elementname="sum" type="xs:double"></xs:element>
<xs:elementname="fio" type="xs:string"></xs:element>
<xs:elementname="balance" type="xs:double"></xs:element>
<xs:elementname="recsum" type="xs:double"></xs:element>
<xs:elementname="minsum" type="xs:double"></xs:element>
<xs:elementname="comment" type="xs:string"></xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

Но часть полей может отсутствовать, в зависимости от настроек биллинга и проводимой операции (CHECK или PAY), например:

  • В ответе на check будут recsum, balance и fio, а в ответе на PAY их не будет.
  • В ответе на PAY будут prv_txn и sum, в ответе на CHECK их не будет.
Обработчик биллинга не поддерживает Basic-авторизацию.

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

Параметр Значение
Назначение Примечание check payment
command Возможные значения: check, pay. Определяет тип запроса check – поиск Плательщика (проверка идентификатора);
payment – создание платёжной транзакции
+ +
ACCOUNT Строка (определяется сценарием платежа) Лицевой счет Плательщика   + +
sum Число Сумма платежа Разделитель “.” (точка) + +
txn_id Число (содержит только цифры, длина максимум 20 знаков) Идентификатор платежной транзакции Положительное длинное целое число. Генерируется платёжной системой и используется для идентификации платёжных транзакций. + +
txn_date Дата и время Дата и время операции в платежной системе Дата и время операции в платежной системе (формат ГГГГММДДЧЧММСС, часовой пояс всегда MCK UTC+3) - +

Пример проверки наличия абонента с номером договора TEST

http://ip-биллинга:1444/sbrf.php?command=check&txn_id=1&account=TEST&sum=10.00

Метки

Введите метки, чтобы добавить к этой странице:
Please wait 
Ищите метку? просто начните печатать.