Page History
...
Parameter | Mandatory field | Adopted values | Default value | Description |
Ordernumber | Yes | String, 128 characters | Order number | |
Merchant_ID | Yes | Number | The enterprise identifier in IPS Assist | |
Login | Yes | 8 - 20 characters | Login (Latin letters, digits and symbol _) | |
Password | Yes | 8 - 20 characters | Password (Latin letters and digits) | |
StartYear | No | Year in "2011" format | Minus three days from the current date | Sampling start date (GMT) |
StartMonth | No | 1 - 12 | Minus three days from the current date | |
StartDay | No | 1 - 31 | Minus three days from the current date | |
StartHour | No | 0 - 23 | Minus three days from the current date | |
StartMin | No | 0 - 59 | Minus three days from the current date | |
EndYear | No | Year in "2011" format | Current year | Sampling end date (GMT) |
EndMonth | No | 1 - 12 | Current month | |
EndDay | No | 1 - 31 | Current day | |
EndHour | No | 0 - 23 | Current hour | |
EndMin | No | 0 - 59 | Current minute | |
Language | No | RU EN | EN | Language of the results output |
Format | Yes/No | 3 – - XML | 3 | Format of the results output. Passed only for a request in POST format (by default, the response will be returned in XML format). For other formats, the response is returned in the same format in which the request was made. |
...
Parameter | Value |
Order parameters | |
billnumber | Unique order number in IPS Assist |
ordernumber | Order number |
testmode | Test mode |
ordercomment | Comment |
orderamount | Original amount of order |
ordercurrency | Original currency of order |
firstname | Payer's first name |
lastname | Payer's last name |
middlename | Payer's middle name |
Payer's e-mail | |
orderdate | Date of order |
orderstate | Order status |
errorcode2 | |
packetdate | Request issue date |
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. |
checkvalue | 1) For PGP type – - empty; 2) For MD5 type – - uppercase(md5(uppercase(md5(SALT) + md5(Х)))), where SALT - – - secret word; Х – - result of the following parameters string concatenation: merchant_id, ordernumber, orderamount, ordercurrency, orderstate (without delimiters), + means string concatenation. |
errorcategory3 | Category of responses by unsuccessful payments received from VISA |
merchantadvicecode3 | |
Operation parameters | |
billnumber | Extended format of billnumber |
operationtype | Operation type |
operationstate | Operation status |
amount | Operation amount |
currency | Currency of operation |
ipaddress | Payer's IP-address |
clientip | Transactor's IP-address |
meantype_id | Type of payment means |
meansubtype | Payment means subtype |
meannumber | Number of payment means |
cardholder | Payment means holder |
cardexpirationdate | Card expired date |
issuebank | Name of issue bank |
bankcountry | Country of issue bank |
responsecode | Response code |
message | Operation result message |
customermessage | Result message for a customer |
recommendation | Recommendation |
approvalcode | Authorization code |
protocolname | Protocol |
processingname | Processing |
operationdate | Operation date and time (GMT) |
authresult | 3Ds authorization result (Y – - success, N - fail, A - Attempt, U – - unknown, R – - rejection, C –not -not completed for any reason, E - error) |
authrequired | The card involvement in 3Ds check result (1 – - involved, 0 – - not involved, -1 – - unknown, null – - error appear during involvement check) |
slipno | Financial transaction identifier |
errorcode2 | |
chequeItems1 | The string with the cheque items in the JSON format according to the section "Payment with cheque". |
extrrn3 | Unique payment number in processing |
externalrefundid4 | External refund ID |
3DSecure parameters | |
version | 3DSecure protocol version |
alphaauthresult | 3Ds authorization result (Y – - success, N - fail, A - Attempt, U – - unable to authenticate, R – - rejection, C –not -not completed for any reason, E - error, I - Informational Only, S - without authentication due to low risk score) |
challenge | Interaction with the cardholder (C – - yes, F – - no, D - Decoupled Authentication) |
eci | Electronic Commerce Indicator (5 – - full authentication, 6 – - authentication attempt, 7 – - without authentication) |
Anchor 1 1
...
| Anchor | ||||
|---|---|---|---|---|
|
2To transfer this parameter, please, contact the support service (support@assist.ru).Important features of using the parameterparameter, please, contact the support service (support@assist.ru).
| Expand | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
The parameter is useful for orders in Declined and Timeout statuses, it helps to identify a payment error (for example, to build a report on various errors), but it does not determine the payment status. The parameter will be present in both the operation data block and the order data block. In most cases, the errorcode parameter will be 0 for an order. This does not mean that the order has been successfully paid. This means that there is no error code at the order level. The payment status is determined by the orderstate and the responsecode. In addition, an order that does not contain an operation can be created (and subsequently closed with an error). An example of a request result for an order without an operation:
An example of a request result for an order with an operation:
|
| Anchor | ||||
|---|---|---|---|---|
|
3To transfer this parameter, please, contact the support service (support@assist.ru).
...
| Code Block | ||
|---|---|---|
| ||
<?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:orderresultResponse><orderresult>
<order>
<ordernumber>13032014_122</ordernumber>
<billnumber>5500069208498005</billnumber>
<testmode>1</testmode>
<ordercomment>тестовый платеж</ordercomment>
<orderamount>331.39</orderamount>
<ordercurrency>RUB</ordercurrency>
<firstname>Test</firstname>
<lastname>Testov</lastname>
<middlename>T.</middlename>
<email>test@test.ru</email>
<orderdate>13.03.2014 13:38:24</orderdate>
<orderstate>Timeout</orderstate>
<packetdate>13.03.2014 14:55</packetdate>
<signature></signature>
<checkvalue>863F176DC699131758B2230EA93BC911</checkvalue>
</order>
<order>
<ordernumber>13032014_122</ordernumber>
<billnumber>5500069208498070</billnumber>
<testmode>1</testmode>
<ordercomment>тестовый платеж</ordercomment>
<orderamount>331.39</orderamount>
<ordercurrency>RUB</ordercurrency>
<firstname>Test</firstname>
<lastname>Testov</lastname>
<middlename>T.</middlename>
<email>test@test.ru</email>
<orderdate>13.03.2014 14:52:09</orderdate>
<orderstate>Approved</orderstate>
<packetdate>13.03.2014 14:55</packetdate>
<signature></signature>
<checkvalue>E458CD73F1AA3F994F4D97C40613FD0A</checkvalue>
<operation>
<billnumber>5500069208498070.1</billnumber>
<operationtype>100</operationtype>
<operationstate>Success</operationstate>
<amount>331.39</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>Busines</meansubtype>
<meannumber>462710****4724</meannumber>
<cardholder>TEST</cardholder>
<cardexpirationdate>12/20</cardexpirationdate>
<issuebank>Bank</issuebank>
<bankcountry>RUS</bankcountry>
<responsecode>AS000</responsecode>
<message> </message>
<customermessage> </customermessage>
<recommendation></recommendation>
<approvalcode>X53576</approvalcode>
<protocoltypename>NET</protocoltypename>
<processingname>Fake</processingname>
<operationdate>13.03.2014 14:52:10</operationdate>
<authresult></authresult>
<authrequired>0</authrequired>
<slipno>111111</slipno>
<chequeitems>
{"items":[{"id":1,"price":"20.00","quantity":"3","amount":"60.00","tax":"vat10",
"product":"Sugar","name":"Sugar","fpmode":"1"},{"id":2,"price":"20.11","quantity":
"3.55","amount":"71.39","tax":"vat20","product":"Milk","name":"Milk",
"fpmode":"1"},{"id":3,"price":"200.00","quantity":"1","amount":"200.00",
"tax":"novat","product":"Butter","name":"Butter","fpmode":"3}]}
</chequeitems>
<threedsdata>
<version>1.0.0</version>
<alphaauthresult>C</alphaauthresult>
<challenge>C</challenge>
<eci></eci>
</threedsdata>
</operation>
<operation>
<billnumber>5500069208498070.2</billnumber>
<operationtype>200</operationtype>
<operationstate>Success</operationstate>
<amount>331.39</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>Busines</meansubtype>
<meannumber>462710****4724</meannumber>
<cardholder>TEST</cardholder>
<cardexpirationdate>12/20</cardexpirationdate>
<issuebank>Bank</issuebank>
<bankcountry>RUS</bankcountry>
<responsecode>AS000</responsecode>
<message> </message>
<customermessage> </customermessage>
<recommendation></recommendation>
<approvalcode></approvalcode>
<protocoltypename></protocoltypename>
<processingname>Fake</processingname>
<operationdate>13.03.2014 14:53:37</operationdate>
<authresult></authresult>
<authrequired>0</authrequired>
<slipno>111111</slipno>
<chequeitems>
{"items":[{"id":1,"price":"20.00","quantity":"3","amount":"60.00","tax":"vat10",
"product":"Sugar","name":"Sugar","fpmode":"1"},{"id":2,"price":"20.11","quantity":
"3.55","amount":"71.39","tax":"vat20","product":"Milk","name":"Milk",
"fpmode":"1"},{"id":3,"price":"200.00","quantity":"1","amount":"200.00",
"tax":"novat","product":"Butter","name":"Butter","fpmode":"3}]}
</chequeitems>
<threedsdata>
<version>1.0.0</version>
<alphaauthresult>Y</alphaauthresult>
<challenge>C</challenge>
<eci>5</eci>
</threedsdata>
</operation>
</order>
</orderresult></ws:orderresultResponse></soapenv:Body></soapenv:Envelope> |
| Warning |
|---|
Attention! The The following root certificate has 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 this certificate these certificates in the trust store and add tit if necessary. |
...