The processes of bankcard authorization (payment operation) and financial transaction (financial confirmation) in the double-stage operation mode are split.
Bankcard payment operation
At the first stage, the bankcard is authorized, its credit status is verified and the funds at the client's account are blocked. If the enterprise uses the double-stage operation mode, then, besides the mandatory and additional payment parameters (as described in section "Payment request"), there is a need to send the parameter Delay=1 in the authorization request.
<FORM ACTION=" https://<SERVER-NAME>/pay/order.cfm" METHOD="POST"> <INPUT TYPE="HIDDEN" NAME="Merchant_ID" VALUE="Your Merchant_ID"> <INPUT TYPE="HIDDEN" NAME="OrderNumber" VALUE="A20042011_28"> <INPUT TYPE="HIDDEN" NAME="OrderAmount" VALUE="237.40"> <INPUT TYPE="HIDDEN" NAME="OrderCurrency" VALUE="USD"> <INPUT TYPE="HIDDEN" NAME="Delay" VALUE="1"> <INPUT TYPE="HIDDEN" NAME="Language" VALUE="RU"> <INPUT TYPE="HIDDEN" NAME="Email" VALUE="test@test.by"> <INPUT TYPE="HIDDEN" NAME="OrderComment" VALUE="Order payment 28-A"> <INPUT TYPE="HIDDEN" NAME="URL_RETURN_OK" VALUE="http://www.URL.by/yes"> <INPUT TYPE="HIDDEN" NAME="URL_RETURN_NO" VALUE="http://www.URL.by/no"> <INPUT TYPE="HIDDEN" NAME="CardPayment" VALUE="1"> <INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Buy"> </FORM>
After pressing this button, a customer is automatically redirected to IPS Assist payment pages, where he/she enters his/her personal data and the card information for the payment operation to be completed. The payment operation can be both successfully completed and failed. After successfully completing the payment operation in the enterprise's double-stage operation mode, the order adopts the status Delayed in IPS Assist (Payment confirmation in process); order statuses are listed in table "OrderState field values".
At the second stage, after successfully completed payment operation, the enterprise performs the payment confirmation operation. A financial transaction is sent for processing only after the payment has been confirmed.
Attention! When the double-stage operation mode is used the customer's account is withdrawn only after the payment has been confirmed by Internet-shop.
Payment confirmation
Internet-shop can issue a financial confirmation within 2 days in Personal account, or using Web service.
To confirm the payment, send a request to IPS Assist server via HTTP POST or SOAP method (in UTF-8 coding).
The request URL for the financial confirmation transmission:
https://<SERVER-NAME>/charge/charge.cfm.
List of payment confirmation parameters for the enterprise's double-stage operation mode is given in table below:
Parameter | Mandatory field | Adopted values | Default values | Description |
Billnumber | Yes | 15 or 16 digits, extended payment number | Unique number of payment corresponding to the order number in IPS Assist; extended payment number can be passed | |
Merchant_ID | Yes | Number | The enterprise identifier in IPS Assist | |
Login | Yes | 20 characters | Login (Latin letters, digits and symbol _) | |
Password | Yes | 30 characters | Password (Latin letters and digits) | |
Amount | No* | 15 digits, two digits after the delimiter (delimiter '.') | The amount of financial confirmation | |
Currency | No* | 3 characters | Confirmation currency code. Only the currency code of the payment operation can be used. | |
ClientIP | No | IP-address of the operator's computer that confirms the payment | ||
Language | No | RU – Russian | RU | Language of the results output |
Format | No | 1 – CSV (delimited fields) | 1 | Format of the results output. If the request is sent in JSON format, then the response will also be in JSON, in other cases, in accordance with the passed format value. |
| AutoDeposit | No | 1 – flag on 0 – flag off | Online deposit flag. It is used in cases when it is necessary to immediately unblock the unconfirmed part of the order amount. |
* The parameters Amount and Currency can be passed or missed in the request only simultaneously. If the above parameters are missing, the full amount confirmation operation will be performed.
All request parameters are automatically validated. The validation rules are given in table "The validation rules for input parameters".
The confirmation can be performed to both the complete amount and a part of the amount. It is allowed to issue a partial confirmation of amount not exceeding the amount of payment, if the payment operation by bankcard was completed through processing with correspondent settings.
Please, note that confirmation amount should be provided (using both Personal account and Web service) in the same currency which was used in the payment operation (normally, in Roubles).
The parameter billnumber can be passed either in ordinary format (when there was only one successful payment on this order) or in extended format in the confirmation. While using the extended format it is required to provide the exact number of the successful authorization operation (in some cases it can be not a first operation in the order, 500000000000001.2 for example).
The payment confirmation operation is always successful, unless declined due to technical failure. In case of a technical failure, the payment should be confirmed again. The repeated payment confirmation does not result in a repeated cash withdrawal.
If the payment has been successfully confirmed, the order in IPS Assist adopts the status Approved or PartialDelayed, the Response_code is AS000.
The service description for SOAP format can be found on page:
https://<SERVER-NAME>/charge/charge.wsdl
