» UTM        
» Демо-версии        
RUEN
  Products Services Customer Area Partners Contact

 
         » Наши продукты
         » UTM 5
         » Интеграция с 1С
         » IVR
         » DynaShape
         » ndsad
         » Phone billing for Cisco
         » Документация
         » Сертификаты
         » Демо-версии
         » Цены
 

Все права защищены (c) 2001-2008 NetUP (www.netup.ru)
Перепечатка материалов разрешается только с предварительного разрешения компании NetUP (info@netup.ru)

Модуль интеграции UTM5 с платежными системами

Введение

Модуль интеграции UTM5 с платежными системами используется для регистрации платежей абонентов, произведенных через внешние платежные системы, в биллинговой системе UTM5.

Модуль обеспечивает:

  • прием и регистрацию запросов, предназначенных для UTM5, по протоколам, специфичным для каждой из внешних платежных систем;
  • ответ на запросы по протоколам, специфичным для каждой из внешних платежных систем;
  • проверку достоверности запросов в реальном времени;
  • регистрацию платежа в UTM5 в реальном времени;
  • возможность просматривать зарегистрированные запросы платежных систем;
  • возможность вводить корректировки платежей с последующей повторной регистрацией;
  • возможность устанавливать комиссионный сбор для каждой платежной системы в отдельности;
  • возможность производить настройку обработки запросов платежных систем.

Модуль интеграции UTM5 с платежными системами состоит из:

  • базового модуля - серверной части External Payment Systems Server, построенной на платформе NetUP Business Server (NBS)
  • набора дополнительных модулей для каждой внешней платежной системы
  • центра управления системой, построенного на платформе United Control Center (UCC).

Набор дополнительных модулей включает в себя модули для следующих платежных систем:

Системные требования:

  • сервер с установленной биллинговой системой UTM5
    • работающей под управлением одной из ОС
      • FreeBSD 5.4, 5.5
      • GNU/Linux (kernel 2.6)
    • использующей для хранения данных одну из СУБД:
      • MYSQL версии 5.032 и выше
      • PostgreSQL версии 8.2 и выше
    • наличие утилиты utm5_payment_tool
  • станция с установленным окружением Java Runtime Environment версии 5.0 и выше (JRE 1.5.0.x) для управления Модулем Интеграции.

Для платежных систем

  • e-port
  • Webmoney
  • Яндекс.Деньги

необходимо наличие библиотеки openssl (www.openssl.org) версии 0.9.8 и выше.

Для платежной системы

  • Яндекс.Деньги

необходимо наличие библиотеки gnupg (www.gnupg.org) версии 1.4.3

{i} Документация для версии Модуля интеграции UTM5 с платежными системами 2.1.7159.

Схема работы

Краткое описание схемы работы:

  1. Модуль принимает запросы от платежных систем
  2. Модуль производит проверку корректности запроса, регистрацию запроса в собственных таблицах базы данных UTM5
  3. Модуль вызывает для проведения платежа утилиту utm5_payment_tool

sys-EP_2a

Базовый модуль NBS External Payment Server выступает в качестве серверной части, принимая от клиента при помощи протокола HTTPS специальным образом сформированный запрос методом GET или POST. Запрос содержит идентифицирующий платежную систему параметр URI, и параметры, специфичные для каждой платежной системы.

(!) Параметр URI - часть HTTP запроса, находящаяся между адресом сервера и знаком вопроса. Например, в запросе

https://zao.ru:8080/osmp?command=check&txn_id=1234567&account=0957835959&sum=10.45

параметр URI = osmp.

{i} В договоре с платежной системой указывается параметр, по которому должна производиться идентификация платежной системы.

Специфичные параметры определяют тип запроса, сумму, дату, валюту, и другие параметры платежа.

{i} Специфичные параметры запросов приведены в Приложении.

Существуют следующие два типа запросов:

  • Запрос на проверку возможности внесения платежа (проверка параметров сделки, запрос состояния абонента, проверка состояния счета, предварительный запрос, проверка заказа и т.д.)
  • Запрос на внесение платежа (проведение сделки, пополнение баланса, пополнение лицевого счета, оповещение о платеже, уведомление об оплате и т.д.)

HTTPS запрос передается соответствующему дополнительному модулю платежной системы на обработку. При этом генерируется событие разбора HTTPS запроса. Это событие принадлежит семейству событий [netup:http].

{i} Каждый установленный дополнительный модуль платежной системы добавляет в семейство [netup:http] собственное событие разбора запроса. Например, модуль платежной системы e-port добавляет событие разбора запроса [netup:http]http_request[1.eport].

В соответствии с типом запроса событием разбора HTTPS запроса могут генерироваться события:

  • Проверки возможности внесения платежа [netup:business]payment_verification[1.external]
  • Внесения платежа [netup:business]new_payment[1.external]

События инициируют связанные с ними операции, имеющие ряд этапов, настраиваемых администратором системы. Такими этапами являются:

  • SQL запросы типа SELECT к таблицам базы данных UTM5 с выбором значения ровно одного параметра
  • команды, исполняемые оболочкой операционной системы

{i} Команды могут быть составными и определяются согласно правилам оболочки ОС. Для разделения команд в UNIX используются разделители операционной системы.

Примеры операций приведены ниже.

Пример 1

Событие проверки возможности внесения платежа [netup:business]payment_verification[1.external] инициирует операцию проверки платежа, этапом которой является:

  1. SQL запрос к таблицам базы данных UTM5
     SELECT db.personal_accounts.id AS personal_account_id FROM personal_accounts WHERE personal_accounts.id = "$account"
     

Пример 2

Событие внесения платежа [netup:business]new_payment[1.external] инициирует операцию внесения платежа, этапами которой являются:

  1. SQL запрос к таблицам базы данных UTM5
     SELECT event.sum AS amount
     SELECT db.personal_accounts.id AS personal_account_id FROM personal_accounts WHERE personal_accounts.id = "$cid" 
     
  2. Команда оболочки операционной системы
     /netup/utm5/bin/utm5_payment_tool 
     
    с ключами
     -e идентификатор платежа
     -k комментарий 
     -l логин системного пользователя  UTM5 от имени которого производится платеж
     -p пароль системного пользователя UTM5 от имени которого производится платеж
     -a номер лицевого счета в UTM5
     -b сумма
     -c код валюты в которой вносится платеж
     -i включить интернет
     -C путь к файлу конфигурации
     -L комментарий для администратора
     

Результатом исполнения события внесения платежа является присвоение запросу платежной системы состояния:

  • PROCESSED - обработанный платеж (синтаксис запроса корректен, корректна бизнес-логика проведения платежа, платеж зарегистрирован в системе UTM5)
  • IDENTIFIED - идентифицированный платеж (синтаксис запроса корректен, корректна бизнес-логика проведения платежа, но платеж не зарегистрирован в системе UTM5: невозможно выполнить shell-команду)
  • UNKNOWN - неизвестный платеж (синтаксис запроса корректен, но нарушена бизнес-логика проведения платежа)

{i} Для тестовых платежей (платежи при обработке которых производятся те же действия, что и обычно, но без вызова утилиты utm5_payment_tool) существуют состояния UNKNOWN_ON_TEST IDENTIFIED_ON_TEST.

{i} Для принудительного переведения платежа из состояния IDENTIFIED в состояние PROCESSED вызывается событие [netup:integration]payment_registration[1.external], которое пытается выполнить shell-команду, инициируемую событием внесения платежа.

Для платежных систем:

  • Яндекс.Деньги
  • Z-PAY
  • Web Money

бизнес-логика внесения платежа включает обязательную стадию предварительной проверки возможности проведения платежа.

Для данных систем синтаксически корректные платежи:

  • не прошедшие предварительную проверку
  • прошедшие проверку, но при окончательном внесении платежа имеющие измененные значения суммы, валюты, номера счета

