Page History

Versions Compared

Key

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

...

Expand

title	If the merchant works with the “Thank you from Sberbank” loyalty program

An additional parameter is passed in SOAP EXT format is passed

rrn	The unique number of transactions in the exchange between banks

The IPS Assist waits for the XML packet from the enterprise system as replay on the payment result message.

...

Expand

title	An example of request result in SOAP format:

Code Block

language	xml

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC

<?xml version="1.0" encoding="utf-8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/

encoding

envelope/" xmlns:

xsi

ws="http://www.

paysecure.

org

ru/

2001

ws/

XMLSchema-instance

xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <SOAP-ENV:Body> <m:PushPaymentResultResponse xmlns:m="http://www.assist.ru/wsdl"> <return xmlns:si="http://www.assist.ru/type/" xsi:type="si:SOAPStruct"> <billnumber>5696145241469255.1</billnumber> <packetdate>26.06.2019 08:44:00</packetdate> </return> </m:PushPaymentResultResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

In case of failure:

Code Block

language	xml

<?xml version="1.0" encoding="windows-1251"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 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/">
            <SOAP-ENV:Fault>
                <faultcode>5</faultcode>
                <faultstring>143</faultstring>
                <detail />
            </SOAP-ENV:Fault>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

For the description of the first and second codes of the automated interfaces refer to table "Error codes"

If there is no answer from the merchant (either about success or about failure in the message handling) the system repeats the message sending with increasing intervals during the four hours but not more than 8 times.

Warning
Attention! When the received replay indicates a failure in message handling the sending of payment results is not repeated. Values of firstcode, secondcode are used for used to diagnose the problems.

Warning
Attention! The testmode value of response has to be checked. If the payment was made in test mode (testmode = 1), then the shipment of goods or providing of services for the current request is not required.

An example of request result in SOAP format:

><soapenv:Body>
<ws:PushPaymentResult>
<merchant_id>500001</merchant_id> 
<ordernumber>18062012_SDR</ordernumber> 
<billnumber>550000110000001.1</billnumber> 
<testmode>1</testmode> 
 <ordercomment>тестовый платеж</ordercomment> 
 <orderamount>21.00</orderamount> 
 <ordercurrency>RUB</ordercurrency> 
 <amount>21.00</amount> 
 <currency>RUB</currency> 
 <rate>1</rate> 
 <firstname>Test</firstname> 
 <lastname>Testov</lastname> 
 <middlename>T.</middlename> 
 <email>test@test.ru</email> 
 <clientip>10.10.10.10</clientip> 
 <ipaddress>0.0.0.0</ipaddress> 
 <meantype_id>2</meantype_id> 
 <meantypename>MasterCard</meantypename> 
 <meansubtype>Standart</meansubtype> 
 <meannumber>546792****4128</meannumber> 
 <cardholder>TEST</cardholder> 
 <cardexpirationdate>12/20</cardexpirationdate>
 <issuebank>Bank</issuebank> 
 <bankcountry>RUS</bankcountry> 
 <orderdate>18.06.2012 11:10:06</orderdate> 
 <orderstate>Approved</orderstate> 
 <responsecode>AS000</responsecode> 
 <message /> 
 <customermessage>Завершено успешно.</customermessage> 
 <recommendation>SUCCESSFUL AUTHORIZATION</recommendation> 
 <approvalcode>X40334</approvalcode> 
 <protocoltypename>NET</protocoltypename> 
 <processingname>Fake</processingname> 
 <operationtype>100</operationtype> 
 <operationdate>18.06.2012 11:10:07</operationdate> 
 <authresult /> 
 <authrequired>0</authrequired> 
 <packetdate>18.06.2012 11:11:02</packetdate> 
 <signature /> 
 <checkvalue>45A33F800F2BD16C02E3D2F5C81557A0</checkvalue>
 <threedsdata>
    <version>1.0.0</version>
    <alphaauthresult>Y</alphaauthresult>
    <challenge>C</challenge>
    <eci>5</eci>
 </threedsdata>
</ws: PushPaymentResul></soapenv:Body></soapenv:Envelope>

Expand

title	An example of request result in SOAP format (for the case of payment of the order by the card and by the bonus points - two successful payment operations):

Code Block

language	xml

<?xml version="1.0" encoding="utf-8" ?> 
<soapenv

Code Block

language	xml

Expand

title	An example of request result in SOAP format (for the case of payment of the order by the card and by the bonus points - two successful payment operations):

