www.assist.ru

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 36 Next »

To notify the merchant about payment results in real-time the IPS Assist provides the service for synchronous sending the results of the payment to the merchant server. After completion of the buyer payment (by bankcard or by e-cash) the message is being sent to the merchant server via HTTP POST method with parameters of the payment.

If the merchant works with the “Thank you from Sberbank” loyalty program, then the recommended protocol type for sending results is SOAP EXT (set up by support team support@assist.ru). 

In the Personal Account you can specify the URL for sending the results, the type of signature and the secret word.

After you configure and activate the service the results of payments by bankcards and electronic cash will be sent to the enterprise server. The results of payment confirmation, refunds and cancellations are not sent. Also the result of a payment which is closed by timeout is not sent.

If at the payment of the order were used bonus points from Sberbank, the result package will contain two order operations.

Attention! For security reasons results are sent only on ports 443, 8443, 80, 8080. No other ports can be used to receive the results!

To use the service through HTTPS a certificate from the trusted certification authority must be used, or support (support@assist.ru) should be contacted to obtain a personal certificate.

The list of the sent parameters:

Parameter

Value 

merchant_id

The enterprise identifier in IPS Assist

ordernumber

Order number

billnumber

Unique order number in IPS Assist

testmode

Test mode

ordercomment

Comment

orderamount

Original amount of order

ordercurrency

Original currency of order

amount

Order amount

currency

Order currency

rate

Currency rate

firstname

Payer's first name

lastname

Payer's last name

middlename

Payer's middle name

email

Payer's e-mail

clientip

Customer IP-address

ipaddress

Payer's IP-address

meantype_id

Payment means ID

meantypename

Type of payment means

meansubtype

Subtype of payment means

meannumber

Number of payment means

cardholder

Payment means holder

cardexpirationdate

Card expired date

issuebank

Issuing bank name

bankcountry

Country of issuing bank

orderdate

Date of order(GMT)

orderstate

Order status

responsecode

Response code

message

Message

customermessage

Result message for customer

recommendation

Recommendation

approvalcode

Authorization code

protocoltypename

Protocol

processingname

Processing name

operationtype

Operation type

operationdate

Operation date and time(GMT)

authresult

3Ds authorization result (Y – success, N - fail, A - Attempt, U – unknown)

authrequired

The card involvement in 3Ds check result (1 – involved, 0 – not involved, -1 – unknown, null – error appear during involvement check)

packetdate

Request date (GMT)

signature

1) For signature type MD5 - empty

2) For PGP type – an X value, signed by IPS Assist secret key and converted into BASE64 string. X value – is string concatenation of merchant_id, ordernumber, amount, currency, orderstate string representations (without delimiters). 

checkvalue

Request validation code

1) For signature type MD5 – calculated as: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), where SALT – the secret word; Х – is string concatenation of merchant_id, ordernumber, amount, currency, orderstate string representations (without delimiters). 

2) For PGP type – empty

slipno

Financial transaction identifier

payment_Id*

External operation ID

fiscalreceipt_Id*

Cheque ID

status*

Cheque status

fiscal_receipt_number*

Cheque number in the shift

shift_number*

Shift number

receipt_datetime*

Date and time of the document from FS

total*

The total amount of the document

fn_number

FS number

ecr_registration_number*

CR registration number

fiscal_document_number*

Fiscal number of the document

fiscal_document_attribute*

Fiscal document attribute

errortext*

Error text

taxationsystem*

Code of the taxation system

chequeItems**

The string with the cheque items in the JSON format according to the document "Payment with cheque".

3DSecure parameters

version

3DSecure protocol version

alphaauthresult

3Ds authorization result (Y – success, N - fail, A - Attempt, U – unable to authenticate, R – rejection, C –not completed for any reason, )

challenge

Interaction with the cardholder (C – yes, F – no)

eci

Electronic Commerce Indicator (5 – full authentication, 6 – authentication attempt, 7 – without authentication)

* Fiscalization parameters are sent only when the "Send fiscal results" option is enabled in the Personal Account of IPS Assist.

** Order items are sent only if the "Send order positions" option is enabled in the Personal Account of IPS Assist.

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.

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

<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:

<?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 "Codes of automated interfaces"

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.

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.

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:

<?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>

<?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>
            <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> 
              <operation>
                  <billnumber>5744015100953130.1</billnumber> 
                  <operationtype>100</operationtype> 
                  <operationstate>Success</operationstate> 
                  <amount>3740.85</amount> 
                  <currency>RUB</currency> 
                  <clientip>10.10.10.10</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>SAVINGS BANK OF THE RUSSIAN FEDERATION (SBERBANK)</issuebank> 
                  <bankcountry>Россия</bankcountry> 
                  <responsecode>AS000</responsecode> 
                  <message /> 
                  <customermessage>Completed.</customermessage> 
                  <recommendation>SUCCESSFUL AUTHORIZATION</recommendation> 
                  <approvalcode>X25932</approvalcode> 
                  <protocoltypename>NET</protocoltypename> 
                  <processingname>Fake</processingname> 
                  <operationdate>08.06.2012 07:09:44</operationdate> 
                  <authresult /> 
                  <authrequired>0</authrequired> 
                  <slipno></slipno>
                  <rrn>123456789</rrn>
              </operation>
              <operation>
                  <billnumber>5744015100953130.2</billnumber> 
                  <operationtype>100</operationtype> 
                  <operationstate>Success</operationstate> 
                  <amount>1259.15</amount> 
                  <currency>RUB</currency> 
                  <clientip>10.10.10.10</clientip> 
                  <ipaddress>0.0.0.0</ipaddress> 
                  <meantype_id>12</meantype_id> 
                  <meantypename>Points</meantypename> 
                  <meansubtype>Classic</meansubtype> 
                  <meannumber>411111****1111</meannumber> 
                  <cardholder>TEST</cardholder> 
                  <cardexpirationdate>12/20</cardexpirationdate>
                  <issuebank>SAVINGS BANK OF THE RUSSIAN FEDERATION (SBERBANK)</issuebank> 
                  <bankcountry>Россия</bankcountry> 
                  <responsecode>AS000</responsecode> 
                  <message /> 
                  <customermessage>Completed.</customermessage> 
                  <recommendation>SUCCESSFUL AUTHORIZATION</recommendation> 
                  <approvalcode>N/A</approvalcode> 
                  <protocoltypename /> 
                  <processingname>SberTest</processingname> 
                  <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>


Back on top