Приложение № 3

к Договору «О приеме и проведении переводов физических лиц»

№ ______ от «___» __________2017 г.

Порядок информационно-технологического взаимодействия

Обмен информацией между вебсервисами Банка (Система) и Клиентом должен
происходить методом двухфазного перевода. В первой фазе Система отправляет запрос на
проверку валидности счёта, во второй – подтверждает перевод на сумму, указанную
Плательщиком.
На следующий рабочий день после подтверждения переводов происходит
финальная сверка.
Первая фаза перевода
Исходящие из Системы поля (GET -запрос):
https://_____________________QueryType =check&Account=00000

Название Код Формат и комментарии

Счёт абонента (номер Account Текстовое поле.
договора, лицевого
счета, телефона и т.д.)

Ответ (XML) Клиента на запрос:

Название Код Формат и комментарии

Код ошибки ERROR Целое число (см. ниже) – обязательное поле
Баланс абонента BALANCE Десятичное число. В случае задолженности –
положительное –обязательное/необязательное поле.
Комментарии COMMENTS Текстовое поле. Доп. комментарии. Необязательное
поле.
ИНН INN ИНН организации, в пользу которой необходимо
перечислить денежные средства по принятому
переводу. Целое число, состоящее из 10/12 цифр.
Обязательное поле

Вторая фаза перевода

Исходящие из Системы поля (GET-запрос):
https://
______________________QueryType=pay&Account=00000&Payment_id=0000&Summa=1.00
&Exec_date=00000000000000& Inn=0000000000
Название Код Формат и комментарии
ID перевода в Системе Payment_id Целое число. Уникальный идентификатор перевода в
Системе.
Счёт абонента (номер Account Текстовое поле.
договора, лицевого
счета, телефона и т.д.)
Сумма перевода Summa Десятичное неотрицательное число.
Дата исполнения Exec_date Дата исполнения перевода. Формат YYYYMMDD
HH24MISS
ИНН Inn ИНН организации, в пользу которой будут перечислены
денежные средства по принятому переводу. Целое
число, состоящее из 10/12 цифр.
Ответ (XML) Клиента на запрос:

Название Код Формат и комментарии

Код ошибки ERROR Целое число (см. ниже) – обязательное поле
ID платежа у OUT_PAYMENT_ID Целое число. Уникальный идентификатор перевода у
поставщика Клиента.
Комментарии COMMENTS Текстовое поле. Доп. комментарии. Необязательное поле.

Ошибки
Клиент может сам выбирать числовые значения кодов ошибок и то, что они обозначают.
Зарезервированные коды ошибок (ERROR):
0 – возвращается, если запрос прошел успешно (для обоих фаз).
1 – Возвращается, если счёт абонента не найден (для обоих фаз).
10 – Возвращается, если данный перевод уже проведён (для второй фазы).
Остальные возможные коды ошибок Клиент должен описать сам и сообщить Системе.
Примечание: Должна быть возможность выполнять переводы только через вторую фазу
(это требуется для периодических переводов).

Онлайн-сверка
Исходящие из Системы поля (GET-запрос):
https://
____________________________________QueryType=balance&DateFrom=00000000000000&
DateTo=00000000000000& Inn=0000000000

Название Код Формат и комментарии

Дата с DateFrom Дата проведения перевода с(YYYYMMDD HH24MISS)
Дата по DateTo Дата проведения перевода по(YYYYMMDD HH24MISS)
ИНН Inn ИНН организации, по которой осуществляется сверка

В ответ Клиент возвращает список переводов, а также общую сумму и количество этих
переводов.

Название Код Формат и комментарии

Код ERROR Целое число– обязательное поле
ошибки
Общая FULL_SUMMA Десятичное число. Общая сумма переводов
сумма
Общее NUMBER_OF_PAYMENTS Целое число. Общее количество переводов
кол-во
переводов
Строка PAYMENT_ROW Строки со всеми переводами в формате:
перевода PAYMENT_ID;OUT_PAYMENT_ID;ACCOUNT;SUMMA;EXEC_DATE

На основании присланного реестра отправляется платежное поручение.

Примеры запросов

Проверка счета:
Запрос:
https://billing.operator.net:8443/paysys_check.cgi?QueryType =check&Account=12345
Успешный ответ:
<?xml version="1.0" encoding="UTF-8"?>
<CHECKRESPONSE>
< FIO >Иванов Иван Иванович</ FIO >
< BALANCE >125.00 </ BALANCE >
<ERROR>0</ERROR>
<COMMENTS>Success</COMMENTS>
<INN>1234567891</INN>
</CHECKRESPONSE>

Ошибка (Пользователь не существует):

<?xml version="1.0" encoding="UTF-8"?>
<CHECKRESPONSE>
<COMMENTS>Wrong client identifier</COMMENTS>
<ERROR>1</ERROR>
</CHECKRESPONSE>

Запрос на исполнение платежа:

Запрос:
https://billing.operator.net:8443/paysys_check.cgi?QueryType=pay&Account=12345&
Payment_id=9876&Summa=1.00&Exec_date=20170101182810& Inn=1234567891

Успешный ответ:
<?xml version="1.0" encoding="UTF-8"?>
<PAYRESPONSE>
<ERROR>0</ERROR>
<OUT_PAYMENT_ID>55555</OUT_PAYMENT_ID>
<COMMENTS>Success</COMMENTS>
</PAYRESPONSE>

Ошибка (Платеж уже проведен):

<?xml version="1.0" encoding="UTF-8"?>
<PAYRESPONSE>
<ERROR>10</ERROR>
<OUT_PAYMENT_ID>55555</OUT_PAYMENT_ID>
<COMMENTS>Double payment</COMMENTS>
</PAYRESPONSE>

Cверка реестра:
Запрос:
https://billing.operator.net:8443/paysys_check.cgi?
QueryType=balance&DateFrom=20170101000000&DateTo=2017010200000& Inn=1234567891

Успешный ответ:
<BALANCERESPONSE>
<ERROR>0</ERROR>
<FULL_SUMMA>5000.23</FULL_SUMMA>
<NUMBER_OF_PAYMENTS>33</ NUMBER_OF_PAYMENTS>
<PAYMENTS>
<PAYMENT_ROW>9876;55555;12345;1.00;20170101182810</PAYMENT_ROW>
<PAYMENT_ROW>12346;987658;55735;125.52;20170101191301</PAYMENT_ROW>
 …
</PAYMENTS>
</BALANCERESPONSE >

Ошибка (Период не закрыт):

< BALANCERESPONSE >
<ERROR>4</ERROR>
<СOMMENTS>Период не закрыт</COMMENTS>
</BALANCERESPONSE >

Обмен сообщениями
Обмен сообщениями производится по протоколу HTTPS (SSL/TLS). Кодировка
сообщений: UTF-8.
Расширенные возможности
При повышенных требованиях к безопасности возможно:
 соединение по VPN
 подписание сообщений (ГОСТ)
 шифрование сообщений (ГОСТ)

Тестовый аккаунт –
Боевой аккаунт -