<?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:PushPaymentResult> <merchant_id>500001</merchant_id> <ordernumber>18062012_SDR</ordernumber> <billnumber>550000110000001.1</billnumber> <testmode>1</testmode> <ordercomment>тестовый платеж</ordercomment> <orderamount>21.00</orderamount> <ordercurrency>RUB</ordercurrency> <amount>21.00</amount> <currency>RUB</currency> <rate>1</rate> <firstname>Test</firstname> <lastname>Testov</lastname> <middlename>T.</middlename> <email>test@test.ru</email> <clientip>10.10.10.10</clientip> <ipaddress>0.0.0.0</ipaddress> <meantype_id>2</meantype_id> <meantypename>MasterCard</meantypename> <meansubtype>Standart</meansubtype> <meannumber>546792****4128</meannumber> <cardholder>TEST</cardholder> <cardexpirationdate>12/20</cardexpirationdate> <issuebank>Bank</issuebank> <bankcountry>RUS</bankcountry> <orderdate>18.06.2012 11:10:06</orderdate> <orderstate>Approved</orderstate> <responsecode>AS000</responsecode> <message /> <customermessage>Завершено успешно.</customermessage> <recommendation>SUCCESSFUL AUTHORIZATION</recommendation> <approvalcode>X40334</approvalcode> <protocoltypename>NET</protocoltypename> <processingname>Fake</processingname> <operationtype>100</operationtype> <operationdate>18.06.2012 11:10:07</operationdate> <authresult /> <authrequired>0</authrequired> <packetdate>18.06.2012 11:11:02</packetdate> <signature /> <checkvalue>45A33F800F2BD16C02E3D2F5C81557A0</checkvalue> <threedsdata> <version>1.0.0</version> <alphaauthresult>Y</alphaauthresult> <challenge>C</challenge> <eci>5</eci> </threedsdata> </ws: PushPaymentResul></soapenv:Body></soapenv:Envelope>

Multiexcerpt include

MultiExcerptName	slipno
PageWithExcerpt	Doc blocks

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:PushPaymentResult>
>
    <soapenv:Body>
        <ws:PushPaymentResult>
            <order>
              <merchant_id>744015</merchant_id> 
              <ordernumber>20120608-744015-001</ordernumber> 
              <billnumber>5744015100953130</billnumber> 
              <testmode>1</testmode> 
              <ordercomment>Sber 744015</ordercomment> 
              <orderamount>5000.00</orderamount> 
              <ordercurrency>RUB</ordercurrency> 
              <firstname>TestS</firstname> 
              <lastname>TestovS</lastname> 
              <middlename /> 
              <email>test@test.ru</email> 
              <orderdate>08.06.2012 07:09:01</orderdate> 
              <orderstate>Approved</orderstate> <order>
              <merchant_id>744015</merchant_id> <operation>
              <ordernumber>20120608-744015-001</ordernumber> 
   <billnumber>5744015100953130.1</billnumber> 
          <billnumber>5744015100953130</billnumber> 
       <operationtype>100</operationtype> 
      <testmode>1</testmode> 
           <operationstate>Success</operationstate> 
  <ordercomment>Sber 744015</ordercomment> 
              <orderamount>5000<amount>3740.00<85</orderamount>amount> 
              <ordercurrency>RUB</ordercurrency> 
   <currency>RUB</currency>   
        <firstname>TestS</firstname> 
         <clientip>10.10.10.10</clientip> 
    <lastname>TestovS</lastname> 
              <middlename /><ipaddress>0.0.0.0</ipaddress> 
              <email>test@test.ru</email> 
   <meantype_id>1</meantype_id> 
          <orderdate>08.06.2012 07:09:01</orderdate> 
      <meantypename>VISA</meantypename> 
       <orderstate>Approved</orderstate> 
          <meansubtype>Classic</meansubtype> 
   <operation>
                  <billnumber>5744015100953130.1</billnumber><meannumber>411111****1111</meannumber> 
                  <operationtype>100<<cardholder>TEST</operationtype>cardholder> 
                  <operationstate>Success</operationstate> 
<cardexpirationdate>12/20</cardexpirationdate>
                  <issuebank>SAVINGS BANK OF  <amount>3740.85</amount>THE RUSSIAN FEDERATION (SBERBANK)</issuebank> 
                  <currency>RUB<<bankcountry>Россия</currency>bankcountry> 
                  <clientip>10.10.10.10</clientip><responsecode>AS000</responsecode> 
                   <ipaddress>0.0.0.0</ipaddress><message /> 
                  <meantype_id>1</meantype_id><customermessage>Completed.</customermessage> 
                  <recommendation>SUCCESSFUL <meantypename>VISA<AUTHORIZATION</meantypename>recommendation> 
                  <meansubtype>Classic<<approvalcode>X25932</meansubtype>approvalcode> 
                  <meannumber>411111****1111</meannumber><protocoltypename>NET</protocoltypename> 
                  <cardholder>TEST<<processingname>Fake</cardholder>processingname> 
                   <cardexpirationdate>12/20</cardexpirationdate><operationdate>08.06.2012 07:09:44</operationdate> 
                  <issuebank>SAVINGS<authresult BANK/> OF
 THE RUSSIAN FEDERATION (SBERBANK)</issuebank> 
                  <bankcountry>Россия</bankcountry><authrequired>0</authrequired> 
                  <responsecode>AS000<<slipno></responsecode> slipno>
                  <message <rrn>123456789</> rrn>
                  <customermessage>Completed.</customermessage> operation>
                  <recommendation>SUCCESSFUL AUTHORIZATION</recommendation> <operation>
                  <approvalcode>X25932<<billnumber>5744015100953130.2</approvalcode>billnumber> 
                  <protocoltypename>NET<<operationtype>100</protocoltypename>operationtype> 
                  <processingname>Fake<<operationstate>Success</processingname>operationstate> 
                  <operationdate>08.06.2012 07:09:44</operationdate><amount>1259.15</amount> 
                  <authresult <currency>RUB</>currency> 
                  <authrequired>0</authrequired><clientip>10.10.10.10</clientip> 
                  <slipno></slipno><ipaddress>0.0.0.0</ipaddress> 
                  <rrn>123456789</rrn>