получат состояние UNKNOWN.

В базе данных хранятся только те платежи, на которые система дала положительный ответ.

Технические операции, вызываемые парсером запроса

Существуют специфичные технические операции (проверки), необходимые для обработки запросов платежных систем. В зависимости от платежной системы набор проверок может отличаться.

В качестве проверок могут выступать операции:

  • Проверка цифровой подписи
  • Проверка хэш-суммы
  • Проверка входных параметров (например, секретного слова)
  • Проверка адресата
  • Генерация подписи

Примеры проверок приведены ниже.

Этапом проверки цифровой подписи является:

  1. Команда оболочки операционной системы
     FSIGN=$RANDOM.sign; echo -n "$pgpsignature" | perl /netup/etc/hex2bin.pl > /netup/etc/$FSIGN ; FTEXT=$RANDOM.text;
     echo -n "$orderispaid"";""$ordersumamount"";""$ordersumcurrencypaycash"";""$ordersumbankpaycash"";""$shopid"";""$ordernumber"";
     ""$customernumber" > /netup/etc/$FTEXT ;gpg --verify /netup/etc/$FSIGN /netup/etc/$FTEXT;TMP_RESULT=$? ;
     rm /netup/etc/$FSIGN /netup/etc/$FTEXT ; exit $TMP_RESULT ;
     

Этапами проверки хэш-суммы являются:

  1. SQL запрос к таблицам базы данных UTM5
     SELECT db.staff.password AS staff_password FROM staff WHERE staff.id = "$staff_id" 
     
  2. Команда оболочки операционной системы
     
    expr "$md5" == `echo -n "$orderispaid"";""$ordersumamount"";""$ordersumcurrencypaycash"";""$ordersumbankpaycash"";""$shopid"";
    ""$ordernumber"";""$customernumber"";""$staff_password" | openssl dgst -md5 | tr "[:lower:]" "[:upper:]"` ;
     

Этапом проверки входных параметров является:

  1. SQL запрос к таблицам базы данных UTM5
     SELECT db.staff.password AS staff_password FROM staff WHERE staff.id = "$staff_id" AND staff.password = "$dpass" 
     

Этапом проверки адресата является:

  1. SQL запрос к таблицам базы данных UTM5
     SELECT db.staff.login AS staff_login FROM staff WHERE staff.id = "$staff_id" AND staff.login = "$lmi_payee_purse" 
     

Этапом генерации подписи является:

  1. Команда оболочки операционной системы
     echo -n "$message" | openssl dgst -md5 -sign /netup/etc/external-payment-systems/eport/md5/private.pem  -hex
     

(!) Настройка серверной части, включая настройку операции, происходит с помощью центра управления и описывается в разделе Работа с центром управления.

{i} В системе e-port для проверки/генерации подписи используются параметры message и prepared_uri, сгенерированные парсером запроса в соответствии с документацией.

Установка

Модуль интеграции с внешними платежными системами устанавливается на компьютер, где уже установлена биллинговая система.

Для успешного внесения платежей необходимо наличие консольной утилиты utm5_payment_tool по адресу

/netup/utm5/bin/utm5_payment_tool

В случае, если на данном компьютере уже имеется установленная более ранняя версия системы, ее следует удалить:

rm -rf /netup/external-payment-systems

Также следует удалить скрипты запуска

для Linux

rm /etc/init.d/nbs-eps-linux

для FreeBSD

rm /usr/local/etc/rc.d/nbs-eps-free-bsd.sh

{i} При необходимости перед удалением произведите резервное копирование конфигурационного файла

/netup/etc/external-payment-systems/netup.cfg

/!\ Для проведения установки Модуля вы должны иметь привилегии суперпользователя.

Установка базового модуля

GNU/Linux

В личном кабинете клиента на сайте http://www.netup.ru/ в разделе Платежные Системы необходимо загрузить базовый модуль:

  • архив netup-payment-systems-linux-mysql.tar.gz, если в качестве базы данных UTM5 используется MySQL,
  • архив netup-payment-systems-linux-pgsql.tar.gz, если в качестве базы данных UTM5 используется PostgreSQL.

На сервере с ОС GNU/Linux следует распаковать архив командой:

# tar zxf netup-payment-systems-linux-mysql.tar.gz -C /

если в качестве базы данных UTM5 используется MySQL.

# tar zxf netup-payment-systems-linux-pgsql.tar.gz -C /

если в качестве базы данных UTM5 используется PostgreSQL.

FreeBSD

В личном кабинете клиента на сайте http://www.netup.ru/ в разделе Платежные Системы необходимо загрузить базовый модуль:

  • архив netup-payment-systems-freebsd-mysql.tar.gz, если в качестве базы данных UTM5 используется MySQL,
  • архив netup-payment-systems-freebsd-pgsql.tar.gz, если в качестве базы данных UTM5 используется PostgreSQL.

На сервере с ОС FreeBSD следует распаковать архив командой:

#  tar zxf netup-payment-systems-freebsd-mysql.tar.gz -C /

если в качестве базы данных UTM5 используется MySQL.

# tar zxf netup-payment-systems-freebsd-pgsql.tar.gz -C /

если в качестве базы данных UTM5 используется PostgreSQL.

Установка дополнительных модулей

Для установки модулей платежных системам загрузите, воспользовавшись ссылкой в личном кабинете в разделе Платежные Системы, модули платежных систем.

sys-EP_3a

Архивы дополнительных модулей имеют названия вида:

netup-<платежная система>-<операционная система>-<база данных>.tar.gz,

где <платежная система> - название платежной системы, <операционная система> - linux или freebsd, <база данных> - mysql или pgsql.

На сервере с ОС GNU/Linux или FreeBSD распакуйте архивы дополнительных модулей:

# tar zxf netup-<платежная система>-<операционная система>-<база данных>.tar.gz -C /

Дополнительные сведения по установке

e-port

По договору между провайдером и платежной системой будет выдано 2 ключа для openssl-шифрования (публичный и приватный). Публичный ключ необходимо скопировать в /netup/etc/external-payment-systems/eport/public.pem. Приватный ключ необходимо скопировать в /netup/etc/external-payment-systems/eport/private.pem.

Уникасса

По договору между провайдером и платежной системой будет выдан идентификатор провайдера (duser) и секретное слово провайдера (dpass).

Необходимо создать новую службу, имеющую

Name = <имя новой службы Уникасса>
Login = <идентификатор провайдера>
Password = <секретное слово провайдера>

{i} Данная операция производится с помощью центра управления (вкладка Персонал).

В настройках Внешних платежных систем (вкладка Внешние платежные системы) в настройках платежной системы Уникасса необходимо изменить Автоматическую службу, указанную по умолчанию, на созданную в предыдущем действии, указав в качестве имени автоматической службы <имя новой службы Уникасса>.

Web Money

По договору между провайдером и платежной системой будет выдано секретное слово провайдера для расчета md5-суммы.

Необходимо создать новую службу, имеющую

Name = <имя новой службы Web Money>
Login = <номер кошелька провайдера>
Password = <секретное слово провайдера>

{i} Данная операция производится с помощью центра управления (вкладка Персонал).

В настройках Внешних платежных систем (вкладка Внешние платежные системы) в настройках платежной системы Web Money необходимо изменить Автоматическую службу, указанную по умолчанию, на созданную в предыдущем действии, указав в качестве имени автоматической службы <имя новой службы Web Money>.

Яндекс.Деньги

По договору между провайдером и платежной системой будет выдан идентификатор провайдера (shopId), секретное слово провайдера и публичный ключ для GnuPG шифрования.

Необходимо создать новую службу, имеющую

Name = <имя новой службы Яндекс.Деньги>
Login = <идентификатор провайдера>
Password = <секретное слово провайдера>

