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