Шлюзы внешних терминалов

Внешним терминалам наша система предлагает использование нескольких вариантов шлюзов, в зависимости от типа операций:

- Пополнение счета пользователя в нашей платежной системе
- Возможность приема платежей в терминалах "в режиме оплата выставленного счета"
- Прием платежей в адрес любых поставщиков услуг, подключенных к нашей платежной системе
Во всех случаях интерфейс должен принимать и отправлять запросы по протоколу HTTPS со следующих, либо на следующие IPадреса:

85.17.209.38
92.241.172.45
92.241.173.45
82.146.40.216
82.146.40.250

Система предусматривает в качестве способа авторизации внешних терминалов при обращении к нашим серверам электронный цифровой сертификат.

Пополнение счета пользователя в системе "Delta Key"

Терминалы, работающие в полном ON-LINE при пополнении счета пользователя в нашей системе могут сформировать и отправить предварительный запрос на проведение платежа, терминалы, работающие в режиме OFF-LINE могут отправлять запрос на проведение платежа без предварительного запроса.

Оба запроса посылаются методом GET и содержат в себе:

command = check (запрос на проверку)
command = pay (запрос на оплату)
transact = 12345 (целое число не более 19 символов, уникальный номер транзакции в вашей системе учета)
in_date = 20060314121732 (дата и время в формате ГГГГММДДЧЧММСС)
account = 810000000000000 (номер счета пользователя в нашей системе)
sum = 115.00 (сумма платежа)

В запросе на проверку дата не передается.

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

https://pay.deltakey.net/test_add.py?command=check&transact=123545&account=810700000000000&sum=110.45

Наш ответ на запрос проверки:

<?xml version="1.0" encoding="UTF-8"?> <response> <transact>12345</transact> <result>0</result> </response> result=0 означает, что указанный в запросе с номером transacts, платеж может быть проведен на сумму, указанную в запросе. После успешной проверки состояния, вы можете перейти к отправке запроса на проведение платежа.

Пример запроса на платеж:

https://pay.deltakey.net/test_add.py?command=pay&transact=1235&&in_date=20060314121732&account=810700000000000&sum=110.45

Наш ответ:

<?xml version="1.0" encoding="UTF-8"?>
<response>
<transact>12345</transact>
<ext_transact>67890</ext_transact>
<sum>110.15</sum>
<result>0</result>
<comment>OK</comment>
</response>
где:

ext_transact = номер транзакции в нашей учетной системе.
result = код результата завершения.
comment = необязательное поле комментария.

summ - дробное число с точностью до сотых, в качестве разделителя используется <.> (точка). Если сумма представляет целое число, то оно все равно дополняется точкой и нулями, например - <100.00>

Результаты завершения:

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

0 - ОК, платеж возможен
18 - Отказ (прием данного платежа запрещен)
19 - Не прошел фин.контроль (слишком мала или велика сумма платежа)
22 - Неверные параметры платежа
30 - Неизвестная (другая) ошибка
73 - Временные технические проблемы, повторите позже

Результаты с номерами: 19 и 73 не являются фатальными и запрос будет проведен вновь через некоторое время.

Для тестирования шлюза вы можете использовать демонстрационный электронный цифровой сертификат и специальный URL-адрес, выделенный для тестирования:

host = pay.deltakey.net
port = 443
url = "/test_add.py"

Тестовый сертификат для шлюза по пополнению баланса (PKCS12, PEM, KEY)
Пароль к тестовому сертификату: 11111

Данные для тестов:

При запросе на проверку:

Запрос по account = 810000000000001 или account = 810000000000152 вернет result=0 (успешно)
Запрос по account = 810000000000312 или account = 810000000000316 вернут result=18 (запрещен)
Запрос по account, начинающийся не на "810" вернет result=22 (неверный номер)

При запросе на оплату:

account = 810000000000312 или account = 810000000000316 вернут result=18 (запрещен)
account = 810000000000001 или account = 810000000000152 вернут result=0 (успешно)
account, начинающийся не на "810" вернет result=22 (неверный номер)
Cумма меньше 10 и больше 100 000 вернет result = 19

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

Прием платежей в режиме "Оплата выставленного счета"

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

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

В случае проверки в систему передается запрос:

https://pay.deltakey.net/test_invoice.py?command=check&transact=123545&invoice=33&sum=110.45

При платеже передается: https://pay.deltakey.net/test_invoice.py?command=pay&transact=123545&in_date=20060314121732&invoice=33&sum=110.45

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

invoice = номер выставленного счета, целое число, до 19 символов, введенное плательщиком в терминале. Регулярные выражения у поля (кроме того, что поле содержит цифры) отсутствуют.

Для тестирования шлюза вы можете использовать демонстрационный электронный цифровой сертификат и специальный URL-адрес, выделенный для тестирования:

host = pay.deltakey.net
port = 443
url = "/test_invoice.py"

(https://pay.deltakey.net/test_invoice.py)

Тестовый сертификат для шлюза в режиме "оплата выставленного счета)
Пароль к тестовому сертификату: 11111

Данные для тестов:

При запросе на проверку:

Запрос по invoice > 1000000 вернет result=18
Запрос по invoice = 13 или 14 или 15 или 16 вернут result=0 (успешно)

При запросе на оплату:

invoice = 10
invoice = 11
invoice = 12

должны вернуть result=18.

invoice = 13
invoice = 14
invoice = 15
invoice = 16 - вернут 0 (успешно)
invoice < 10 вернут result = 22
Сумма меньше 10 и больше 100 000 вернет result = 19

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

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

Для приема платежей в адрес любых поставщиков услуг, подключенных к нашей системе необходимо использовать справочник поставщиков. Так как данные быстро устаревают, получить самый последний XML-справочник можно с использованием программы "Система управления транзакциями", зарегистрировашись в ней в качестве внешнего терминала моментальной оплаты.

После этого Вам станут доступными функции, которые позволят настроить подключение вашей терминальной сети и получать последние справочники операторов.

Вернуться назад