Page History
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 or SOAP method with parameters of the payment.
...
Parameter | Value |
merchant_id | The merchant 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, R - rejection, C -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) |
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. |
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, orderamount, ordercurrency,orderstate string representations (without delimiters). 2) For PGP type - empty |
errorcategory3 | Category of responses by unsuccessful payments received from VISA |
merchantadvicecode3 | |
slipno | Financial transaction identifier |
payment_Id1 | External operation ID |
fiscalreceipt_Id1 | Cheque ID |
status1 | Cheque status |
fiscal_receipt_number1 | Cheque number in the shift |
shift_number1 | Shift number |
receipt_datetime1 | Date and time of the document from FS |
total1 | The total amount of the document |
fn_number | FS number |
ecr_registration_number1 | CR registration number |
fiscal_document_number1 | Fiscal number of the document |
fiscal_document_attribute1 | Fiscal document attribute |
errortext1 | Error text |
taxationsystem1 | Code of the taxation system |
chequeItems2 | The string with the cheque items in the JSON format according to the document "Payment with cheque". |
extrrn3 | Unique payment number in processing |
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, 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) |
...
If the expected response setting is different from HTTP 200, then in response to the message about the payment results, the IPS Assist expects an xml package from the enterprise system.
The response must be generated depending on the Protocol Type setting in the Personal Account section Payment result options.
For POST protocol type
In case of the successful receiving and processing message the format of the replay packet should be:
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<pushpaymentresult firstcode="0" secondcode="0">
<order>
<billnumber>value</billnumber>
<packetdate>value</packetdate>
</order>
</pushpaymentresult> |
In case of failure:
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<pushpaymentresult firstcode="value" secondcode="value">
</pushpaymentresult> |
For SOAP protocol type
In case of the successful receiving and processing message the format of the replay packet should be:
...