|
1. Описание метода отправки
2. Описание XML документа для получения статуса платежа и ответа
сервера
3. Описание XML ответа в случае ошибки
4. Описание XML документа для подтверждения/аннулирования платежа
и ответа сервера
Запросы на все сервисы приходят методом GET без "упаковки" в параметр
на адрес https://3dsecure.kkb.kz/jsp/remote/checkOrdern.jsp
Например запрос на получение выписки выглядит следующим образом:
https://3dsecure.kkb.kz/jsp/remote/checkOrdern.jsp?<xml>....</xml>
Вместо <xml>....</xml> ставится сформированный XML, описанный ниже
Сервер в ответ на запрос возвращает XML-ответ.
== Описание XML-запроса
<document>
<merchant id="90002102">
// id - ID продавца в платежной системе
<order id=""/>
// id - Номер заказа(должен состоять только из чисел)
</merchant>
<merchant_sign type="RSA" cert_id="">
AGKJHSGHGIYTEG&DT*STT&IGHGFLKJHSGLKJHMNBFLKRSJHSKJFHKJHfldsflkjskksldjfl
</merchant_sign>
</document>
== Описание XML-ответа сервера
<document>
<bank name="Halyk Saving Bank JSC" callcenter="87272585444">
// name - наименование банка
// callcenter - коллцентр банка
<merchant id="90002102">
<order id="" amount="" currency=""/>
</merchant>
<response payment="true" status="0" result="0"
amount="" timestamp="" reference="" cardhash="" approval_code=""
/>
// состояние платежа:
// платеж отменен
// payment= false
// status = 2
// result = любое
// платеж проведен
// payment= true
// status = 2
// result = 0
// платеж новый ожидает
// payment= true
// status = 0
// result = 0
// нестандартный случай
// payment= false
// status = Х неизвестно AcceptRejectCode
// result = Х неизвестно ResultCode
// запрос не дошел / такой ордер не найден
// payment= false
// status = 7
// result = 7
// запрос дошел , оплаты небыло
// payment= false
// status = 8
// result = 8
// системная ошибка
// payment= false
// status = 9
// result = 9
// Когда payment= true, то заполняются следующие поля значениями:
// amount - сумма авторизации
// timestamp - время авторизации
// reference - референс транзакции
// cardhash - маскированный номер карты
// approval_code - аппрувал код
<bank_sign type="RSA" cert_id="">
// cert_id - Серийный номер сертификата, name - имя магазина(сайта)
// type - Тип подписи
<!-- Подпись -->
p25i1rUH7StnhOfnkHSOHguuPMePaGXtiPGEOrJE4bof1gFVH19mhDyHjfWa6OeJ80fidyvVf1X4
ewyP0yG4GxJSl0VyXz7+PNLsbs1lJe42d1fixvozhJSSYN6fAxMN8hhDht6S81YK3GbDTE7GH498
pU9HGuGAoDVjB+NtrHk=
<!-- Подпись -->
</bank>
</document>
==Описание XML ответа в случае ошибки
В случае ошибки сервер выдаст такой XML<error>Error Message</error>
Вместо Error Message будет вставлена причина ошибки