www.assist.kz

Versions Compared

Old Version 63

changes.mady.by.user Oksana Chizhikova

Saved on

compared with

New Version Current

changes.mady.by.user Oksana Chizhikova

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header/>
    <Body>
        <WSCreateBill><CreateBill>
            <Bill>
                <merchant_id>423422</merchant_id>
                <login>login</login>
                <password>password</password>
                <bill>123456</bill>
                <bill_amount>23.23</bill_amount>
                <bill_currency>KZT</bill_currency>
                <bill_comment></bill_comment>
                <customer_name>Test</customer_name>
                <customer_lastname>Testov</customer_lastname>
                <customer_middlename>Testovich</customer_middlename>
                <customer_email>test@testpost.kz</customer_email>
                <customer_phone></customer_phone>
                <language>RU</language>
                <pay_until>20150611T1212</pay_until>
                <sendnotification>0</sendnotification>
                <cashierinn>2147483646</cashierinn>
                <cashier>Иванов Иван Иванович</cashier>  
                <paymentplace>А345</paymentplace>   
                <checkvalue>AA3BC3F48B7FE23988044B53AA98F169</checkvalue>
            </Bill>
        </WSCreateBill>CreateBill>
    </Body>
</Envelope>

Пример результата запроса создания счета:

...

Список параметров ответа:

Название

Значение

Merchant_id

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

Bill

Номер счета

Bill_amount

Сумма счета

Bill_currency

Валюта счета

Bill_comment

Комментарий к счету

Bill_date

Дата и время создания счета (GMT)

Bill_status

Статус счета

Billnumber

Номер платежа (пусто, если заказ не был создан) = Billnumber заказа

Payment_date

Дата и время оплаты счета (пусто, если заказ не был создан) = OrderDate (GMT)

Payment_amount

Сумма платежа (пусто, если заказ не был создан) = сумма операции оплаты amount

Payment_currency

Валюта платежа (пусто, если заказ не был создан) = валюта операции оплаты currency

Payment_RRN

Дополнительный идентификатор платежа/RRN (пусто, если не было оплаты)

Refund_amount

Сумма успешных возвратов по платежу (пусто, если заказ не был создан; 0, если оплата была, но не было возвратов)

Customer_name

Имя плательщика

Customer_Lastname

Фамилия плательщика

Customer_Middlename

Отчество плательщика

Customer_Email

Email плательщика

Customer_Phone

Телефон плательщика

Customer_Mobile

Мобильный телефон плательщика

Language

Язык

Pay_until

Срок оплаты счета (GMT)

Sendnotification

Флаг отправки счета (0 - не отправлять, 1 - отправлять, 10 – отправлен)*

Bill_typeТип счета (1 - по умолчанию)

CheckValue

Контрольная сумма формируется на основе формулы:
uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки всех переданных параметров ответа (в последовательности по порядку следования параметров в таблице сверху вниз, не включая SendNotification и Checkvalue) через разделитель - точка с запятой(";"), разделитель добавляется и в случае отсутствующего параметра, '+' – строковая склейка."

*Если при создании счета была запрошена отправка счета (с помощью передачи параметра SendNotification=1 или настроек в системе АПК Ассист), то после создания счета параметр SendNotification в ответе может иметь следующие значения:

  • 1 - если отправка E-mail еще не состоялась (например, не указан адрес E-mail);
  • 10 - если письмо уже было сформировано и отправлено (поставлено в очередь отправки).


Пример результата запроса статуса счета в формате CSV:

Code Block
languagexml
merchant_id:515089; bill:2015.06.30 11:19-85; bill_amount:100.00; bill_currency:KZT; bill_comment:; bill_date:30.06.2015 08:19:41;
bill_status:Invoiced; billNumber:;payment_date: ; payment_amount:0.00; payment_currency:; payment_rrn:; refund_amount:;
customer_name:Test; customer_lastname:Testov; customer_middlename:; customer_email:test@testpost.kz; customer_phone:; customer_mobile:;
language:RU; pay_until:20150701T0819; sendnotification:1; checkValue:26397652E3DB8E25407A9B091B9431B3

В формате XML:

Code Block
languagexml
<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<result firstcode="0" secondcode="0" count="1">
   <orders>
      <order>
          <merchant_id>515089</merchant_id>
          <bill>20150630111985</bill>
          <bill_amount>100.00</bill_amount>
          <bill_currency>KZT</bill_currency>
          <bill_comment/>
          <bill_date>30.06.2015 08:19:41</bill_date>
          <bill_status>Invoiced</bill_status>
          <billNumber/>
          <payment_date></payment_date>
          <payment_amount>0.00</payment_amount>
          <payment_currency/>
          <payment_rrn/>
          <refund_amount/>
          <customer_name>Test</customer_name>
          <customer_lastname>Testov</customer_lastname>
          <customer_middlename/>
          <customer_email>test@testpost.kz</customer_email>
          <customer_phone/>
          <customer_mobile/>
          <language>RU</language>
          <pay_until>20150701T0819</pay_until>
          <sendnotification>1</sendnotification>
          <checkValue>26397652E3DB8E25407A9B091B9431B3</checkValue>
      </order>
   </orders>
</result>

Описание веб-сервиса для формата SOAP:

https://<SERVER_NAME>/bill/billstatus.wsdl

Пример запроса статуса счета:

Code Block
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header/>
    <Body>
        <BillStatus>
            <Bill>
                <merchant_id>423422</merchant_id>
                <login>login</login>
                <password>password</password>
                <bill>123456</bill>
                <billnumber></billnumber>
            </Bill>
        </BillStatus>
    </Body>
</Envelope>

Пример результата запроса статуса счета:

Code Block
languagexml
<soapenv:Envelope
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
        <ASS-NS:BillResponse xmlns:ASS-NS="http://www.paysecure.kz/ws/">
            <return xsi:type="si:SOAPStruct" xmlns:si="http://www.paysecure.kz/type/">
                <merchant_idxsi:type="xsd:string">515089</merchant_id>
                <bill xsi:type="xsd:string">20150610115527</bill>
                <bill_amount xsi:type="xsd:string">150.00</bill_amount>
                <bill_currency xsi:type="xsd:string">KZT</bill_currency>
                <bill_comment xsi:type="xsd:string">testbill</bill_comment>
                <bill_date xsi:type="xsd:string">10.06.2015 09:03:07</bill_date>
                <bill_status xsi:type="xsd:string">Invoiced</bill_status>
                <billNumber xsi:type="xsd:string"/>
                <payment_date xsi:type="xsd:string"></payment_date>
                <payment_amount xsi:type="xsd:string">0.00</payment_amount>
                <payment_currency xsi:type="xsd:string"/>
                <payment_rrn xsi:type="xsd:string"/>
                <refund_amount xsi:type="xsd:string"/>
                <customer_name xsi:type="xsd:string">test</customer_name>
                <customer_lastname xsi:type="xsd:string">testov</customer_lastname>
                <customer_middlename xsi:type="xsd:string"/>
                <customer_email xsi:type="xsd:string">test@testpost.ru</customer_email>
                <customer_phone xsi:type="xsd:string"/>
                <customer_mobile xsi:type="xsd:string"/>
                <language xsi:type="xsd:string">EN</language>
                <pay_until xsi:type="xsd:string">20150611T0903</pay_until>
                <sendnotification xsi:type="xsd:string">0</sendnotification>
                <checkValue xsi:type="xsd:string">D9F0E4933007B96BCC2594983F7A24E3</checkValue>
            </return>
        </ASS-NS:BillResponse>
    </SOAP-ENV:Body>

Запрос аннулирования счета (billrevoke)

Сервис позволяет аннулировать еще не оплаченный счет. Вызов этого сервиса переводит счет в статус Deleted (удален), если счет на момент запроса находится в одном из статусов: Invoiced (выставлен) или Timed out (просрочен).

URL для аннулирования счета:

https://<SERVER-NAME>/bill/billrevoke.cfm

Список параметров запроса:

Название

Обязательное поле

Принимаемые значения

Значение по умолчанию

Описание

Merchant_ID

Да

Число


Идентификатор предприятия в АПК Ассист

Login

Да

8 - 20 символов 