{i} Данная операция производится с помощью центра управления (вкладка Персонал).

В настройках Внешних платежных систем (вкладка Внешние платежные системы) в настройках платежной системы Яндекс.Деньги необходимо изменить Автоматическую службу, указанную по умолчанию, на созданную в предыдущем действии, указав в качестве имени автоматической службы <Имя новой службы Яндекс.Деньги>.

На сервере с Модулем платежных систем необходимо импортировать ключ

gpg --import <файл публичного ключа>

Z-PAY

По договору между провайдером и платежной системой будет выдано секретное слово провайдера для расчета md5-суммы.

Необходимо создать новую службу, имеющую

Name = <имя новой службы Z-PAY>
Login = <номер кошелька провайдера>
Password = <секретное слово провайдера>

{i} Данная операция производится с помощью центра управления (вкладка Персонал).

В настройках Внешних платежных систем (вкладка Внешние платежные системы) в настройках платежной системы Z-PAY необходимо изменить Автоматическую службу, указанную по умолчанию, на созданную в предыдущем действии, указав в качестве имени автоматической службы <имя новой службы Z-PAY>.

Активация сертификата

В личном кабинете клиента на сайте http://www.netup.ru/ в разделе Платежные Системы необходимо, воспользовавшись ссылкой Скачать сертификат, загрузить файл сертификата netup.keystore

sys-EP_3b

и сохранить его в директории /netup/etc/external-payment-systems/

/!\ В пароле приватного ключа допускается использование латинских букв, цифр, символа подчеркивания и дефиса. Использование других символов не допускается.

/!\ После приобретения нового модуля, необходимо заново скачать сертификат.

Установка центра управления

Для установки центра управления Модуля интеграции UTM5 с платежными системами загрузите архив utc-payment-systems.zip, воспользовавшись ссылкой Скачать центр управления в личном кабинете в разделе Платежные системы. Распакуйте архив utc-payment-systems.zip.

Скопируйте файл сертификата netup.keystore в директорию с центром управления.

(!) Распаковку новой версии интерфейса не следует проводить поверх старой.

(!) Для запуска интерфейса администрирования необходимо установить Java Runtime Environment версии не ниже 5.0 (JRE 1.5.0.x). Дистрибутив доступен для загрузки на сайте производителя http://java.sun.com в разделе downloads или на сайте http://www.netup.ru в разделе демонстрационные версии (http://www.netup.ru/downloads/jre-1_5_0-windows-i586.exe).

Настройка

Конфигурирование серверной части

По умолчанию используется конфигурационный файл /netup/etc/external-payment-systems/config.xml

Перед запуском серверной части следует в конфигурационном файле config.xml:

1. Задать полный путь к сертификату netup.keystore, пароль для его открытия и пароль приватного ключа.

(!) Пример сертификата

                        Параметры сертификата
Название организации                            NetUP
Название подразделения                          test
E-mail                                          test@netup.ru
Код страны                                      RU
Регион                                          M
Город                                           M
Пароль приватного ключа                         123

До

        <security>
                <!-- файл хранилища сертификатов и пароль для его открытия -->
                <keystore file="INPUT_YOUR_KEYSTORE_FILENAME" password="INPUT_YOUR_PASSWORD"/>

                <!-- пароль приватного ключа -->
                <private_key passphrase="INPUT_YOUR_PASSPHRASE"/>
        </security>

После

        <security>
                <!-- файл хранилища сертификатов и пароль для его открытия -->
                <keystore file="/netup/etc/external-payment-systems/netup.keystore" password="123"/>

                <!-- пароль приватного ключа -->
                <private_key passphrase="123"/>
        </security>

2. Задать параметры соединения с базой данных.

(!) Пример 1. База данных PostgreSQL v.8.2 на локальном сервере.

Имя базы данных:                               TEST_UTM5
Логин (суперпользователь) базы данных:         test_user
Пароль для логина:                             test_password

До

        <data_base>
                <!-- параметры соединения с базой данных PostgreSQL v.8.2 -->
                <pgsql name="INPUT_YOUR_DB_NAME" login="INPUT_YOUR_DB_LOGIN" password="INPUT_YOUR_DB_PASSWORD" max_connection="10"
                       host="INPUT_YOUR_DB_HOST" port="INPUT_YOUR_DB_PORT" socket="INPUT_YOUR_DB_SOCKET" options=""/>
        </data_base>

После

        <data_base>
                <!-- параметры соединения с базой данных PostgreSQL v.8.2 -->
                <pgsql name="TEST_UTM5" login="test_user" password="test_password" max_connection="10"
                       host="" port="" socket="" options=""/>
        </data_base>

(!) Пример 2. База данных PostgreSQL v.8.2 на удаленном сервере.

IP хоста:                                      10.1.1.1
Порт соединения:                               5432
Имя базы данных:                               TEST_UTM5
Логин (суперпользователь) базы данных:         test_user
Пароль для логина:                             test_password

До

        <data_base>
                <!-- параметры соединения с базой данных PostgreSQL v.8.2 -->
                <pgsql name="INPUT_YOUR_DB_NAME" login="INPUT_YOUR_DB_LOGIN" password="INPUT_YOUR_DB_PASSWORD" max_connection="10"
                       host="INPUT_YOUR_DB_HOST" port="INPUT_YOUR_DB_PORT" socket="INPUT_YOUR_DB_SOCKET" options=""/>
        </data_base>

После

        <data_base>
                <!-- параметры соединения с базой данных PostgreSQL v.8.2 -->
                <pgsql name="TEST_UTM5" login="test_user" password="test_password" max_connection="10"
                       host="10.1.1.1" port="5432" socket="" options=""/>
        </data_base>

{i} При старте сервер использует sql-скрипты, для работы которых требуется скопировать библиотеку plpgsql.so в директорию /netup/external-payment-systems/lib/:

> locate plpgsql.so
/usr/local/pgsql/lib/plpgsql.so

>cp /usr/local/pgsql/lib/plpgsql.so /netup/external-payment-systems/lib/

(!) Пример 3. База данных MySQL v.5.032 на локальном сервере.

Имя базы данных:                               TEST_UTM5
Логин (суперпользователь) базы данных:         test_user
Пароль для логина:                             test_password

До

        <data_base>
                <!-- параметры соединения с базой данных MySQL v.5.032 -->
                <mysql name="INPUT_YOUR_DB_NAME" login="INPUT_YOUR_DB_LOGIN" password="INPUT_YOUR_DB_PASSWORD" max_connection="10"
                       host="INPUT_YOUR_DB_HOST" port="INPUT_YOUR_DB_PORT" socket="INPUT_YOUR_DB_SOCKET" options=""/>
        </data_base>

После

        <data_base>
                <!-- параметры соединения с базой данных MySQL v.5.032 -->
                <mysql name="TEST_UTM5" login="test_user" password="test_password" max_connection="10"
                       host="" port="" socket="/var/run/mysqld/mysqld.sock" options=""/>
        </data_base>

{i} Значение параметра socket можно получить следующим образом:

> mysql -u test_user -p test_password TEST_UTM5
mysql> status
--------------
mysql  Ver 14.12 Distrib 5.0.32, for pc-linux-gnu (i686) using readline 5.1

Connection id:          108507
Current database:
Current user:           root@localhost
SSL:                    Not in use
Current pager:          /usr/bin/less
Using outfile:          ''
Using delimiter:        ;
Server version:         5.0.32 Gentoo Linux mysql-5.0.32
Protocol version:       10
Connection:             Localhost via UNIX socket
Server characterset:    utf8
Db     characterset:    utf8
Client characterset:    utf8
Conn.  characterset:    utf8
UNIX socket:            /var/run/mysqld/mysqld.sock
Uptime:                 97 days 14 hours 4 min 28 sec

