Versions Compared

Key

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

...

При возвратах платежей по QIWI, выполненных с помощью web-интерфейсов, обычно система АПК Ассист сразу передает на запрос отмены заказа соответствующий успешный статус, однако, в некоторых случаях передается ответ со статусом операции «In Process» (responsecode=AS300). Это связано с задержкой при выдаче результата отмены платежной системой QIWI. Для получения реального результата в этом случае следует отправить дополнительный запрос на получение результатов операций по номеру заказа через несколько минут после запроса на отмену. В случае нескольких отмен результат запроса будет содержать несколько вложенных операций типа 300 (Отмена), имеющих различные значения параметра billnumber в расширенном формате (например, 5700027202722028.3).

Веб-сервис для формата SOAP (wscancel)

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

https://<SERVER-NAME>/cancel/wscancel.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>
        <WSCancelRequestParams>
            <merchant_id xmlns="">423422</merchant_id>
            <billnumber xsi:type="xsd:string" xmlns="">500000210031071.1</billnumber>
            <login xsi:type="xsd:string" xmlns="">login</login>
            <password xsi:type="xsd:string" xmlns="">password</password>
            <amount xsi:type="xsd:string" xmlns="">23.23</amount>
            <currency xsi:type="xsd:string" xmlns="">RUB</currency>
        </WSCancelRequestParams>
    </Body>
</Envelope>

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

...

Название

...

billnumber

...

Уникальный номер заказа в системе АПК Ассист

...

ordernumber

...

Номер заказа

...

testmode

...

Тестовый режим

...

ordercomment

...

Комментарий

...

orderamount

...

Оригинальная сумма заказа

...

ordercurrency

...

Оригинальная валюта заказа

...

rate

...

Курс валюты

...

orderdate

...

Дата заказа по Гринвичу (GMT)

...

orderstate

...

Статус заказа

...

firstname

...

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

...

lastname

...

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

...

middlename

...

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

...

email

...

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

...

billnumber

...

Уникальный номер операции (расширенный формат: billnumber.<номер операции>)

...

operationtype

...

Код типа операции

...

operationstate

...

Состояние операции

...

amount

...

Сумма операции

...

currency

...

Валюта операции

...

ipaddress

...

IP-адрес плательщика

...

meantype_id

...

Тип платежного средства

...

meansubtype

...

Подтип платежного средства

...

meannumber

...

Номер платежного средства

...

cardholder

...

Держатель платежного средства

...

cardexpirationdate

...

Срок действия карты

...

issuebank

...

Название банка-эмитента

...

bankcountry

...

Страна банка-эмитента

...

responsecode

...

Код возврата

...

message

...

Сообщение о результате операции

...

customermessage

...

Сообщение о результате для покупателя

...

recommendation

...

Рекомендация

...

approvalcode

...

Код авторизации

...

protocoltypename

...

Протокол

...

processingname

...

Процессинг

...

operationdate

...

Дата и время операции (GMT)

...

slipno

...

Номер финансовой транзакции, отправляемый в процессинг

...

packetdate

...

Дата формирования запроса по Гринвичу (GMT)

...

signature

...

Подпись. Формируется по следующему алгоритму:

1. Формируется объединённая строка из параметров (в их строковом представлении, в формате как они переданы в ответе): billnumber, ordernumber, responsecode, amount, currency, meannumber, approvalcode, orderstate, packetdate (без разделителей)

2. Полученная строка подписывается закрытым ключом АПК Ассист.

3. Итоговая последовательность байт кодируется в BASE64.

Multiexcerpt include
MultiExcerptNameslipno
PageWithExcerptБлоки документов

Пример результата запроса отмены платежа или возврата средств:

Code Block
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://www.paysecure.ru/ws/">
<soapenv:Body><ws:WSCancelResponseParams>
        <order>
            <billnumber>500000210031071</billnumber>
            <ordernumber>14092012-002</ordernumber>
            <testmode>0</testmode>
            <ordercomment>тестовый платеж</ordercomment>
            <orderamount>4010.00</orderamount>
            <ordercurrency>RUB</ordercurrency>
            <rate>1</rate>
            <orderdate>14.09.2017 09:29:38</orderdate>
            <orderstate>Canceled</orderstate>
            <customer>
                <firstname>Testov</firstname>
                <lastname>Test</lastname>
                <middlename>T</middlename>
                <email>test@test.ru</email>
            </customer>
            <operation>
                <billnumber>500000210031071.3</billnumber>
                <operationtype>300</operationtype>
                <operationstate>Завершено успешно.</operationstate>
                <amount>4010.00</amount>
                <currency>RUB</currency>
                <ipaddress>10.10.10.10</ipaddress>
                <meantype_id>1</meantype_id>
                <meansubtype></meansubtype>
                <meannumber>411111****1111</meannumber>
                <cardholder>TEST</cardholder>
                <cardexpirationdate>12/20</cardexpirationdate>
                <issuebank>Bank T</issuebank>
                <bankcountry>Россия</bankcountry>
                <responsecode>AS000</responsecode>
                <message></message>
                <customermessage>Завершено успешно</customermessage>
                <recommendation></recommendation>
                <approvalcode>X34209</approvalcode>
                <protocoltypename></protocoltypename>
                <processingname>Fake</processingname>
                <operationdate>14.09.2017 09:33:51</operationdate>
                <slipno>112211</slipno>
            </operation>
        </order>
        <packetdate>14.09.2017 09:33:57</packetdate>
        <signature>kA0DAAIRzfHw5YyCW...bQnThrGPVGBK6gh9bxUl1w==</signature>
  </ws:WSCancelResponseParams></soapenv:Body>
