1.2Получение разрешения на платеж (запрос на проверку номера телефона) Путь:
https://HOST/cgi-bin/KK/KK_pay_check.cgi
здесь: HOST – адрес сервера; KK – идентификатор оператора услуг.
Запрос:
SD=XXX – код дилера;
AP=XXX – код точки приема;
OP=XXX – код оператора;
SESSION=XXXXXXXXXXXXXXXXXXXX – уникальный идентификатор сессии для данной точки приема. Не более 20 символов, X –латинская буква, либо цифра. Используется для объединения нескольких последовательных запросов различного типа в рамках одной транзакции;
NUMBER=XXXXXXXXXX – номер счёта (или номер телефона) абонента (X – цифра);
ACCOUNT=SSSSSS – номер лицевого счета плательщика (для мобильных операторов пустой);
AMOUNT=XXX.XX – сумма к зачислению (разделитель – точка);
AMOUNT_ALL=XXX.XX – полная сумма, полученная от плательщика (разделитель – точка);
REQ_TYPE=1 – признак того, что производится проверка номера без дальнейшего проведения платежа. Рекомендуется использовать для фиктивных проверок номера терминалами (когда сумма платежа еще неизвестна)
PAY_TOOL=X – тип оплаты (0 – наличный, 1 – по банковской карте)
TERM_ID=XXXXX – фактический код точки, отправившей платеж. Используется только агрегаторами для платежей в Билайн.
COMMENT= SSSSSS – комментарий, назначение платежа: только буквы, цифры и пробелы до 64 символов.
Перечисленные выше поля являются обязательными для заполнения, кроме REQ_TYPE, PAY_TOOL, TERM_ID и COMMENT.
Пример запроса на получение разрешения на платёж. АСП сформирована ключом ipriv 512бит
0000035401SM000000970000009700000121
api99 00000990
00000000
BEGIN
SD=199
AP=72
OP=990
SESSION=56567567100010000000
NUMBER=9998887766
ACCOUNT=
AMOUNT=500.00
PAY_TOOL=0
TERM_ID=12345
COMMENT=test END
BEGIN SIGNATURE
iQBRAwkBAAAD3j2r2NwBAeevAf4nvAG4rGAyAePHkyVKTt7wffzURhOckd3ctgmG
yQkKWkXh3CLpsbrExsllVUBlO6ih8qHozk2uttXApzHXQXoO
=+pch
END SIGNATURE
Ответ:
DATE=DD.MM.YYYY HH:MM:SS – дата и время запроса на оплату;
SESSION= XXXXXXXXXXXXXXXXXXXX – уникальный идентификатор сессии, см. выше описание формата запроса;
ERROR=X – код ошибки;
RESULT=X (0 – успех, 1 – ошибка);
OPNAME =SSSSSSSSSSSSSSSSSSSS – название Провайдера услуг или домашнего оператора, которому принадлежит телефонный номер (не более 20 символов);
ACCOUNT=XXXXXXXXXX – номер лицевого счета абонента;
ERRMSG=SSSSSSSSSSSSSSSSSSSSSSS – расшифровка ошибки (пусто в случае удачного платежа);
OPNAME – название домашнего оператора, которому принадлежит телефонный номер (не более 20 символов),
ACCOUNT – номер лицевого счета абонента;
AUTHCODE=XXXXX – код авторизации у провайдера услуг;
TRANSID=XXXXX – уникальный идентификатор платежа в КиберПлат;
ADDINFO=ХХХХХ – информационное сообщение для плательщика, текст в URL-кодировке. Сообщение, передаваемое в поле ADDINFO, должно выводиться на экран клиентского приложения до отправки запроса на оплату.
Поля OPNAME, ACCOUNT, ERRMSG, AUTHCODE и ADDINFO опциональны и могут не передаваться. Дополнительная информация по использованию опциональных полей в ответах сервера публикуется на странице онлайн-справки по шлюзам.
Если RESULT=0 и ERROR=0 – можно проводить запрос на оплату (шаг 2). При отсутствии ошибки некоторые шлюзы могут оставлять поле ERROR незаполненным. В таких случаях ответ с RESULT=0 и ERROR= (пустая строка) означает успешный результат проверки номера так же, как и ответ с RESULT=0 и ERROR=0.
Пример ответа сервера с разрешением на платёж. АСП сформирована ключом ipriv 512бит
0000030301SM000000460000004600000121
0J0005 00064182
00000000
BEGIN
DATE=04.07.2002 12:34:12
SESSION=56567567100010000000
ERROR=0
RESULT=0
OPNAME =ОАО МТС Москва
ACCOUNT=3335566
ERRMSG= END
BEGIN SIGNATURE
iQBRAwkBAAD6tj1BJ10BAYKxAfsHlQsEFnO2k6ry++W8O8AiJuv4gT+ZVCfZHsKk
c0CbZpP/W3vkljG3xNzMLiqjbwkNuIdwR9Dq7gHmH+ZQMhbT
=LOnP
END SIGNATURE
|