Threads: 7  Questions: 2985406  Slow queries: 148  Opens: 16657130  Flush tables: 1  Open tables: 64  Queries per second avg: 0.354
--------------

Конфигурирование брандмауэра

К системам, отсылающим запросы с определенных IP-адресов, относятся:

Для возможности внесения платежей только с серверов этих платежных систем необходимо настроить брандмауэр. Следует разрешить запросы с IP-адресов серверов платежных систем. Следует запретить запросы с любых других IP-адресов.

{i} IP-адреса серверов платежных систем указаны в договоре с платежной системой.

/!\ На конфигурирование брандмауэра следует обратить особое внимание.

К системам, использующим цифровые подписи, относятся:

  • e-port
  • Яндекс.Деньги
  • Z-PAY
  • WebMoney

Для этих платежных систем нет необходимости закрывать IP-адреса.

Запуск серверной части. Журналирование

GNU/Linux

Для запуска базового модуля выполните команду

# /etc/init.d/netup-payment-systems start

Добавьте базовый модуль к списку ПО, запускаемого автоматически.

FreeBSD

Для запуска базового модуля выполните команду

# /usr/local/etc/rc.d/netup-payment-systems.sh start

Для автоматического запуска добавьте в файл /etc/rc.conf строку

netup-payment-systems_enable="YES"

Журналирование

В файле

/netup/log/external-payment-systems/payments.log

находится вся (включая запросы с некорректным синтаксисом) информация о полученных от платежных систем запросах, результаты их обработки.

В файле

/netup/log/external-payment-systems/management.log

содержится информация о платежах, модифицирование которых производилось с помощью центра управления.

В файле

/netup/log/external-payment-systems/netup.log

содержится информация об обмене информацией между клиентом (центром управления) и сервером.

В файле

/netup/log/external-payment-systems/verifier.log

содержится информация об ошибках в структуре базы данных.

Файл

/netup/log/external-payment-systems/details.log

является полным логом, содержащим всю техническую информацию.

Работа с центром управления. Профили

Запуск центра управления производится двойным кликом мыши на файле control.center.se.jar или командой:

java -jar control.center.se.jar

{i} При работе с базами данных, содержащих больше 25 тысяч пользователей, рекомендуется использовать ключ запуска -Xmx1g.

Введите логин и пароль для доступа в систему, пароль приватного ключа, указанный в параметрах сертификата. Для указания адреса и порта NBS External Payment Systems сервера нажмите на кнопку с изображением гаечного ключа.

sys-EP_4a

Для запуска центра управления нажмите на кнопку с надписью External Payment Systems.

{i} При первом запуске и использовании профиля Администратора, введите логин - root, пароль - root. При использовании профиля Менеджера, введите логин - manager, пароль - manager (подробнее о профилях системы в разделе Профили).

Интерфейс администрирования Модуль интеграции с платежными системами будет запущен.

Профили

Профили обеспечивают разграничение привилегий.

По умолчанию в системе заведены профили:

  • Администратора
  • Менеджера

Администратор обладает привилегиями на использование всего функционала системы. Администратор имеет возможность:

  • производить операции с платежами в Отчете по платежам
  • настраивать взаимодействие с внешними платежными системами
  • управлять событиями, ролями, задачами, персоналом
  • просматривать текущие соединения с сервером

sys-EP_4b

Менеджер имеет возможность производить операции только в Отчете по платежам.

sys-EP_4b2

/!\ В дальнейшем необходимо изменить логин и пароль для входа в систему, отредактировав данные параметры в свойствах учетных записей подсистем root и manager. Редактирование учетной записи подсистемы описывается в разделе Персонал.

{i} На панели состояния в нижней части окна производится индикация состояния соединения и отображаются дата и время. Зеленый значок индикации соединения означает - соединение установлено, красный - соединение отсутствует. Для установки нового соединения следует кликнуть левой или правой клавишей мыши на значке индикации или выбрать в главном меню Система пункт Открыть соединение...

{i} Для некоторых объектов системы существует возможность вызова контекстного меню объекта. Контекстное меню данного объекта вызывается кликом правой клавишей мыши на этом объекте.

{i} После изменения данных или регистрации новых становится видимой панель Уведомление об изменении данных. Кнопка Отклонить (красный крестик) - отменяет изменения и закрывает данную панель. Кнопка Применить (зеленая галочка) - отправляет изменения на сервер и закрывает данную панель.

sys-EP_4c

{i} При наведении курсора мыши на названия терминов всплывает подсказка, подробно информирующая о значении термина.

Отчет по платежам

Для отображения отчета по платежам пользователей, пополнивших баланс лицевых счетов с помощью внешних платежных систем (пользователи указывали в качестве своего идентификатора номер лицевого счета в системе UTM5), необходимо выбрать в списке типичных задач элемент Отчеты, Отчет по платежам.

sys-EP_4e0

Получение данных

С помощью панели Получение данных производится фильтрация платежей по:

  • Состоянию
  • Типу
  • Времени
  • По значению в таблице

sys-EP_4e1

Фильтрация по состоянию

В качестве параметра фильтрации выступает состояние:

  • не выбрано (платежи в любых состояниях)
  • идентифицированные (платежи в состоянии IDENTIFIED)
  • неизвестные (платежи в состоянии UNKNOWN)
  • необработанные (платежи в состояниях IDENTIFIED и UNKNOWN)
  • обработанные (платежи в состоянии PROCESSED)

Фильтрация по типу

В качестве параметра фильтрации выступает тип платежа - идентификатор обработчика, который принимал запрос.

Фильтрация по времени

В качестве параметра фильтрации выступает время проведения платежа.

Фильтрация по значению в таблице

Отображаются платежи, соответствующие заданному в строке фильтрации шаблону.

С помощью правой кнопки мыши в поле фильтрации по произвольной строке существует возможность выбрать режим фильтрации:

  • Все слова фразы
  • Фраза целиком
  • Хотя бы одно слово фразы

Таблица c платежами

Для отображения платежей, соответствующих параметрам фильтрации следует нажать кнопку Создать. Будет отображена таблица c платежами, содержащая такие параметры платежа как:

  • ID
  • Дата
  • Лицевой счет
  • Имя
  • Сумма
  • Тип
  • Идентификатор
  • Состояние

sys-EP_4e

ID

Идентификатор платежа в базе данных Модуля Интеграции. Идентификатор платежа играет роль индекса платежа. При необходимости передается платежной системе для сверки.

Дата

Момент регистрации платежа в платежной системе. Если платежной системой дата не передается - используется дата регистрации платежа в Модуле Интеграции.

Лицевой счет

Номер лицевого счета в UTM5, на который пришел платеж.

Имя

Имя клиента, которому принадлежит лицевой счет.

Логин

Логин клиента, которому принадлежит лицевой счет.

Сумма

Сумма платежа.

Валюта

Валюта платежа.

Тип

Идентификатор обработчика, которым было обработан запрос.

Идентификатор

Уникальный для данной платежной системы идентификатор платежа, составленный из параметров пришедших в запросе в формате

параметр=<значение>&параметр=<значение>....

Названия параметров заданы в нижнем регистре и отсортированы по алфавиту.

<!> Категорически не рекомендуется изменять значение Идентификатора.

Состояние

Состояние платежа, присвоенное ему после обработки.

{i} Выбор необходимых для отображения параметров платежа осуществляется в пункте Столбцы контекстного меню.

Существует возможность изменять значения некоторых параметров платежей одним из двух способов:

  • выделение параметра и ввод нового значения (для суммы и идентификатора)
  • выделение параметра и выбор нового значения из ниспадающего списка (для даты, лицевого счета, имени, логина и т.д.)

{i} Для того, чтобы в ниспадающем списке присутствовали параметры всех пользователей, занесенных в базу UTM5, следует нажать кнопку Подгрузить Информацию о Клиентах.

