Page History

Versions Compared

Old Version 41

changes.mady.by.user Oksana Chizhikova

Saved on Jul 07, 2024

compared with

New Version Current

changes.mady.by.user Oksana Chizhikova

Saved on Jul 09, 2024

Key

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

...

Code Block

language	xml

<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<!DOCTYPE result [
<!ATTLIST result
                 firstcode CDATA #REQUIRED
                 secondcode CDATA #REQUIRED
                 count CDATA #REQUIRED>
<!ELEMENT result (order*)>
<!ELEMENT order (ordernumber?,billnumber?,testmode?,ordercomment?,orderamount?,ordercurrency?,firstname?,lastname?,middlename?,email?,orderdate?,orderstate?,packetdate?,signature?,checkvalue?,operation*)>
<!ELEMENT ordernumber (#PCDATA)>
<!ELEMENT billnumber (#PCDATA)>
<!ELEMENT testmode (#PCDATA)>
<!ELEMENT ordercomment (#PCDATA)>
<!ELEMENT orderamount (#PCDATA)>
<!ELEMENT ordercurrency (#PCDATA)>
<!ELEMENT firstname (#PCDATA)>
<!ELEMENT lastname (#PCDATA)>
<!ELEMENT middlename (#PCDATA)>
<!ELEMENT email (#PCDATA)>
<!ELEMENT orderdate (#PCDATA)>
<!ELEMENT orderstate (#PCDATA)>
<!ELEMENT packetdate (#PCDATA)>
<!ELEMENT signature (#PCDATA)>
<!ELEMENT checkvalue (#PCDATA)>
<!ELEMENT operation  (billnumber?,operationtype?,operationstate?,amount?,currency?,clientip?,ipaddress?,meantype_id?,meantypename?,meansubtype?,meannumber?,cardholder?,cardexpirationdate?,issuebank?,bankcountry?,responsecode?,message?,customermessage?,recommendation?,approvalcode?,protocoltypename?,processingname?,operationdate?,authresult?,authrequired?,slipno?)>
<!ELEMENT operationtype (#PCDATA)>
<!ELEMENT operationstate (#PCDATA)>
<!ELEMENT amount (#PCDATA)>
<!ELEMENT currency (#PCDATA)>
<!ELEMENT clientip (#PCDATA)>
<!ELEMENT ipaddress (#PCDATA)>
<!ELEMENT meantype_id (#PCDATA)>
<!ELEMENT meantypename (#PCDATA)>
<!ELEMENT meansubtype (#PCDATA)>
<!ELEMENT meannumber (#PCDATA)>
<!ELEMENT cardholder (#PCDATA)>
<!ELEMENT cardexpirationdate (#PCDATA)>
<!ELEMENT issuebank (#PCDATA)>
<!ELEMENT bankcountry (#PCDATA)>
<!ELEMENT responsecode (#PCDATA)>
<!ELEMENT message (#PCDATA)>
<!ELEMENT customermessage (#PCDATA)>
<!ELEMENT recommendation (#PCDATA)>
<!ELEMENT approvalcode (#PCDATA)>
<!ELEMENT protocoltypename (#PCDATA)>
<!ELEMENT processingname (#PCDATA)>
<!ELEMENT operationdate (#PCDATA)>
<!ELEMENT authresult (#PCDATA)>
<!ELEMENT authrequired (#PCDATA)>
<!ELEMENT slipno (#PCDATA)>]>
<result firstcode='0' secondcode='0' count='1'>
<order>
  <ordernumber>0001-01</ordernumber>
  <billnumber>511111100000001</billnumber>
  <testmode>1</testmode>
  <ordercomment>тестовый платеж</ordercomment>
  <orderamount>100.00</orderamount>
  <ordercurrency>RUB<<ordercurrency>KZT</ordercurrency>
  <firstname>Test</firstname>
  <lastname>Testov</lastname>
  <middlename>Testovich</middlename>
  <email>test@testpost.ru<kz</email>
  <orderdate>01.01.2018 11:23:13</orderdate>
  <orderstate>Approved</orderstate>
  <packetdate>01.01.2011 12:05</packetdate>
  <signature></signature>
  <checkvalue></checkvalue>
  <operation>
    <billnumber>511111100000001.1</billnumber>
    <operationtype>100</operationtype>
    <operationstate>Success</operationstate>
    <amount>100.00</amount>
    <currency>RUB<<currency>KZT</currency>
    <clientip>111.23.11.23</clientip>
    <ipaddress>0.0.0.0</ipaddress>
    <meantype_id>1</meantype_id>
    <meantypename>VISA</meantypename>
    <meansubtype>Classic</meansubtype>
    <meannumber>411111****1111</meannumber>
    <cardholder>TEST</cardholder>
    <cardexpirationdate>12/20</cardexpirationdate>
    <issuebank>New Bank</issuebank>
    <bankcountry>Russia<<bankcountry>Казахстан</bankcountry>
    <responsecode>AS000</responsecode>
    <message></message>
    <customermessage> </customermessage>
    <recommendation></recommendation>
    <approvalcode>F41412</approvalcode>
    <protocoltypename>NET</protocoltypename>
    <processingname>Name</processingname>
    <operationdate>01.01.2018 11:24:13</ operationdate>
    <authresult>Y</authresult>
    <authrequired>1</authrequired>
    <slipno>111111</slipno></operation>
    <threedsdata>
      <version>1.0.0</version>
      <alphaauthresult>Y</alphaauthresult>
      <challenge>C</challenge>
      <eci>5</eci>
    </threedsdata>
  <operation>
    <billnumber>511111100000001.2</billnumber>
    <operationtype>200</operationtype>
    <operationstate>Success</operationstate>
    <amount>100.00</amount>
    <currency>RUB<<currency>KZT</currency>
    <clientip>111.23.11.23</clientip>
    <ipaddress>0.0.0.0</ipaddress>
    <meantype_id>1</meantype_id>
    <meantypename>VISA</meantypename>
    <meansubtype>Classic</meansubtype>
    <meannumber>411111****1111</meannumber>
    <cardholder>TEST</cardholder>
    <cardexpirationdate>12/20</cardexpirationdate>
    <issuebank>New Bank</issuebank>
    <bankcountry>Russia<<bankcountry>Казахстан</bankcountry>
    <responsecode>AS000</responsecode>
    <message></message>
    <customermessage> </customermessage>
    <recommendation></recommendation>
    <approvalcode></approvalcode>
    <protocoltypename></protocoltypename>
    <processingname>Name</processingname>
    <operationdate>01.02.2018 19:24:13</operationdate>
    <authresult></authresult>
    <authrequired></authrequired>
    <slipno>111111</slipno>
  </operation></order></result>

Пример результата запроса в формате XML, вернувшего ошибку (неправильный пароль):

Code Block

language	xml

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<!DOCTYPE result [...]>
<result firstcode="7" secondcode="102" count="0"></result>

С описанием первого и второго кодов ошибок можно ознакомиться в таблице Коды ошибок. Также в соответствующих таблицах описаны возможные статусы заказа, типы операций, коды возврата и коды валют. В качестве значения поля <meannumber> возвращаются первые 6 и последние 4 цифры номера карты, остальные цифры скрыты символом *.

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

https://<SERVER-NAME>/orderresult/orderresult.wsdl.

Note

title	Примечание

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

Пример ответа в формате SOAP для случая успешной оплаты заказа со второй попытки, причем первая попытка закрыта из-за превышения времени ожидания, а вторая (успешная) состоит из двух операций:

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.paysecure.ru/ws/"><soapenv:Body>
<ws:orderresultResponse><orderresult>
<order>
      <ordernumber>13032014_122</ordernumber>
      <billnumber>5500069208498005</billnumber>
      <testmode>1</testmode>
      <ordercomment>тестовый платеж</ordercomment>
      <orderamount>122.00</orderamount>
      <ordercurrency>KZT</ordercurrency>
      <firstname>Test</firstname>
      <lastname>Testov</lastname>
      <middlename>T.</middlename>
      <email>test@test.kz</email>
      <orderdate>13.03.2018 13:38:24</orderdate>
      <orderstate>Timeout</orderstate>
      <packetdate>13.03.2018 14:55</packetdate>
      <signature></signature>
      <checkvalue>863F176DC699131758B2230EA93BC911</checkvalue>
</order>
<order>
      <ordernumber>13032014_122</ordernumber>
      <billnumber>5500069208498070</billnumber>
      <testmode>1</testmode>
      <ordercomment>тестовый платеж</ordercomment>
      <orderamount>122.00</orderamount>
      <ordercurrency>KZT</ordercurrency>
      <firstname>Test</firstname>
      <lastname>Testov</lastname>
      <middlename>T.</middlename>
      <email>test@test.kz</email>
      <orderdate>13.03.2018 14:52:09</orderdate>
      <orderstate>Approved</orderstate>
      <packetdate>13.03.2018 14:55</packetdate>
      <signature></signature>
      <checkvalue>E458CD73F1AA3F994F4D97C40613FD0A</checkvalue>
      <operation>
         <billnumber>5500069208498070.1</billnumber>
         <operationtype>100</operationtype>
         <operationstate>Success</operationstate>
         <amount>122.00</amount>
         <currency>KZT</currency>
         <clientip>10.10.10.10</clientip>
         <ipaddress>0.0.0.0</ipaddress>
         <meantype_id>1</meantype_id>
         <meantypename>VISA</meantypename>
         <meansubtype>Busines</meansubtype>
         <meannumber>462710****4724</meannumber>
         <cardholder>TEST</cardholder>
         <cardexpirationdate>12/20</cardexpirationdate>
         <issuebank>Bank</issuebank>
         <bankcountry>Казахстан</bankcountry>
         <responsecode>AS000</responsecode>
         <message></message>
         <customermessage></customermessage>
         <recommendation></recommendation>
         <approvalcode>X53576</approvalcode>
         <protocoltypename>NET</protocoltypename>
         <processingname>Fake</processingname>
         <operationdate>13.03.2018 14:52:10</operationdate>
         <authresult></authresult>
         <authrequired>0</authrequired>
         <threedsdata>
             <version>1.0.0</version>
             <alphaauthresult>C</alphaauthresult>
             <challenge>C</challenge>
             <eci></eci>
         </threedsdata>
      </operation>
      <operation>
         <billnumber>5500069208498070.2</billnumber>
         <operationtype>200</operationtype>
         <operationstate>Success</operationstate>
         <amount>122.00</amount>
         <currency>KZT</currency>
         <clientip>10.10.10.10</clientip>
         <ipaddress>0.0.0.0</ipaddress>
         <meantype_id>1</meantype_id>
         <meantypename>VISA</meantypename>
         <meansubtype>Busines</meansubtype>
         <meannumber>462710****4724</meannumber>
         <cardholder>TEST</cardholder>
         <cardexpirationdate>12/20</cardexpirationdate>
         <issuebank>Bank</issuebank>
         <bankcountry>Казахстан</bankcountry>
         <responsecode>AS000</responsecode>
         <message></message>
         <customermessage></customermessage>
         <recommendation></recommendation>
         <approvalcode></approvalcode>
         <protocoltypename></protocoltypename>
         <processingname>Fake</processingname>
         <operationdate>13.03.2018 14:53:37</operationdate>
         <authresult></authresult>
         <authrequired>0</authrequired>
         <threedsdata>
             <version>1.0.0</version>
             <alphaauthresult>Y</alphaauthresult>
             <challenge>C</challenge>
             <eci>5</eci>
         </threedsdata>
      </operation>
</order>
</orderresult></ws:orderresultResponse></soapenv:Body></soapenv:Envelope>

Warning

title	Внимание!

Для корректной работы с веб-сервисами по защищенному TLS-соединению необходимо иметь на своей стороне в хранилище доверенных корневых сертификатов следующие сертификаты:

корневые сертификаты от GlobalSign (https://www.globalsign.com/repository/ca-certificates/):
- GlobalSign Root R3;
- GlobalSign ECC Root R5;
- GlobalSign Root R6;
корневые сертификаты от Sectigo (https://www.sectigo.com/knowledge-base/detail/Sectigo-Root-Certificates/kA03l000000c4KV):
- USERTrust RSA Certification Authority;
- USERTrust ECC Certification Authority.

Перед началом работы следует проверить наличие этих сертификатов в хранилище и добавить их в случае необходимости.

Наверх

Content

Space Tools

Versions Compared

Old Version 41

New Version Current

Key