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 |
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; Х – the same as the X value is string generated according to determined rules. 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.