Untitled Document

Описание интерфейса для автоматизированной работы с системой мониторинга платежей

1. Описание метода отправки
2. Описание XML документа для подтверждения/аннулирования платежа и ответа сервера
3. Описание XML ответ в случае ошибки

4.Запрос получения статуса платежа

Описание метода отправки

Запросы на все сервисы приходят методом GET без "упаковки" в параметр
на адрес https://3dsecure.kkb.kz/jsp/remote/control.jsp

Например запрос на получение выписки выглядит следующим образом:
https://3dsecure.kkb.kz/jsp/remote/control.jsp?<xml>....</xml>

Вместо <xml>....</xml> ставится сформированный XML, описанный ниже

Если запрос отправляете методом "GET" то нужно обязательно кодировать в URLEncode

Сервер в ответ на запрос возвращает XML-ответ.

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

== Описание XML-запроса подтверждения-анулирования авторизации

<document>
<merchant id="90002102">
// id - ID продавца в платежной системе
<command type="reverse"/>
// type - команда имеет 3 значения: reverse || complete || refund
// complete - для подтверждения платежа
// reverse - для аннулирования платежа
// refund - для возврата платежа
<payment reference="" approval_code="" orderid="" amount="" currency_code=""/>
// reference - номер обращения к платежной системе
// approval_code - код авторизации
// orderid - Номер заказа(должен состоять только из чисел)
// amount - сумма проведенной транзакции
// currency_code - код валюты оплаты [ 398 - тенге ]
<reason>Only for reverse</reason>
// Данный элемент необходим только при осуществлении аннулирования платежа
</merchant>
<merchant_sign type="RSA" cert_id="214321321321321321">
// cert_id - Серийный номер сертификата
// type - Тип подписи

p25i1rUH7StnhOfnkHSOHguuPMePaGXtiPGEOrJE4bof1gFVH19mhDyHjfWa6OeJ80fidyvVf1X4
ewyP0yG4GxJSl0VyXz7+PNLsbs1lJe42d1fixvozhJSSYN6fAxMN8hhDht6S81YK3GbDTE7GH498
pU9HGuGAoDVjB+NtrHk=

</merchant_sign>
</document>

== Описание XML-ответа сервера

== Запрос возврата для списанной суммы ( refund)

<document>
<bank name="Halyk Saving Bank JSC">
// name - наименование банка
<merchant id="90002102">
<command type="reverse"/>
<payment reference="" approval_code="" orderid="" amount="" currency_code=""/>
<reason>Only for reverse</reason>
</merchant>
<merchant_sign type="RSA" cert_id="">
AGKJHSGHGIYTEG&DT*STT&IGHGFLKJHSGLKJHMNBFLKRSJHSKJFHKJHfldsflkjskksldjfl
</merchant_sign>
<response code="00" message="Refund" residue="10.0" >
// code - код результата авторизации.
// Должен иметь значение "00" (два нуля), в противном случае свяжитесь, пожалуйста,
// с администратором системы авторизации
// message - расшифровка
// residue - остаток
</bank>
<bank_sign type="RSA" cert_id="">
// cert_id - Серийный номер сертификата, name - имя магазина(сайта)
// type - Тип подписи

p25i1rUH7StnhOfnkHSOHguuPMePaGXtiPGEOrJE4bof1gFVH19mhDyHjfWa6OeJ80fidyvVf1X4
ewyP0yG4GxJSl0VyXz7+PNLsbs1lJe42d1fixvozhJSSYN6fAxMN8hhDht6S81YK3GbDTE7GH498
pU9HGuGAoDVjB+NtrHk=

</bank_sign>
</document>

Если сумма уже списана, и ее нужно вернуть, то отправляется запрос на refund.
Если деньги стоят в блоке и их нужно вернуть, то нужно отправить запрос reverse для разблокировки .

Возврат (refund) можно осуществить в пределах года или в пределах действия карты!
Подтверждение или Реверс авторизации необходимо осуществить не опзднее 30 дней, позже сумма может быть потеряна.