{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:Настройка сети для платежных систем]" \\ \\
# Впишите ключ оператора. Если в качестве ключа оператора указан "test1234", то точно такое же значение должно быть указано на стороне платежной системы в поле "*Пароль на цифровую подпись*" \\ \\
!Биллинговые системы.png|border=0,width=800! \\ \\
# Укажите доменное имя, на которое выдан сертификат, на странице Основных настроек платежных систем \\ \\
!ssl_domain.png|border=0,width=800! \\ \\
# Настройте на стороне Сбербанка путь к обработчику запросов для платежной системы:
Адрес обработчика:
{code}
https://169.254.14.43:1443/sbrf_bs.php
{code}
Если не заработает, попробуйте такой:
{code}
https://169.254.14.43:1443/sbrf_kiberplat.php
{code}
{warning}Адрес *169.254.14.43* замените внешним адресом Вашего сервера{warning}
h2. Подключение Центральной Кассы
# После заключения договора с сервисом, из предоставленного адреса для оплаты нужно скопировать номер магазина и добавить в настройки Платежных систем
Номер магазина необходимо взять из адреса оплаты, где *xxx* - номер магазина и добавить в поле "НОМЕР ЦЕНТРАЛЬНОЙ КАССЫ:" \\ \\
{code}_autopays.ru/payment/#\!search_provider/pt_search/_{*}{_}xxx{_}{*}_/pay_{code} \\
!kassa.png|border=0,width=800! \\ \\
# Добавьте на страницу оплаты личного кабинета шорткод для [Сбербанк (Биллинговые Системы)|CarbonBilling:Отображение платежных систем в личном кабинете абонента]
При интеграции платежной системы рекомендуем выбрать спецификацию онлайн-взаимодействия *"Бисис-3"*
Необходимо использовать обработчик sbrf_bs.php
Адрес обработчика:
{code}https://внешний ip биллинга:2443/sbrf_bs.php{code}
Используется защищенный внешний порт платежных систем, без необходимости передачи сертификата:2443
При проведении тестирования в личном кабинете могут возникать ошибки. Для проверки работоспособности, рекомендуем выполнить платеж абоненту.
h2. Проверка интеграции
В личном кабинете Центрально Кассы можно запустить следующие проверки:
* Базовые проверки
* Обработка ошибок
* Регистрация платежей
{note}Они точно не пройдут! Проверять интеграцию необходимо совершив реальный платеж{note}
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:Настройка сети для платежных систем]" \\ \\
# Впишите ключ оператора. Если в качестве ключа оператора указан "test1234", то точно такое же значение должно быть указано на стороне платежной системы в поле "*Пароль на цифровую подпись*" \\ \\
!Биллинговые системы.png|border=0,width=800! \\ \\
# Укажите доменное имя, на которое выдан сертификат, на странице Основных настроек платежных систем \\ \\
!ssl_domain.png|border=0,width=800! \\ \\
# Настройте на стороне Сбербанка путь к обработчику запросов для платежной системы:
Адрес обработчика:
{code}
https://169.254.14.43:1443/sbrf_bs.php
{code}
Если не заработает, попробуйте такой:
{code}
https://169.254.14.43:1443/sbrf_kiberplat.php
{code}
{warning}Адрес *169.254.14.43* замените внешним адресом Вашего сервера{warning}
h2. Подключение Центральной Кассы
# После заключения договора с сервисом, из предоставленного адреса для оплаты нужно скопировать номер магазина и добавить в настройки Платежных систем
Номер магазина необходимо взять из адреса оплаты, где *xxx* - номер магазина и добавить в поле "НОМЕР ЦЕНТРАЛЬНОЙ КАССЫ:" \\ \\
{code}_autopays.ru/payment/#\!search_provider/pt_search/_{*}{_}xxx{_}{*}_/pay_{code} \\
!kassa.png|border=0,width=800! \\ \\
# Добавьте на страницу оплаты личного кабинета шорткод для [Сбербанк (Биллинговые Системы)|CarbonBilling:Отображение платежных систем в личном кабинете абонента]
При интеграции платежной системы рекомендуем выбрать спецификацию онлайн-взаимодействия *"Бисис-3"*
Необходимо использовать обработчик sbrf_bs.php
Адрес обработчика:
{code}https://внешний ip биллинга:2443/sbrf_bs.php{code}
Используется защищенный внешний порт платежных систем, без необходимости передачи сертификата:2443
При проведении тестирования в личном кабинете могут возникать ошибки. Для проверки работоспособности, рекомендуем выполнить платеж абоненту.
h2. Проверка интеграции
В личном кабинете Центрально Кассы можно запустить следующие проверки:
* Базовые проверки
* Обработка ошибок
* Регистрация платежей
{note}Они точно не пройдут! Проверять интеграцию необходимо совершив реальный платеж{note}
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”. Между датой и временем стоит символ “_” (подчеркивание) | | + |