www.assist.kz

Versions Compared

Old Version 25

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.

...

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

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

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

Если счет или заказ с указанным в запросе номером уже существует, то счет не создается и выдается сообщение об ошибке " Счет с указанным номером уже существует ".

Если в запросе не переданы обязательные параметры или нарушены форматы передачи данных, то счет не создается и выдается сообщение об ошибке (аналогично ошибке при создании заказа с неверными/недостающими параметрами).

Если не удается создать уникальный платежный токен/ID, то счет не создается и выдается сообщение об ошибке " Не удалось сформировать уникальный платежный токен ".

Информация  об использовании  протокола 3-D Secure 2.0   при создании платежа.

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

Code Block
languagexml
<FORM ACTION="https://<SERVER-NAME>/bill/createbill.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="Bill_amount" VALUE="Сумма счета">
<INPUT TYPE="hidden" NAME="Bill_currency" VALUE="Валюта счета">
<INPUT TYPE="hidden" NAME="Bill_comment" VALUE="Комментарий к счету">
<INPUT TYPE="hidden" NAME="Customer_Name" VALUE="Имя плательщика">
<INPUT TYPE="hidden" NAME="Customer_Lastname" VALUE="Фамилия плательщика">
<INPUT TYPE="hidden" NAME="Customer_Middleтame" VALUE="Отчество плательщика">
<INPUT TYPE="hidden" NAME="Customer_Email" VALUE="Email плательщика">
<INPUT TYPE="hidden" NAME="Customer_Phone" VALUE="Телефон плательщика">
<INPUT TYPE="hidden" NAME="Customer_Mobile" VALUE="Моб. телефон плательщика">
<INPUT TYPE="hidden" NAME="Language" VALUE="Язык платежных страниц">
<INPUT TYPE="hidden" NAME="Pay_until" VALUE="Срок оплаты счета">
<INPUT TYPE="hidden" NAME="SendNotification" VALUE="Флаг отправки счета">
<INPUT TYPE="hidden" NAME="Checkvalue" VALUE="Контрольная сумма">
<INPUT TYPE="hidden" NAME="GenerateReceipt" VALUE="1">
<INPUT TYPE="hidden" NAME="Tax" VALUE="Идентификатор ставки налога">
<INPUT TYPE="hidden" NAME="ReceiptLine" VALUE="Наименование позиции чека">
<INPUT TYPE="HIDDEN" NAME="CashierINN" VALUE="Код оператора-кассира">
<INPUT TYPE="HIDDEN" NAME="Cashier" VALUE="ФИО кассира">
<INPUT TYPE="HIDDEN" NAME="PaymentPlace" VALUE="Код отдела">
<INPUT TYPE="Submit"></FORM>

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

Название

Значение

Hash

Платежный токен/ID счета

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

Code Block
languagexml
Hash: xKPWpz4ZzDe5A9anPhnN

В формате XML:

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

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

https://<SERVER_NAME>/bill/createbill.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>
        <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>
        </CreateBill>
    </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.ru/ws/">
            <return xsi:type="si:SOAPStruct" xmlns:si="http://www.paysecure.ru/type/">
                <Hash xsi:type="xsd:string">6CPV7F4a0aWQg9XsXhrS</Hash>
            </return>
        </ASS-NS:BillResponse>
    </SOAP-ENV:Body>

Запрос статуса счета (billstatus)

Сервис позволяет получить полные данные о счете, его оплате и отменам по его номеру или параметру billnumber.

Если счет не удалось найти по его номеру, выдается сообщение об ошибке "Счет не найден".

Если заказ не удалось найти по параметру billnumber, то выдается сообщение об ошибке "Счет не найден среди обработанных".

URL запроса статуса счета:

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

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

Название

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

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

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

Описание

Merchant_ID

Да

Число


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

Login

Да

8 - 20 символов 


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

Password

Да

8 - 20 символов


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

Bill

Да/Нет*

128 символов


Номер счета (при создании заказа будет использован в качестве OrderNumber)

BillNumber

Да/Нет*

15 или 16 цифр


Номер платежа - уникальный номер заказа в системе АПК Ассист

*Обязательно должен быть передан один из параметров - Bill или BillNumber. Если в одном запросе переданы оба параметра, то поиск будет осуществляться по BillNumber.

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

Code Block
languagexml
<FORM ACTION="https://<SERVER-NAME>/bill/billstatus.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="BillNumber" VALUE="Номер платежа">
<INPUT TYPE="Submit"></FORM>

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

Название

Значение

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.

Наверх