Обработанные платежи

При правильной настройке системы платежи должны получать статус обработанные (PROCESSED).

Для просмотра обработанных платежей произведите фильтрацию по состоянию обработанные, задайте с помощью фильтра времени необходимый временной диапазон и нажмите Создать

sys-EP_4e2

Идентифицированные платежи

При невозможности выполнить shell-команду платеж идентифицируется Модулем Интеграции, но его регистрация в системе UTM5 не происходит. Такой платеж получает статус идентифицированный (IDENTIFIED).

Для просмотра идентифицированных платежей произведите фильтрацию по состоянию идентифицированные, задайте с помощью фильтра времени необходимый временной диапазон и нажмите Создать

sys-EP_4h

Попытка регистрации данных платежей в UTM5 и перевода их в состояние PROCESSED (обработанные) производится событием [netup:integration]payment_registration[1.external]. Данное событие вызывается пунктом контекстного меню Попробовать зарегистрировать платеж или в соответствии с настройками планировщика событий. Для попытки регистрации всех идентифицированных платежей выберите пункт контекстного меню Попробовать зарегистрировать все платежи.

{i} По умолчанию событие [netup:integration]payment_registration[1.external] вызывается автоматически в соответствии с планировщиком событий каждые 90 минут. {i} Планирование событий производится во вкладке Запланированные задачи и описывается в соответствующем разделе документации.

Неизвестные платежи

При нарушении бизнес-логики проведения платежа платеж не идентифицируется Модулем Интеграции. Такой платеж получает статус неизвестный (UNKNOWN).

Для просмотра неизвестных платежей произведите фильтрацию по состоянию неизвестные, задайте с помощью фильтра времени необходимый временной диапазон и нажмите Создать

sys-EP_4k

Неидентифицированный платеж при необходимости возможно зарегистрировать, изменив его состояние на IDENTIFIED, и вызвав событие [netup:integration]payment_registration[1.external].

Событие предварительной проверки

Если в бизнес-логике проведения платежа предусмотрена необходимость предварительной проверки, параметры предварительной проверки платежа будут отображены в таблице Событие предварительной проверки.

Пришедшее событие для платежа

Таблица с полученными от платежной системы параметрами платежа.

Предварительно обработанное событие для платежа

Таблица с параметрами платежа, обработанного системой.

Настройка внешних платежных систем

Для просмотра списка всех зарегистрированных внешних платежных систем на панели типичных задач выберите элемент Настройки, затем Внешние платежные системы

sys-EP_5a

Платежные системы

В таблице Платежные системы для каждой платежной системы отобразятся

  • Название
  • URI
  • Комиссионный сбор
  • Состояние
  • Автоматическая служба
  • Событие разбора запроса
  • Описание

URI

По URI происходит идентификация запроса платежной системы.

Комиссионный сбор

Комиссия в процентах, снимаемая с платежа абонента, в пользу платежной системы.

(!) Пример. Абонент внес через платежную систему 100 рублей. Платежная система перевела на баланс провайдера 100 рублей и провела запрос Модулю платежных систем с суммой в 100 рублей. Если комиссионный сбор установлен в 10% - на счет абонента будет перечислено 90 рублей. В дальнейшем провайдер проводит взаиморасчеты с платежными системами.

Состояние

Состояния платежных систем:

  • active - активна, платежи на соответствующий платежной системе URI принимаются
  • blocked - заблокирована, платежи на соответствующий платежной системе URI не принимаются
  • setting_up - настраивается в данный момент, платежи на соответствующий платежной системе URI не принимаются (служит для информации другим администраторам системы о производимой настройке)

Автоматическая служба

Учетная запись подсистемы, от имени которой будут производиться действия.

Событие разбора запроса

Событие разбора запроса, соответствующие платежной системе.

{i} Выбор необходимых для отображения параметров платежной системы осуществляется при выборе пункта Столбцы контекстного меню.

Над платежной системой существует возможность проводить операции:

  • удаления (пункт Удалить платежную систему контекстного меню)

  • добавления (пункт Добавить платежную систему контекстного меню)

Параметры

С помощью панели Параметры для платежной системы существует возможность изменения параметров:

  • Название
  • URI
  • Состояние
  • Комиссионный сбор
  • Описание

sys-EP_5b

Настройки

С помощью панели Настройки для платежной системы существует возможность изменения параметров:

  • Событие разбора запроса
  • Автоматическая служба

sys-EP_5b2

Операции

Соответствуют основным операциям:

  • Проверки возможности внесения платежа
  • Внесения платежа

sys-EP_5c

Над операциями существует возможность проводить:

  • Удаление (пункт Удалить операцию контекстного меню)

  • Редактирование (пункт Редактировать операцию контекстного меню)

При выборе пункта Редактировать операцию контекстного меню вызывается вкладка Редактирование операции.

{i} Вкладка Редактирование операции описывается в разделе Редактирование операции.

{i} На данной вкладке для операции существует возможность выставить два из трех состояний: активна (галочка в колонке Активность поставлена) или неактивна (галочка в колонке Активность не поставлена).

Проверки

Соответствуют техническим операциям (проверкам), используемым парсером запроса для технических нужд:

  • Проверки цифровой подписи
  • Проверки хэш-суммы
  • Проверки входных параметров
  • Проверки адресата
  • Генерации подписи

sys-EP_5c2

Над проверками существует возможность проводить:

  • Удаление (пункт Удалить проверку контекстного меню)

  • Редактирование (пункт Редактировать проверку контекстного меню)

При выборе пункта Редактировать проверку контекстного меню вызывается вкладка Редактирование проверки, полностью аналогичная вкладке Редактирование операции.

{i} На данной вкладке для проверки существует возможность выставить два из трех состояний: активна (галочка в колонке Активность поставлена) или неактивна (галочка в колонке Активность не поставлена).

Существующие по умолчанию наборы активных проверок соответствуют текущей логике взаимодействия с внешней платежной системой.

Настройка операции

<!> Использование данного функционала системы предполагает продвинутый уровень пользователя.

Существуют операции двух типов:

  • Основная операция
  • Техническая операция (проверка)

Параметры

С помощью панели Параметры для операции существует возможность изменения:

  • Названия
  • Состояния
  • Описания

sys-EP_6a

Состояние

Операция может иметь состояния:

  • active - активна, для основных операций запросы данного типа будут обработаны, для технических операций - проверка будет произведена
  • blocked - заблокирована, для основных операций запросы данного типа не будут обработаны, для технических операций - проверка не будет произведена
  • setting up - настраивается в данный момент, для основных операций запросы данного типа не будут обработаны, для технических операций - проверка не будет произведена (служит для информации другим администраторам системы, что производится настройка операции)

Описание

Подробное описание операции/проверки.

Настройки

С помощью панели Настройки для платежной системы существует возможность изменения параметров:

  • Автоматическая служба
  • Событие

sys-EP_6b

Автоматическая служба

Учетная запись подсистемы, от имени которой будут производиться операции/проверки.

Событие

Событие, инициирующее операцию/проверку.

Существуют следующие этапы выполнения операции, которые могут быть настроены администратором системы:

  • SQL-запрос (если задан, выполняется в первую очередь)
  • Shell-команда (если задана, выполняется после SQL-запроса)

SQL-запрос

sys-EP_6c

На панели SQL отображаются существующие данной операции SQL запросы.

В нижней части панели SQL будет отображен общий вид выбранного запроса.

SQL запрос задается согласно ANSI SQL.

(!) Например, запрос заданный в виде

+-----------+--------------+---------+
| Значение  | Переменная   | Условие |
+-----------+--------------+---------+
| event.sum | event.amount |         | 
+-----------+--------------+---------+

Означает, что значение переменной sum присваивается переменной amount.

