Receiving operations results by order number

If the merchant requires not only the information about the order status (approved, cancelled, payment confirmation in process), but also a detailed information about the operations (payment, payment approval, return or cancellation) executed with regards to this order, the merchant can use Web service to receive the results of the operations under a given order number.

To receive the payment result by order number, send a request to IPS Assist server via HTTP POST or SOAP method (in UTF-8 coding).

The request URL for receiving the payment result with a list of operations within the order:

https://<SERVER-NAME>/orderresult/orderresult.cfm.

The order search using Web service can be performed only for the specified time period. The default sampling end date is taken to be the current date, while the default sampling start date is the current date, minus three days.

List of request parameters

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 4 - SOAP	4	Format of the results output. It is not mandatory in case of SOAP request format and mandatory for POST

Request example for HTTP POST format:

<FORM ACTION="https://<SERVER-NAME>/orderresult/orderresult.cfm" METHOD="POST">
<INPUT TYPE="HIDDEN" NAME="Ordernumber" VALUE="1001-01">
<INPUT TYPE="HIDDEN" NAME="Merchant_ID" VALUE="Your Merchant_ID">
<INPUT TYPE="HIDDEN" NAME="Login" VALUE="Your login">
<INPUT TYPE="HIDDEN" NAME="Password" VALUE="Your password">
<INPUT TYPE="HIDDEN" NAME="Startyear" VALUE="2011">
<INPUT TYPE="HIDDEN" NAME="Startmonth" VALUE="04">
<INPUT TYPE="HIDDEN" NAME="Startday" VALUE="01">
<INPUT TYPE="HIDDEN" NAME="Starthour" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Startmin" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Endyear" VALUE="2011">
<INPUT TYPE="HIDDEN" NAME="Endmonth" VALUE="04">
<INPUT TYPE="HIDDEN" NAME="Endday" VALUE="02">
<INPUT TYPE="HIDDEN" NAME="Endhour" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Endmin" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Format" VALUE="3">
<INPUT TYPE="HIDDEN" NAME="Language" VALUE="EN">
<INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Execute">
</FORM>

List of response parameters:

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
Email	Payer's e-mail
orderdate	Date of order
orderstate	Order status
packetdate	Request issue date
signature	Signature
checkvalue	uppercase(md5(uppercase(md5(SALT) + md5(Х)))), where SALT – secret word; Х – is string generated according to determined rules.
*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)
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
chequeItems*	The string with the cheque items in the JSON format according to the section "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)

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

Attention! Please, note that several operations can be created within one order (payment, payment confirmation, cancellation). Furthermore, there can be several payment operations within one order, if some of them were unsuccessful. The order can have the only one successful payment operation. Thus there can be several enclosed operations within one order number in the response to a request for the operations results.

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 a request result in XML format:

Content

Space Tools