<meantype_id>12</meantype_id> 
                  <<meantypename>Points</operation>meantypename> 
               <operation>
   <meansubtype>Classic</meansubtype> 
              <billnumber>5744015100953130.2</billnumber>    <meannumber>411111****1111</meannumber> 
                  <operationtype>100<<cardholder>TEST</operationtype>cardholder> 
                  <operationstate>Success</operationstate> 
<cardexpirationdate>12/20</cardexpirationdate>
                  <issuebank>SAVINGS BANK OF  <amount>1259.15</amount>THE RUSSIAN FEDERATION (SBERBANK)</issuebank> 
                  <currency>RUB<<bankcountry>Россия</currency>bankcountry> 
                  <clientip>10.10.10.10</clientip><responsecode>AS000</responsecode> 
                   <ipaddress>0.0.0.0</ipaddress><message /> 
                  <meantype_id>12</meantype_id><customermessage>Completed.</customermessage> 
                  <recommendation>SUCCESSFUL <meantypename>Points<AUTHORIZATION</meantypename>recommendation> 
                  <meansubtype>Classic<<approvalcode>N/A</meansubtype>approvalcode> 
                  <protocoltypename <meannumber>411111****1111</meannumber>/> 
                  <cardholder>TEST<<processingname>SberTest</cardholder>processingname> 
                   <cardexpirationdate>12/20</cardexpirationdate><operationdate>08.06.2012 07:10:51</operationdate> 
                  <issuebank>SAVINGS<authresult BANK/> OF
 THE RUSSIAN FEDERATION (SBERBANK)</issuebank> 
               <authrequired   <bankcountry>Россия</bankcountry>> 
                  <responsecode>AS000<<slipno></responsecode> slipno>
                  <message <rrn></> rrn>
              </operation>
    <customermessage>Completed.</customermessage> 
      </order>
            <recommendation>SUCCESSFUL AUTHORIZATION</recommendation><packetdate>08.06.2012 07:11:04</packetdate> 
           <signature /> 
     <approvalcode>N/A</approvalcode> 
                  <protocoltypename /><checkvalue>B739961F5CF27F9D90376B3B21517856</checkvalue> 
                  <processingname>SberTest</processingname> </ws:PushPaymentResult>
                  <operationdate>08.06.2012 07:10:51</operationdate> 
                  <authresult /> 
                  <authrequired /> 
                  <slipno></slipno>
                  <rrn></rrn>
              </operation>
           </order>
           <packetdate>08.06.2012 07:11:04</packetdate> 
           <signature /> 
           <checkvalue>B739961F5CF27F9D90376B3B21517856</checkvalue> 
        </ws:PushPaymentResult>
    </soapenv:Body>
</soapenv:Envelope>

</soapenv:Body>
</soapenv:Envelope>

The IPS Assist waits for the XML packet from the enterprise system as replay on the payment result message.

In case of the successful receiving and processing message the format of the replay packet should be:

Code Block

language	xml

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SOAP-ENV:Body>
  <m:PushPaymentResultResponse xmlns:m="http://www.assist.ru/wsdl">
  <return xmlns:si="http://www.assist.ru/type/" xsi:type="si:SOAPStruct">
    <billnumber>5696145241469255.1</billnumber>
    <packetdate>26.06.2019 08:44:00</packetdate>
  </return>
  </m:PushPaymentResultResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

In case of failure:

Code Block

language	xml

<?xml version="1.0" encoding="windows-1251"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 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/">
            <SOAP-ENV:Fault>
                <faultcode>5</faultcode>
                <faultstring>143</faultstring>
                <detail />
            </SOAP-ENV:Fault>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

For the description of the first and second codes of the automated interfaces refer to table "Error codes"

Warning
Attention! When the received replay indicates a failure in message handling the sending of payment results is not repeated. Values of firstcode, secondcode are used for used to diagnose the problems.

Warning
Attention! The testmode value of response has to be checked. If the payment was made in test mode (testmode = 1), then the shipment of goods or providing of services for the current request is not required.

Multiexcerpt include

MultiExcerptName	slipno
PageWithExcerpt	Doc blocks

Back on top

Content

Space Tools

Versions Compared

Old Version 47

New Version 48

Key