</soapenv:Envelope>
Expand
titleПример результата запроса отмены платежа или возврата средств: при работе с бонусными баллами
Code Block
languagexml
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://www.paysecure.ru/ws/">
<soapenv:Body><ws:WSCancelResponseParams>
        <order>
           <billnumber>5774168101038147</billnumber>
           <ordernumber>14092012-002</ordernumber>
           <testmode>0</testmode>
           <ordercomment>тестовый платеж</ordercomment>
           <orderamount>4010.00</orderamount>
           <ordercurrency>RUB</ordercurrency>
           <rate>1</rate>
           <orderdate>14.09.2012 09:29:38</orderdate>
           <orderstate>Canceled</orderstate>
           <customer>
              <firstname>Ирина</firstname>
              <lastname>Иванова</lastname>
              <middlename>Ивановна</middlename>
              <email>test@test.ru</email>
           </customer>
           <operation>
              <billnumber>5774168101038147.3</billnumber>
              <operationtype>300</operationtype>
              <operationstate>Завершено успешно.</operationstate>
              <amount>4010.00</amount>
              <currency>RUB</currency>
              <ipaddress>10.10.10.10</ipaddress>
              <meantype_id>1</meantype_id>
              <meansubtype></meansubtype>
              <meannumber>411111****1111</meannumber>
              <cardholder>TEST</cardholder>
              <cardexpirationdate>12/20</cardexpirationdate>
              <issuebank>SBERBANK OF RUSSIA</issuebank>
              <bankcountry>Россия</bankcountry>
              <responsecode>AS000</responsecode>
              <message></message>
              <customermessage>Завершено успешно</customermessage>
              <recommendation></recommendation>
              <approvalcode>X34209</approvalcode>
              <protocoltypename></protocoltypename>
              <processingname>Fake</processingname>
              <operationdate>14.09.2012 09:33:51</operationdate>
              <slipno></slipno>
           </operation>
           <operation>
              <billnumber>5774168101038147.4</billnumber>
              <operationtype>600</operationtype>
              <operationstate>Завершено успешно.</operationstate>
              <amount>401.00</amount>
              <currency>RUB</currency>
              <ipaddress>10.10.10.10</ipaddress>
              <meantype_id>12</meantype_id>
              <meansubtype></meansubtype>
              <meannumber>411111****1111</meannumber>
              <cardholder>TEST</cardholder>
              <cardexpirationdate>12/20</cardexpirationdate>
              <issuebank>SBERBANK OF RUSSIA</issuebank>
              <bankcountry>Россия</bankcountry>
              <responsecode>AS000</responsecode>
              <message></message>
              <customermessage>Завершено успешно</customermessage>
              <recommendation></recommendation>
              <approvalcode></approvalcode>                    
              <protocoltypename></protocoltypename>
              <processingname>SberTest</processingname>
              <operationdate>14.09.2012 09:33:51</operationdate>
              <slipno></slipno>
           </operation>
        </order>
        <packetdate>14.09.2012 09:33:57</packetdate>
        <signature>kA0DAAIRzfHw5YyCW...bQnThrGPVGBK6gh9bxUl1w==</signature>
   </ws:WSCancelResponseParams></soapenv:Body>
</soapenv:Envelope>

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

Code Block
languagexml
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"><soapenv:Body><soapenv:Fault><faultcode>soapenv:Server.generalException</faultcode><faultstring/><detail><ns:WSException
xmlns:ns="http://www.paysecure.ru/ws/">
<firstcode>5</firstcode><secondcode>108</secondcode>
</ns:WSException></detail>
</soapenv:Fault></soapenv:Body></soapenv:Envelope>

Multiexcerpt includeMultiExcerptNameSertificatPageWithExcerptБлоки документовПодробное описание веб-сервисов


Наверх