{info}При интеграции со Сбербанк "Единый платежный сервис", эта платежная система соответствует следующим протоколам предлагаемым Сбербанком и его агентами:
* Протокол №1 "Описание протокола информационного взаимодействия по on-line запросам ЕПС к серверу Клиента №1"
* Приложение_15_(прот1).docx
Так же по этому протоколу работает платежная система "Расчетные Решения" (сайты www.nbcouec.ru и nko-rr.ru):
* Порядок_взаимодействия_с_Получателем_тип_А_009_от_26.09.2017.pdf
* Порядок_взаимодействия_с_Получателем_тип_А_010_от_03.11.2017.pdf{info}
{toc}
h2. Сайт платёжной системы
[Центральная Касса (РФ)|https://ckassa.ru]
[Центральная Касса (РК)|https://ckassa.kz]
[Биллинговые Системы|https://www.bisys.ru]
[КиберПлат|https://www.cyberplat.ru]
h2. Настройка доступа для платёжной системы "Сбербанк (ООО Биллинговые системы)"
# Предварительно необходимо произвести общую настройку [для всех ОСМП систем.|http://docs.carbonsoft.ru/pages/viewpage.action?pageId=65798343]
# Добавьте IP-адреса платежной системы в список разрешённых по статье "[CarbonBilling:Настройка сети для платежных систем]"
# Впишите ключ оператора. На стороне платежной системы параметр называется "*Пароль на цифровую подпись*"
!Биллинговые системы.png|border=0,width=800!
# Укажите доменное имя, на которое выдан сертификат, на странице [основных настроек платежных систем|Основные настройки платежных систем]
!ssl_domain.png|border=0,width=800!
# Настройте на стороне Сбербанка путь к обработчику запросов для платежной системы:
Адрес обработчика:
{code}
https://<ip биллинга>:2443/sbrf_bs.php
{code}
Если не заработает, попробуйте такой:
{code}
https://<ip биллинга>:2443/sbrf_kiberplat.php
{code}
h2. Подключение Центральной Кассы
* После заключения договора с сервисом, из предоставленного адреса для оплаты нужно скопировать номер магазина и добавить в настройки Платежных систем
Номер магазина необходимо взять из адреса оплаты, где *xxx* - номер магазина и добавить в поле "НОМЕР ЦЕНТРАЛЬНОЙ КАССЫ:"
{code}_autopays.ru/payment/#\!search_provider/pt_search/_{*}{_}xxx{_}{*}_/pay_{code}
!kassa.png|border=0,width=800!
* Добавьте на страницу оплаты личного кабинета шорткод для [Сбербанк (Биллинговые Системы)|CarbonBilling:Отображение платежных систем в личном кабинете абонента]
* При интеграции Центральной кассы необходимо выбрать спецификацию онлайн-взаимодействия *"Бисис-3"*.
* Центральная касса может отправлять данные в разных форматах, по умолчалнию в *GET* запросе. Наш обработчик использует принимает данные в *POST XML*. Попросите Центральную кассу отправлять в нём.
* Необходимо использовать обработчик sbrf_bs.php
{code:title=Адрес обработчика}
https://<ip биллинга>:2443/sbrf_bs.php
{code}
* Используется защищенный [порт платежных систем|Основные настройки платежных систем], без необходимости передачи сертификата:2443.
* При проведении тестирования в личном кабинете могут возникать ошибки - не обращайте на это внимание. Для проверки работоспособности, выполните платеж абоненту.
h2. XSD-схемы ответов на запросы
Для Сбербанк Киберплат:
{code}
<?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="CODE" type="xs:int"></xs:element>
<xs:elementname="MESSAGE" type="xs:string"></xs:element>
<xs:elementname="FIO" type="xs:string"></xs:element>
<xs:elementname="ADDRESS" type="xs:string"></xs:element>
<xs:elementname="ACCOUNT_BALANCE" type="xs:double"></xs:element>
<xs:elementname="REG_DATE" type="xs:dateTime"></xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>{code}
Но часть полей может отсутствовать, в зависимости от настроек биллинга и проводимой операции (CHECK или PAY).
Теоретически, для Центральной Кассы ответ должен быть тот же самый.
h2. Параметры запросов платежной системы kiberplat
|| Параметр || Значение \\ || Назначение || Примечание || check || payment ||
| *ACTION* | Возможные значения:check,payment | Определяет тип запроса | check – поиск Плательщика (проверка идентификатора);
payment – создание платёжной транзакции | + | + |
| *ACCOUNT* | Строка (определяется сценарием платежа) | Лицевой счет Плательщика | | + | +
| *AMOUNT* | Число | Сумма платежа | Разделитель “.” (точка) | | + |
| *PAY_ID* | Число | Идентификатор платежной транзакции | Положительное длинное целое число. Генерируется платёжной системой и используется для идентификации платёжных транзакций | | + |
| *PAY_DATE* | Дата и время | Дата и время операции в платежной системе | Дата и время операции в платежной системе по часовому поясу платежной системы в формате “DD.MM.YYYY_HH24:MI:SS”. Между датой и временем стоит символ “_” (подчеркивание) | | + |
* Протокол №1 "Описание протокола информационного взаимодействия по on-line запросам ЕПС к серверу Клиента №1"
* Приложение_15_(прот1).docx
Так же по этому протоколу работает платежная система "Расчетные Решения" (сайты www.nbcouec.ru и nko-rr.ru):
* Порядок_взаимодействия_с_Получателем_тип_А_009_от_26.09.2017.pdf
* Порядок_взаимодействия_с_Получателем_тип_А_010_от_03.11.2017.pdf{info}
{toc}
h2. Сайт платёжной системы
[Центральная Касса (РФ)|https://ckassa.ru]
[Центральная Касса (РК)|https://ckassa.kz]
[Биллинговые Системы|https://www.bisys.ru]
[КиберПлат|https://www.cyberplat.ru]
h2. Настройка доступа для платёжной системы "Сбербанк (ООО Биллинговые системы)"
# Предварительно необходимо произвести общую настройку [для всех ОСМП систем.|http://docs.carbonsoft.ru/pages/viewpage.action?pageId=65798343]
# Добавьте IP-адреса платежной системы в список разрешённых по статье "[CarbonBilling:Настройка сети для платежных систем]"
# Впишите ключ оператора. На стороне платежной системы параметр называется "*Пароль на цифровую подпись*"
!Биллинговые системы.png|border=0,width=800!
# Укажите доменное имя, на которое выдан сертификат, на странице [основных настроек платежных систем|Основные настройки платежных систем]
!ssl_domain.png|border=0,width=800!
# Настройте на стороне Сбербанка путь к обработчику запросов для платежной системы:
Адрес обработчика:
{code}
https://<ip биллинга>:2443/sbrf_bs.php
{code}
Если не заработает, попробуйте такой:
{code}
https://<ip биллинга>:2443/sbrf_kiberplat.php
{code}
h2. Подключение Центральной Кассы
* После заключения договора с сервисом, из предоставленного адреса для оплаты нужно скопировать номер магазина и добавить в настройки Платежных систем
Номер магазина необходимо взять из адреса оплаты, где *xxx* - номер магазина и добавить в поле "НОМЕР ЦЕНТРАЛЬНОЙ КАССЫ:"
{code}_autopays.ru/payment/#\!search_provider/pt_search/_{*}{_}xxx{_}{*}_/pay_{code}
!kassa.png|border=0,width=800!
* Добавьте на страницу оплаты личного кабинета шорткод для [Сбербанк (Биллинговые Системы)|CarbonBilling:Отображение платежных систем в личном кабинете абонента]
* При интеграции Центральной кассы необходимо выбрать спецификацию онлайн-взаимодействия *"Бисис-3"*.
* Центральная касса может отправлять данные в разных форматах, по умолчалнию в *GET* запросе. Наш обработчик использует принимает данные в *POST XML*. Попросите Центральную кассу отправлять в нём.
* Необходимо использовать обработчик sbrf_bs.php
{code:title=Адрес обработчика}
https://<ip биллинга>:2443/sbrf_bs.php
{code}
* Используется защищенный [порт платежных систем|Основные настройки платежных систем], без необходимости передачи сертификата:2443.
* При проведении тестирования в личном кабинете могут возникать ошибки - не обращайте на это внимание. Для проверки работоспособности, выполните платеж абоненту.
h2. XSD-схемы ответов на запросы
Для Сбербанк Киберплат:
{code}
<?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="CODE" type="xs:int"></xs:element>
<xs:elementname="MESSAGE" type="xs:string"></xs:element>
<xs:elementname="FIO" type="xs:string"></xs:element>
<xs:elementname="ADDRESS" type="xs:string"></xs:element>
<xs:elementname="ACCOUNT_BALANCE" type="xs:double"></xs:element>
<xs:elementname="REG_DATE" type="xs:dateTime"></xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>{code}
Но часть полей может отсутствовать, в зависимости от настроек биллинга и проводимой операции (CHECK или PAY).
Теоретически, для Центральной Кассы ответ должен быть тот же самый.
h2. Параметры запросов платежной системы kiberplat
|| Параметр || Значение \\ || Назначение || Примечание || check || payment ||
| *ACTION* | Возможные значения:check,payment | Определяет тип запроса | check – поиск Плательщика (проверка идентификатора);
payment – создание платёжной транзакции | + | + |
| *ACCOUNT* | Строка (определяется сценарием платежа) | Лицевой счет Плательщика | | + | +
| *AMOUNT* | Число | Сумма платежа | Разделитель “.” (точка) | | + |
| *PAY_ID* | Число | Идентификатор платежной транзакции | Положительное длинное целое число. Генерируется платёжной системой и используется для идентификации платёжных транзакций | | + |
| *PAY_DATE* | Дата и время | Дата и время операции в платежной системе | Дата и время операции в платежной системе по часовому поясу платежной системы в формате “DD.MM.YYYY_HH24:MI:SS”. Между датой и временем стоит символ “_” (подчеркивание) | | + |