Versions Compared

Key

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

...

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

Название

Значение

ordernumber

Номер заказа

responsecode

Код возврата

recommendation

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

message

Сообщение

ordercomment

Комментарий

orderdate

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

amount

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

currency

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

meantypename

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

meannumber

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

lastname

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

firstname

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

middlename

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

issuebank

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

Email

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

bankcountry

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

rate

Курс валюты

approvalcode

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

meansubtype

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

cardholder

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

cardexpirationdate

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

ipaddress

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

protocoltypename

Протокол

testmode

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

customermessage

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

orderstate

Cтатус заказа

processingname

Процессинг

operationtype

Тип операции

billnumber

Расширенный формат billnumber

orderamount

Оригинальная сумма операции

ordercurrency

Оригинальная валюта операции

slipno

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

packetdate

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

signature


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

...

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

Веб-сервис для формата 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>

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

Название

Значение

Параметрызаказа(секция<order>)

billnumber

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

ordernumber

Номер заказа

testmode

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

ordercomment

Комментарий

orderamount

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

ordercurrency

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

rate

Курс валюты

orderdate

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

orderstate

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

Данныеоплательщике(секция<customer>)

firstname

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

lastname

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

middlename

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

email

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

Параметрыоперации(повторяющаяся секция <operation>)

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

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

Свойствапакетаданных(внутри<result>)

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 include
MultiExcerptNameSertificat
PageWithExcerptБлоки документов