Versions Compared

Key

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

...

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 field for outputting the results in XML format

Code Block
languagexml
<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<!DOCTYPE result [
<!ATTLIST result
          firstcode CDATA #REQUIRED
          secondcode CDATA #REQUIRED
          count CDATA #REQUIRED>
<!ELEMENT result (payment*)>
<!ELEMENT payment (ordernumber?,billnumber?,testmode?,ordercomment?,orderamount?,ordercurrency?,amount?,currency?,rate?,firstname?,lastname?,middlename?,email?,clientip?,ipaddress?,meantype_id?,meantypename?,meansubtype?,meannumber?,cardholder?,issuebank?,bankcountry?,orderdate?,orderstate?,responsecode?,message?,customermessage?,recommendation?,approvalcode?,protocoltypename?,processingname?,operationtype?,operationdate?,authresult?,authrequired?, slipno?,packetdate?,signature?,checkvalue?,cardexpirationdate?,)>
<!ELEMENT ordernumber (#PCDATA)>
<!ELEMENT billnumber (#PCDATA)>
<!ELEMENT testmode (#PCDATA)>
<!ELEMENT ordercomment (#PCDATA)>
<!ELEMENT orderamount (#PCDATA)>
<!ELEMENT ordercurrency (#PCDATA)>
<!ELEMENT amount (#PCDATA)>
<!ELEMENT currency (#PCDATA)>
<!ELEMENT rate (#PCDATA)>
<!ELEMENT firstname (#PCDATA)>
<!ELEMENT lastname (#PCDATA)>
<!ELEMENT middlename (#PCDATA)>
<!ELEMENT email (#PCDATA)>
<!ELEMENT clientip (#PCDATA)>
<!ELEMENT ipaddress (#PCDATA)>
<!ELEMENT meantype_id (#PCDATA)>
<!ELEMENT meantypename (#PCDATA)>
<!ELEMENT meansubtype (#PCDATA)>
<!ELEMENT meannumber (#PCDATA)>
<!ELEMENT cardholder (#PCDATA)>
<!ELEMENT issuebank (#PCDATA)>
<!ELEMENT bankcountry (#PCDATA)>
<!ELEMENT orderdate (#PCDATA)>
<!ELEMENT orderstate (#PCDATA)>
<!ELEMENT responsecode (#PCDATA)>
<!ELEMENT message (#PCDATA)>
<!ELEMENT customermessage (#PCDATA)>
<!ELEMENT recommendation (#PCDATA)>
<!ELEMENT approvalcode (#PCDATA)>
<!ELEMENT protocoltypename (#PCDATA)>
<!ELEMENT processingname (#PCDATA)>
<!ELEMENT operationtype (#PCDATA)>
<!ELEMENT operationdate (#PCDATA)>
<!ELEMENT authresult (#PCDATA)>
<!ELEMENT authrequired (#PCDATA)>
<!ELEMENT slipno (#PCDATA)>
<!ELEMENT packetdate (#PCDATA)>
<!ELEMENT signature (#PCDATA)>
<!ELEMENT checkvalue (#PCDATA)>
<!ELEMENT cardexpirationdate (#PCDATA)>]>
<result firstcode='0' secondcode='0' count='17'>
<payment>
<ordernumber>0001-01</ordernumber>
<billnumber>511111100000001.1</billnumber>
<testmode>1</testmode>
<ordercomment>test payment</ordercomment>
<orderamount>100.00</orderamount>
<ordercurrency>BYN</ordercurrency>
<amount>100.00</amount>
<currency>BYN</currency>
<rate>1</rate>
<firstname>Test</firstname>
<lastname>Testov</lastname>
<middlename>Testovich</middlename>
<email>test@testpost.ru</email>
<clientip>111.23.11.23</clientip>
<ipaddress>0.0.0.0</ipaddress>
<meantype_id>1</meantype_id>
<meantypename>VISA</meantypename>
<meansubtype>Corporate Purchasing Card</meansubtype>
<meannumber>411111****1111</meannumber>
<cardholder>TEST</cardholder>
<issuebank>BANK </issuebank>
<bankcountry>Russia</bankcountry>
<orderdate>06.07.2016  08:39:25</orderdate>
<orderstate>Approved</orderstate>
<responsecode>AS000</responsecode>
<message>Success  </message>
<customermessage>Success  </customermessage>
<recommendation></recommendation>
<approvalcode>F31720</approvalcode>
<protocoltypename>NET</protocoltypename>
<processingname>Name</processingname>
<operationtype>100</operationtype>
<operationtdate>06.07.2016 06:39:42</operationdate>
<authresult/>
<authrequired>0</authrequired>
<slipno>111111</slipno>
<packetdate>06.07.2016 10:55:51</packetdate>
<checkvalue> </checkvalue>
<cardexpirationdate>12/20</cardexpirationdate>
</payment>
<payment>
...
</payment>
</result>

An example of field for outputting the results in CSV format:

Panel

"ordernumber";"billnumber";"testmode";"ordercomment";"orderamount";"ordercurrency";"amount";"currency";"rate";"firstname";"lastname";"middlename";"email";"clientip";"ipaddress";"meantype_id";"meantypename";"meansubtype";"meannumber";"cardholder";"issuebank";"bankcountry";"orderdate";"orderstate";"responsecode";"message";"customermessage";"recommendation";"approvalcode";"protocoltypename";"processingname";"operationtype";"operationdate";"authresult";"authrequired";"slipno";"packetdate";"checkvalue";"cardexpirationdate"; "001-1";"500000000000000.1";"0";"test payment";"70.00";"USD";"137.26";"BYN";"1.9608";"Testov";"упр";"S.";"test@test.by";"10.20.10.00";"0.0.0.0";"1";"VISA";"Classic";"411111****1111";"TEST";"New Bank";"Russia";"06.07.2016 07:51:42";"Paid";"AS000";"Completed.";"Completed.";"";"X28577";"NET";"Fake";"100";"06.07.2016 06:39:42";"";"0";"";"06.07.2016 12:27:32";"5189407747A5435E9E7A0C06A7BC18CD";"12/20";

If an error occurs, Web service will return the error first and second code values, for example, in XML format (in case of wrong password):

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

For the description of the first and second codes of the automated interfaces refer to Table   Codes of automated interfaces . Tables  Order State ,  Operation Type ,  Response Code  and  Currency codes  also include the descriptions of possible order statuses, types of operations, response codes and currency codes, respectively. The first 6 digits and the last 4 digits of the card number are returned as the field <meannumber> value; the other digits are hidden under symbol *.

The WEB-service description for SOAP format can be seen on page:

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

Replay example in SOAP format:

Code Block
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.paysecure.ru/ws/"><soapenv:Body>
<ws:resultbydateResponse><resultbydate><payment>
<ordernumber>18062012_SDR</ordernumber>
<billnumber>550000110000001.1</billnumber>
<testmode>1</testmode>
<ordercomment>test payment</ordercomment>
<orderamount>21.00</orderamount>
<ordercurrency>BYN</ordercurrency>
<amount>21.00</amount>
<currency>BYN</currency>
<rate>1</rate>
<firstname>Test</firstname>
<lastname>Testov</lastname>
<middlename>T.</middlename>
<email>test@test.by</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>
<issuebank>Bank</issuebank>
<bankcountry>RUS</bankcountry>
<orderdate>06.07.2016 11:10:06</orderdate>
<orderstate>Approved</orderstate>
<responsecode>AS000</responsecode>
<message>Success</message>
<customermessage>Success</customermessage>
<recommendation/>
<approvalcode>X40334</approvalcode>
<protocoltypename>NET</protocoltypename>
<processingname>Fake</processingname>
<operationtype>100</operationtype>
<operationdate>06.07.2016 11:10:07</operationdate>
<authresult/>
<authrequired>0</authrequired>
<slipno></slipno>
<packetdate>06.07.2016 11:22:37</packetdate>
<checkvalue>45A33F800F2BD16C02E3D2F5C81557A0</checkvalue>
<cardexpirationdate>12/20</cardexpirationdate></payment>
</resultbydate></ws:resultbydateResponse ></soapenv:Body></soapenv:Envelope>
Warning
titleAttention!

The following root certificates have to be installed on the requester side in the Trusted Root Certification Authorities Store for correct work with WEB-services via secure communication over TLS:

Before to start, check the presence of these certificates in the trust store and add tit if necessary.

...