Логин (лат. буквы и цифры, символ _)

Password

Да

8 - 20 символов


Пароль (лат. буквы и цифры)

Bill

Да

128 символов


Номер счета

SendNotification

Нет

Число

В зависимости от настроек мерчанта

Флаг отправки уведомления об аннулировании счета (если параметр не передан в запросе, то используется настройка по умолчанию для данного мерчанта в системе АПК Ассист).

Checkvalue

Да

Строка


Контрольная сумма (формируется так же, как при создании счета по параметрам этой таблицы)

Пример запроса HTTP POST для аннулирования счета:

Code Block
languagexml
<FORM ACTION="https://test.paysecure.kz/bill/billrevoke.cfm" method="POST">
<INPUT TYPE="hidden" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="hidden" NAME="Login" VALUE="Ваш логин">
<INPUT TYPE="hidden" NAME="Password" VALUE="Ваш пароль">
<INPUT TYPE="hidden" NAME="Bill" VALUE="Номер счета">
<INPUT TYPE="hidden" NAME="SendNotification" VALUE="Флаг отправки счета">
<INPUT TYPE="hidden" NAME="Checkvalue" VALUE="Контрольная сумма">
<INPUT TYPE="Submit"></FORM>

Список параметров ответа:

Название

Значение

Bill

Номер счета

Bill_status

Статус счета

Пример результата запроса аннулирования счета в формате CSV:

Code Block
languagexml
bill:2015.06.30 11:17-81; bill_status:Revoked

В формате XML:

Code Block
languagexml
<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<result firstcode="0" secondcode="0" count="1">
      <return>
          <bill>20150630111985</bill>
          <bill_status>Revoked</bill_status>
      </return>
</result>

Описание веб-сервиса для формата SOAP:

https://<SERVER_NAME>/bill/billrevoke.wsdl

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

Code Block
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header/>
    <Body>
        <BillRevoke>
            <Bill>
                <merchant_id>423422</merchant_id>
                <login>login</login>
                <password>password</password>
                <bill>123456</bill>
                <sendnotification>0</sendnotification>
                <checkvalue> AA3BC3F48B7FE23988044B53AA98F169</checkvalue>
            </Bill>
        </BillRevoke>
    </Body>
</Envelope>

Пример результата запроса аннулирования счета:

Code Block
languagexml
<soapenv:Envelope
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
        <ASS-NS:BillResponse xmlns:ASS-NS="http://www.paysecure.kz/ws/">
            <return xsi:type="si:SOAPStruct" xmlns:si="http://www.paysecure.ru/type/">
                <bill xsi:type="xsd:string">20150610115527</bill>
                <bill_status xsi:type="xsd:string">Revoked</bill_status>
            </return>
        </ASS-NS:BillResponse>
    </SOAP-ENV:Body>

Шаблоны уведомлений

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

Subj

Вам выставлен счет для оплаты

Text

Здравствуйте, Тестов Тест Тестович,


Сообщаем, что для вас был сформирован счет № 1c362fd на сумму 888.42 KZT

Вы можете оплатить его в срок до 25.01.2015 18:00 (MSK).


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

https://payments.paysecure.kz/bill/paybill.cfm?ID=c2RmZ2UzNXkyNXR5MjU0


По всем вопросам, связанным этим счетом, пожалуйста, обращайтесь в интернет-магазин №1 по адресу: shop1@testpost.kz

_____________

С уважением,

Отдел технической поддержки

Assist

www.assist.kz

В случае аннулирования счета покупатель также получит уведомление по электронной почте. Ниже представлен его пример:

ubj

Счет был аннулирован

Text

Здравствуйте, Тестов Тест Тестович,


Сообщаем, что счет № 1c362fd на сумму 888.42 KZT был аннулирован.


По всем вопросам, связанным этим счетом, пожалуйста, обращайтесь в интернет-магазин №1 по адресу: shop1@testpost.kz

_____________

С уважением,

Отдел технической поддержки

Assist

www.assist.kz

Note
titleПримечание

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

Шаблоны уведомлений могут быть настроены по желанию предприятия. Для этого следует обратиться в службу технической поддержки АПК Ассист support@assist.kz.

Наверх