(!) Например, запрос заданный в виде

+-------------------------+---------------------------+---------------------------+
|        Значение         |        Переменная         |         Условие           |
+-------------------------+---------------------------+---------------------------+
| db.personal_accounts.id | event.personal_account_id | db.personal_accounts.id = |
|                         |                           |       event.account       | 
+-------------------------+---------------------------+---------------------------+

Означает, что значение переменной personal_account_id присваивается значению поля id таблицы personal_accounts из базы данных, если поле id равно значению параметра account, пришедшему в запросе.

Для удаления SQL запроса необходимо выбрать пункт Удалить SQL контекстного меню.

Для создания SQL запроса необходимо задать Значение, Переменную, Условие в пустой строке.

Shell-команда

sys-EP_6c2

На панели Shell-команда отображаются команды, исполняемые оболочкой операционной системы. Команды могут быть составными и определяются согласно правилам оболочки ОС.

В нижней части панели Shell-команда будет отображен общий вид команды.

/!\ Shell-команда должна быть составлена так, чтобы возвращать 0, в случае успешного выполнения, и не 0 во всех остальных случаях.

{i} При подстановке в shell-команду вместо параметра его значения экранируются символы ` и ".

/!\ При необходимости использования в Shell-команде или SQL-запросе значения параметра HTTPS-запроса, следует использовать слово из словаря EVENT (применимо только для словаря EVENT), написание которого полностью совпадает с написанием параметра (без учета заглавных букв). Тогда при выполнении SQL-запроса или Shell-команды EVENT.<название параметра> заменяется на <значение параметра>, если такое возможно. Если такое не возможно - произойдет интерпретация стандартным образом, т.е. как <название параметра>.

Управление ролями

Для просмотра списка зарегистрированных в системе ролей на панели типичных задач выберите элемент Система, затем Роли.

sys-EP_10a

Над ролями существует возможность проводить операции:

  • Добавления
  • Редактирования
  • Удаления

Управление событиями

Для просмотра списка событий и ролей, способных вызывать эти события на панели типичных задач выберите элемент Система, затем События.

sys-EP_11a

Для событий существует возможность назначать роли, способные вызывать события.

Управление запланированными задачами

Для просмотра перечня запланированных событий выберите в списке типичных задач элемент Система, Запланированные задачи.

sys-EP_7a

Будут отображены события, запуск которых планируется, а так же дата последнего запуска события и периодичность запуска события.

По умолчанию единственным запланированным событием в системе является событие netup:integration:payment_registration:1.external, которое производит попытку перевода платежа из состояния IDENTIFIED в состояние PROCESSED.

С помощью контекстного меню можно добавлять, удалять, редактировать запланированные события. При редактировании события имеется возможность выбрать нужное событие из общего списка событий системы, периодичность запуска, названия, типы и значения передаваемых параметров.

sys-EP_7b

Управление персоналом

Служба - учетная запись подсистемы. Для просмотра перечня зарегистрированных в системе автоматических служб выберите в списке типичных задач элемент Система, Персонал.

sys-EP_8a

(!) Каждый установленный дополнительный модуль платежной системы добавляет собственную службу. Например, модуль платежной системы e-port добавляет Службу e-port.

Будет отображен список логинов и имен автоматических служб системы. Существует возможность добавления, удаления и редактирования автоматических служб.

Над учетными записями существует возможность проводить операции:

  • Добавления (пункт Добавить контекстного меню)

  • Редактирования (пункт Редактировать контекстного меню)

  • Удаления (пункт Удалить контекстного меню)

При добавлении указываются логин, пароль, имя службы.

При редактировании изменяются пароль, имя службы.

sys-EP_8b

{i} В текущей версии Модуля интеграции параметры Адрес сервера и Порт сервера не используются.

Текущие соединения

Для просмотра текущих соединений на панели типичных задач выберите элемент Система, затем Текущие соединения.

sys-EP_13a

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

Бином

Сайт системы: http://www.elecsnet.ru/

Для системы Бином поддерживаются параметры:

Таблица 1. 

параметр

возможные значения

описание

Action

Auth

запрос на внесение платежа

Pre

запрос на проверку возможности внесения платежа

Timestamp

yyyymmddhhmmss

дата и время платежа (дата и время получения запроса от клиента)

Client

строка

идентификатор абонента

Key

число (128 hex)

уникальный идентификатор платежа в системе Бином

Sum

число (dec)

сумма платежа в копейках

Stan

число

номер транзакции в процессинге системы Бином

Cheque

число

номер чека

Sign

строка (512 hex)

АСП банка (на данный момент системой Бином не поддерживается)


Код валюты платежа 810.

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

https://zao.ru:8080/binom?action=pre&key=705591aba85a60acc2179df3d42a7717&stan=XXXXXX&client=2821&sum=20000&
timestamp=20061201121059&term=5577&cheque=87654321&sign=28162ff1459e0eaa7402c37aacdf0900fc0116e3f2ac34eafb262438c0d2
78eb185bb464807f09290aa3c87cf5cbd5c11930049b0489e03a3ce933e62201525a20cf4ea59bb1072ef9e05f9eb26da1c0545edf86991215c7196eb55d1e92
a646b9986a8ce4c64c467b0f452fc6d6fab129dcdf71c911ffd0508a025e0540aad9d68ca253ef2aeae0f2369a8e2ca46571afc5f49c0766f3a741d88d4d6a9e
08e662e2669efff06871bed79f4dbde048ad0e7e2b4b16747410fa9a69014b1e1327578b662a62d57f830bf25654808916d65315b2f33dffdd94020136c4f216
f646863727ac5784d9f80111c384b814dcb297165644b02a638b13d9a63aa4fcc53a

https://zao.ru:8080/binom?action=auth&key=68b329da9893e34099c7d8ad5cb9c940&stan=121212&client=2821&sum=20000&
timestamp=20061201121059&term=5577&cheque=87654321&sign=9d1f673b5c7e065ebea1e7e2dce2ebc453025798755a5a47d42b3f3a0fbe9
46335ac48ed8e7f78307059c0b3e5a006ff2ad81b30c03dbb667e52286f4ecc3123cfecb1602d93164df3b7253f6ebffd0fddcff3d9f8fa5ccce3a217767ac450
9e367e2e634ffd7e2064d7de9375bd086db0c6ac25aadd35f9e0234550e1f659f784bd38fbb0a775a14e26c50166189e08e5285927d1845a0848fa1134b4d2447
424d4de2182a1a326c93c23c6c8f1048d7a02112fc9e26998efb306fdadc25490117986d52299f14bbc55cd1f2dd62b9a46005786facd11f9717934d11721c620
cf0e9e2ccb635c6226f4127fb39f052606dd157a9672de4670f2e387cccdead0

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

Кредит-Пилот

Cайт системы: http://www.kp-dealer.ru/

Для системы Кредит-Пилот поддерживаются параметры:

Таблица 2. 

параметр

возможные значения

описание

command

getabstateacc

запрос на проверку возможности внесения платежа

addtobalanceacc

запрос на внесение платежа

bankid

число

идентификатор организиции

devid

число

идентификатор терминала

qid

число

идентификатор запроса

abacc

число

лицевой счет

crcid

число

тип валюты

sum

число

начисляемая сумма


Код валюты платежа 810.

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

https://zao.ru:8080/credit_pilot?command=getabstateacc&bankid=1234&devid=1&qid=34342324&abacc=1234567

https://zao.ru:8080/credit_pilot?command=addtobalanceacc&bankid=1235&devid=1&qid=34342324&abacc=1234567&crcid=810sum=300

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

Киберплат

Сайт системы: http://www.cyberplat.ru/

Для системы Киберплат поддерживаются параметры:

Таблица 3. 

параметр

возможные значения

описание

action

check

проверка возможности проведения платежа в биллинговой системе провайдера услуг по уникальному идентификатору абонента и сумме платежа (поиск абонента, проверка номера)

payment

запрос на внесение платежа

number

строка, до 30 символов

номер абонента. Тип этого поля может быть уточнен при интеграции платежной системы и Провайдера услуг

type

целое число

тип платежа задаёт тип поля number

amount

число до 10 знаков, денежный формат NNNNNN.NN

сумма платежа в рублях с копейками. Разделитель ‘.’ (точка)

receipt

целое число до 15 знаков

уникальный номер платежа, сформированный платежной системой (номер транзакции)

date

YYYY-MM-DDThh:mm:ss

дата и время операции по часовому поясу платежной системы

additional

строка

опциональное поле. Данные, передаваемые в этом параметре, формируются дилерским ПО и не проходят предварительной проверки на стороне платежной системы. Наличие этого параметра и форматы передаваемых в нём данных должны отдельно согласовываться с Киберплат


Код валюты платежа 810.

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

https://zao.ru:8080/cyberplat?action=check&number=9166438476&type=1&amount=25.34

https://zao.ru:8080/cyberplat?action=payment&number=9166438476&amount=25.34&receipt=3568264&date=2005-09-20T15:53:00

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

ОСМП

Сайт системы: http://www.osmp.ru

Для системы ОСМП поддерживаются параметры:

Таблица 4. 

параметр

возможные значения

описание

command

pay

запрос на внесение платежа

check

запрос на проверку возможности внесения платежа

txn_date

ГГГГММДДЧЧММСС

дата и время платежа (дата и время получения запроса от клиента)

txn_id

integer dec до 20 знаков

уникальный идентификатор платежа в системе ОСМП

account

string до 200 знаков

идентификатор абонента

sum

денежный формат NNNNNN.NN

сумма платежа


Код валюты платежа 810.

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

https://zao.ru:8080/osmp?command=check&txn_id=1234567&account=0957835959&sum=10.45

https://zao.ru:8080/osmp?command=pay&txn_id=1234567&txn_date=20050815120133&account=0957835959&sum=10.45

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

Уникасса

Сайт системы: http://www.unikassa.ru/

Для системы Уникасса поддерживаются параметры:

Таблица 5. 

параметр

возможные значения

описание

duser

строка 64 символа

идентификатор провайдера

dpass

строка 128 символа

секретное слово провайдера

sid

строка 64 символа

идентификатор типа услуги

cid

строка 64 символа

идентификатор клиента

uact

get_info

запрос на проверку возможности внесения платежа

payment

запрос на внесение платежа

Term

строка

идентификатор пункта приема платежа

Trans

строка

идентификатор транзакции в системе Уникасса (вместе с параметром Term играет роль уникального идентификатора платежа в системе Уникасса)

Sum

денежный формат NNNNNN.NN

сумма платежа


Код валюты платежа 810.

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

https://zao.ru:8080/unikassa?duser=dealer1&dpass=1dad01d23ads4567&cid=123123123&uact=get_info

https://zao.ru:8080/unikassa?duser=dealer1&dpass=1dad01d23ads4567&cid=123123123&uact=payment&term=10&trans=12345&sum=123.00

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

Яндекс.Деньги

Сайт системы: http://money.yandex.ru/

Для системы Yandex.Деньги поддерживаются параметры:

Таблица 6. 

параметр

возможные значения

описание

action

paymentSuccess

запрос на внесение платежа

Check

запрос на проверку возможности внесения платежа

paymentFailed

уведомление об отказе от платежа

orderCreatedDatetime

YYYY-MM-DDThh:mm:ss.fZZZZZ

дата и время платежа (дата и время получения запроса от клиента)

customerNumber

строка до 64 символов

уникальный идентификатор абонента

orderNumber

строка

уникальный идентификатор платежа в системе Yandex.Деньги

orderSumAmount

денежный формат NNNNNN.NN

сумма платежа

orderSumCurrencyPaycash

число

код валюты

orderIsPaid

1

абонент оплатил (модулем интеграции не используется)

!=1

абонент не оплатил(модулем интеграции не используется)

orderSumBankPaycash

строка

код банка

pgpSignature

строка

контрольная PGP-подпись

md5

строка

контрольная md5 сумма

requestDatetime

YYYY-MM-DDThh:mm:ss.fZZZZZ

момент формирования запроса в системе Яндекс.Деньги (модулем интеграции не используется)

shopId

строка

идентификатор провайдера

shopSumAmount

число

сумма без комиссии (модулем интеграции не используется)

shopSumCurrencyPaycash

число

код валюты в shopSumAmount

shopSumBankPaycash

число

код процессингового центра

paymentPayerCode

число

номер кошелька абонента

paymentDatetime

YYYY-MM-DDThh:mm:ss.fZZZZZ

время регистрации оплаты (модулем интеграции не используется)

paymentType

строка

тип платежа по классификации Яндекс.Деньги


Код валюты платежа 810.

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

https://zao.ru:8080/yandex_money?requestDatetime=2007-01-21T10:20:06Z&action=Check&md5=8256D2A032A35709EAF156270C9EFE2E&
shopId=13&orderNumber=55&customerNumber=8123294469&orderCreatedDatetime=2007-01-21T10:20:04Z&orderSumAmount=87.10&
orderSumCurrencyPaycash=643&orderSumBankPaycash=1001&shopSumAmount=86.23&shopSumCurrencyPaycash=643&shopSumBankPaycash
=1001&paymentType=1&paymentPayerCode=42007148320&orderIsPaid=0&md5=&pgpSignature=&MyField=Добавленное магазином поле

https://zao.ru:8080/yandex_money?requestDatetime=2007-01-21T10:20:10Z&action=PaymentSuccess&md5=45125C95A20A7F25B63D58EA34AFED
2&shopId=13&orderNumber=55&customerNumber=8123294469&orderCreatedDatetime=2007-01-21T10:20:04Z&orderSumAmount=87.10&
orderSumCurrencyPaycash=643&orderSumBankPaycash=1001&shopSumAmount=86.23&shopSumCurrencyPaycash=643&shopSumBankP
aycash=1001&orderIsPaid=1&paymentDatetime=2005-01-21T10:20:10Z&paymentType=PC&paymentPayerCode=42007148320&md5=&
pgpSignature=&MyField=Добавленное магазином поле

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

e-port

Сайт системы: http://e-port.ru

Для системы e-port поддерживаются параметры:

Таблица 7. 

параметр

возможные значения

описание

type

1

запрос на внесение платежа

2

запрос на проверку возможности внесения платежа

3

запрос на аннулирование сделки (модулем интеграции не поддерживается)

4

запрос на коррекцию сделки (модулем интеграции не поддерживается)

id

Число (целое не нулевое)

уникальный идентификатор платежа в системе e-port

date

DD.MM.YY HH:MM:SS

дата и время платежа (дата и время получения запроса от клиента)

account

строка

идентификатор абонента

sum

денежный формат NNNNNN.NN

сумма платежа

sign

число (hex)

RSA MD5 подпись запроса

hash

число

хэш-сумма параметров запроса (модулем интеграции не используется)

testMode

0

идентификатор тестового внесения платежа

1

идентификатор внесения платежа


Код валюты платежа 810

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

https://zao.ru:8080/eport?account=1234%20567&date=21.10.03%2016%3A07%3A14&hash=5237893&id=30275&sum=234.56&type=1&
sign=2BA555F3746588078D99419B2FB52E0303BB87F1EF9D8943CE02D8A2B8D8EFF3AA9899C80D537625E9000A2123AAEFCE8D68ADFC836823C7847203C635521E02D4F4C
681CE65AD4AF3C14FE7D55EB2CCEB4DD2B17C15F922ECFE850E23A85FCE81EFABC845B3E7B2EAB98DA2DF03125F6097FCD9E3B8350726D453750303499F

https://zao.ru:8080/eport?account=1234%20567&date=21.10.03%2016%3A07%3A14&sum=234.56&type=2&sign=3C5A0FBFD8443512B1B334003
6040F46BC0BB848D88A19345A52AA9A25CFE79C58FC480BABD2A08067D1911CE5FEDCA9D5C75AE4C6C0B3D1D0040E47146ACD75120FA298ADC9B343AA6C54D24E3AB0E2DFA
DE07F810F0780986B5C03BB4BAD9BA2763FB528DE2F6800CA1150213DCA53AA3CBCFDD4DA7783AFB79BB22ED0C300

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

Rapida

Сайт системы: http://www.rapida.ru

Для системы Rapida поддерживаются параметры

Таблица 8. 

параметр

возможные значения

описание

type

2

запрос на внесение платежа

1

запрос на проверку возможности внесения платежа

order

число (int)

уникальный идентификатор платежа в системе Rapida

sum

денежный формат NNNNNN.NN

сумма платежа

id

строка

идентификатор абонента


Код валюты платежа 810.

Пример запроса:

https://zao.ru:8080/rapida?order=123456&sum=100.00&id=ХХХХХХХ&type=1

https://zao.ru:8080/rapida?order=123456&sum=100.00&id=ХХХХХХХ&type=2

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

Web Money

Сайт системы: http://www.webmoney.ru/

Для системы WebMoney поддерживаются параметры:

Таблица 9. 

параметр

возможные значения

описание

LMI_PREREQUEST

1

запрос на проверку возможности внесения платежа

!=1 или отсутствует

запрос на внесение платежа

LMI_PAYEE_PURSE

буквы и 15 цифр

кошелек провайдера, на который абонент совершает платеж

LMI_PAYMENT_AMOUNT

денежный формат NNNNNN.NN

сумма платежа

LMI_PAYMENT_NO

строка

уникальный идентификатор платежа в системе WebMoney

LMI_MODE

1

запрос на тестовое внесение платежа

!=1 или отсутствует

запрос на внесение платежа

LMI_PAYER_WM

строка

идентификатор абонента в системе WebMoney (модулем интеграции не используется)

LMI_PAYMER_NUMBER

строка

номер ВМ-карты (модулем интеграции не используется)

LMI_PAYMER_EMAIL

число

e-mail абонента(модулем интеграции не используется)

LMI_TELEPAT_PHONENUMBER

число

номер телефона абонента (модулем интеграции не используется)

LMI_SYS_TRANS_DATE

YYYYMMDD HH:MM:SS

дата и время платежа (дата и время получения запроса от клиента)

LMI_SYS_INVS_NO

строка

номер лицевого счета абонента в системе WebMoney (модулем интеграции не используется)

LMI_SYS_TRANS_NO

строка

уникальный идентификатор платежа в системе WebMoney

LMI_PAYER_PURSE

буквы и 15 цифр

кошелек абонента с которого совершен платеж

LMI_HASH

строка

контрольная md5-сумма параметров запроса

LMI_SECRET_KEY

строка

ключ магазина

account

строка

номер лицевого счета абонента в UTM5


Код валюты платежа 810.

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

https://zao.ru:8080/web_money?LMI_PREREQUEST=1&LMI_PAYMENT_AMOUNT=1.0&LMI_PAYMENT_NO=1&LMI_PAYEE_PURSE=R397656178472&
LMI_MODE=1&LMI_PAYER_WM=809399319852&FIELD_1=VALUE_1&FIELD_2=VALUE_2&FIELD_N=VALUE_N&account=123

https://zao.ru:8080/web_money?LMI_PAYMENT_AMOUNT=1.0&LMI_PAYMENT_NO=1&LMI_PAYEE_PURSE=R397656178472&LMI_MODE=1&LMI_SY
S_INVS_NO=281&LMI_SYS_TRANS_NO=558&LMI_PAYER_PURSE=R397656178472&LMI_PAYER_WM=809399319852&LMI_SYS_TRANS_DATE=2002031
4 14:01:14&LMI_HASH=114128B8AEFD8CAA76D3CF75B9AEBC17&FIELD_1=VALUE_1&FIELD_2=VALUE_2&FIELD_N=VALUE_N&account=123

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

Z-PAY

Сайт системы: http://www.z-pay.ru

Для системы Z-PAY поддерживаются параметры:

Таблица 10. 

параметр

возможные значения

описание

LMI_PREREQUEST

1

запрос на проверку возможности внесения платежа

!=1 или отсутствует

запрос на внесение платежа

LMI_PAYEE_PURSE

буквы и 15 цифр

идентификатор магазина в системе Z-PAY, на который абонент совершает платеж

LMI_PAYMENT_AMOUNT

денежный формат NNNNNN.NN

сумма платежа

LMI_PAYMENT_NO

строка

уникальный идентификатор платежа в системе Z-PAY

LMI_MODE

1

запрос на тестовое внесение платежа

!=1 или отсутствует

запрос на внесение платежа

LMI_PAYER_WM

строка

идентификатор абонента в системе Z-PAY (модулем интеграции не используется)

LMI_PAYMER_NUMBER

строка

номер карты (модулем интеграции не используется)

LMI_PAYMER_EMAIL

число

e-mail абонента(модулем интеграции не используется)

LMI_TELEPAT_PHONENUMBER

число

номер телефона абонента (модулем интеграции не используется)

LMI_SYS_TRANS_DATE

YYYYMMDD HH:MM:SS

дата и время платежа (дата и время получения запроса от клиента)

LMI_SYS_INVS_NO

строка

номер лицевого счета абонента в системе Z-PAY (модулем интеграции не используется)

LMI_SYS_TRANS_NO

строка

уникальный идентификатор платежа в системе Z-PAY

LMI_PAYER_PURSE

буквы и 15 цифр

кошелек абонента с которого совершен платеж

LMI_HASH

строка

контрольная md5-сумма параметров запроса

LMI_SECRET_KEY

строка

ключ магазина

account

строка

номер лицевого счета абонента в UTM5

DESC_PAY

строка

назначение платежа. Описание товара или услуги. Формируется продавцом

ID_PAY

строка

внутренний номер счета в системе Z-PAY. Номер счета в системе Z_PAY, выставленный покупателю от магазина в процессе обработки запроса на выполнение платежа

CLIENT_MAIL

строка

e-mail клиента


Код валюты платежа 810.

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

https://zao.ru:8080/z_pay?LMI_PREREQUEST=1&LMI_PAYMENT_AMOUNT=1.0&LMI_PAYMENT_NO=1&LMI_PAYEE_PURSE=R397656178472&LMI_
MODE=1&LMI_PAYER_WM=809399319852&FIELD_1=VALUE_1&FIELD_2=VALUE_2&FIELD_N=VALUE_N&account=123

https://zao.ru:8080/z_pay?LMI_PAYMENT_AMOUNT=1.0&LMI_PAYMENT_NO=1&LMI_PAYEE_PURSE=R397656178472&LMI_MODE=1&LMI_SYS_IN
VS_NO=281&LMI_SYS_TRANS_NO=558&LMI_PAYER_PURSE=R397656178472&LMI_PAYER_WM=809399319852&LMI_SYS_TRANS_DATE=20020314 14
:01:14&LMI_HASH=114128B8AEFD8CAA76D3CF75B9AEBC17&FIELD_1=VALUE_1&FIELD_2=VALUE_2&FIELD_N=VALUE_N&account=123

(!) За более подробной информацией обратитесь к документации и технической части договора с платежной системой.

© 2003-2006 NetUP Inc. All Rights reserved.
Тел: +7 (495) 543-9220 (многоканальный)
+7 (495) 510-1025 (многоканальный)
info@netup.ru