Данный документ описывает общие принципы взаимодействия XXX платежной системы с операторами мобильной связи, спутникового телевидения, Internet-провайдерами (далее – провайдерами услуг) с целью обеспечения приема платежей от дилеров платежной системы в пользу провайдера услуг.
В первом разделе описывается транспортная среда взаимодействия, далее – интерфейсы оперативного (on-line) взаимодействия, сверки платежей и возможности отмены платежа.
Взаимодействие платежной системы с провайдером услуг осуществляется по открытым каналам связи сети общего пользования Internet. Для обмена используется стек протоколов IP/TCP/HTTPS (HTTP over SSL). Защита передаваемых данных от несанкционированного доступа обеспечивается средствами криптографической библиотеки SSL (secure socket layer). Авторизация внешней платежной системы осуществляется за счет применения X.509 клиентского SSL сертификата. Сертификат выдается сертификационным центром провайдера услуг в ответ на “запрос на сертификат” со стороны платежной системы. Длина RSA ключа должна составлять не менее 512 бит. Идентификация внешней платежной системы осуществляется посредством атрибутов клиентского сертификата Субъект и Печать. В момент установления соединения с сервером провайдера услуг (формирования сессии информационного обмена) должна производиться верификация клиентского сертификата платежной системы по следующим критериям:
Web-сервер провайдера услуг должен обеспечивать возможность использования постоянных соединений, т.е. он должен положительно реагировать на HTTP заголовок Connection: Keep-Alive со стороны внешней платежной системы. Программное обеспечение на стороне сервера оператора связи должно выдавать HTTP заголовок Content-Length, при этом значение должно быть корректным. Платежная система должна быть извещена о значениях следующих параметров:
Запросы от платежной системы к серверу провайдера услуг передаются методом GET http-протокола с параметрами. Запросы могут направляться параллельно, при этом их обработка происходит независимо друг от друга. Т.е. новый запрос может быть отправлен до получения ответа на предыдущий запрос.
Ответы возвращаются в виде XML-документов. Атрибут encoding должен соответствовать действительности. Допускаются кодировки windows-1251, koi8-r, utf-8.
Параметр МАКСИМАЛЬНОЕ ВРЕМЯ ОТВЕТА (разъяснения см.ниже) от сервера провайдера услуг составляет 40 секунд.
В общем случае взаимодействие между платежной системой и провайдером услуг можно разделить на два типа:
On-line запросы предназначены для определения возможности проведения платежа (проверки номера абонента или его счета) и оперативного зачисления средств на счет абонента провайдера услуг.
Реестр платежей является окончательным документом, подтверждающим проведение операций. Существование реестра обусловлена необходимостью снижения вероятности ошибок в работе программного обеспечения и реализует принципы взаимного финансового контроля.
Для провайдеров, чьи абоненты не требовательны к оперативности зачисления средств, возможна реализация взаимодействия в off-line режиме, т.е. платежная система отправляет только реестр платежей. Однако для этого метода требуется дополнительное согласование методов проверки существования абонентов – либо периодическая передача в платежную систему существующей номерной емкости, либо методы ключевания счета абонента.
Вызов сервера провайдера услуг после установления соединения производится путем запроса страницы по полученному от оператора связи URL с параметрами методом GET.
К параметрам применяется url-кодирование.
Существует четыре типа запросов к серверу провайдера услуг:
Тип запроса определяется значением параметра action.
Ответ от сервера представляет собой XML-документ, соответствующий шаблону: 
<?xml version="1.0" encoding="windows-1251"?> <!DOCTYPE response [ <!ELEMENT response ( code, message, date, authcode ) > <!ELEMENT code ( #PCDATA )> <!ELEMENT message ( #PCDATA )> <!ELEMENT date ( #PCDATA )> <!ELEMENT authcode ( #PCDATA )> ]>
Итоговый реестр платежей представляет собой текстовый файл, содержащий список платежей, принятых внешней платежной системой в пользу провайдера услуг.
В итоговом реестре содержатся все успешно принятые платежи обработка которых завершилась за календарный день за отчетную дату за период времени с 00:00:00 по 23:59:59 по часовому поясу внешней платежной системы.
Платежи, отсутствующие в данном файле, но присутствующие у провайдера услуг, считаются не прошедшими и должны быть отменены. Платежи, присутствующие в данном файле, но отсутствующие у провайдера услуг, считаются прошедшими и должны быть проведены провайдером услуг при условии возможности проведения такого платежа.
Файлы шифруются посредством PGP и высылаются в виде вложения посредством электронной почты.
Имя файла – <идентификатор провайдера услуг>_YYYYMMDD.txt.asc.
Тема (заголовок) электронного письма – <идентификатор провайдера услуг>_YYYYMMDD
YYYYMMDD – соответствует дате отчета.
Файл состоит из текстовых строк переменной длины в ASCII, кодовая страница windows-1251. Каждая строка заканчивается символами “перевод строки”, “возврат каретки” (0x0D, 0x0A) и содержит информацию об одном платеже. Каждая строка содержит следующие поля:
| № | Наименование поля | Формат поля | Комментарии |
|---|---|---|---|
| 1 | Номер счета (или телефона) абонента | Строка до 20 символов | |
| 2 | Тип | Число | Тип абонента. Согласовывается с провайдером услуг, если данный провайдер использует систему для проведения платежей за несколько видов услуг. |
| 3 | Дата и время | YYYY-MM-DDThh:mm:ss | Дата время операции по часовому поясу платежной системы (из запроса). |
| 4 | Сумма платежа | Число | Целая часть: не более 7 цифр (рубли); Дробная часть: не более 2 цифр (копейки, может отсутствовать). В качестве разделителя дробной части используется точка. |
| 5 | Номер платежа | Число | Уникальный номер платежа в платежной системе (receipt). |
Сумма платежа указывается в рублях с копейками, разделитель – точка. Поля разделяются знаком табуляции (0x09).
Запрос: https://<host>/<path>?action=check&number=9166438476
Ответ:
<?xml version=”1.0” encoding=”windows-1251”?> <response> <code>0</code> <message>Абонент существует, возможен прием платежей</message> </response>
Запрос: https://<host>/<path>?action=check&number=account12&type=1
Ответ:
<?xml version=”1.0” encoding=”windows-1251”?> <response> <code>0</code> <message>Абонент существует</message> </response>
Ответ:
<?xml version=”1.0” encoding=”windows-1251”?> <response> <code>0</code> <authcode>132</authcode> <message>Платеж принят</message> </response>
<?xml version=”1.0” encoding=”windows-1251”?> <response> <code>0</code> <authcode>135</authcode> <message>Платеж принят</message> </response>
<?xml version=”1.0” encoding=”windows-1251”?> <response> <code>0</code> <authcode>132</authcode> <date>2005-09-20T15:55:00</date> <message>Платеж успешно отменен</message> </response>
<?xml version=”1.0” encoding=”windows-1251”?> <response> <code>7</code> <authcode>135</authcode> <message>Платеж отменен</message> <date>2005-09-20T15:55:00</date> </response>
