Page History
...
Parameter | Mandatoryfield | Adoptedvalues | Defaultvalue | Description | ||||
Merchant_ID | Yes | Number | The enterprise identifier in IPS Assist | |||||
OrderNumber | Yes | 128 characters | Order number in the enterprise payments system | |||||
Delay | No | 0 – one-stage operation | 0 | Attribute of a bankcard authorization for the double-stage operation
| ||||
Language | No | RU – Russian, | Language of legal entity/enterprise | Language of authorization pages | ||||
OrderComment | No | 4000 characters | Comment | |||||
OrderAmount | Yes | Number, 15 digits, two digits after the delimiter (delimiter '.') | Payment amount, in original currency (e.g., 10.34) | |||||
OrderCurrency | No | 3 characters | Currency of legal entity/enterprise | Code of currency of the OrderAmount. | ||||
Lastname | No | 70 characters | Customer's last name | |||||
Firstname | No | 70 characters | Customer's first name | |||||
Middlename | No | 70 characters | Customer's middle name | |||||
No | 128 characters | Customer's e-mail | ||||||
Address | No | 256 characters | Customer's address | |||||
HomePhone | No | 64 characters | Customer's home phone number | |||||
WorkPhone | No | 20 characters | Customer's work phone number | |||||
MobilePhone | No | 20 characters | Customer's mobile phone number | Fax | No | 20 characters | Customer's fax number | |
Country | No | 3 characters | Customer's country | |||||
State | No | 3 characters | Customer's region | |||||
City | No | 70 characters | Customer's city | |||||
Zip | No | 25 characters | Customer's post zip code | |||||
URL_RETURN | No | 256 characters | Page URL, to where a customer should return after performing his/her payment in the system (option "Gototheshoppage" should be enabled in merchant's settings in Personal account). It is recommended to use HTTPS protocolfor securecommunication. | |||||
URL_RETURN_OK | No | 256 characters | URL_RETURN parameter value, or, if none, return URL parameter after successful authorization, specified in Personal account | Page URL, to where a customer should return after successful performing his/her payment in IPS Assist (option "Gototheshoppage" should be enabled in merchant's settings in Personal account). It is recommended to use HTTPS protocolfor securecommunication. | ||||
URL_RETURN_NO | No | 256 characters | URL_RETURN parameter value, or, if none, return URL specified in Personal account | Page URL, to where a customer should return if the payment is not performed in IPS Assist or payment is still in progress (current payment status "In Progress"), see details. The option "GototheshopusingreturnURL" should be enabled in merchant's settings in Personal account. It is recommended to use HTTPS protocolfor securecommunication. | ||||
CardPayment | No | 1 – payment with using bankcard; | 1 | A customer can perform his/her payment using bankcard, if parameter value 1 has been sent, or the parameter is missing (and bankcard payments are enable for the enterprise). | ||||
ERIPPayment | No | 1 – payment with using ERIP; | 1 | A customer can perform his/her payment using ERIP, if parameter value 1 has been sent, or the parameter is missing (and ERIP payments are enable for the enterprise). | ||||
MobiconPaymentGooglePayPayment | No | 1 – use Mobicon payment system,; 0 | 0 – without using Mobicon | 1 | Payment via Google Pay attribute (=1A customer can perform his/her payment using Mobicon payment system, if parameter value 1 has been sent, or the parameter is missing (and Mobicon payments are enable for the enterprise) | |||
ApplePayPayment | No | 1; 0 | 0 | Payment via ApplePay attribute (=1) | ||||
SamsungPayPayment | No | 1; 0 | 0 | Payment via SamsungPay attribute (=1) | ||||
Signature | No* | String | The string is joined according the determined rules. Then theMD5hash is preparedfromthisstring.HashissignedbyprivateRSAkeyofthemerchant.Keylengthis1024.Receivedbitsequenceisasignature.Signatureistransferred as BASE64codedstring.
| |||||
Checkvalue | No* | String | Request validation code. The string has to be generated as follows: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), where SALT – secret word; Х – the string joined according the determined rules. Note. If the merchant uses request validation code without delimiters, please, contact the support team support@belassist.by.
| |||||
RecurringIndicator | No | 1 – recurrent payment 0 – nonrecurrent payment | 0 | Recurring payment indicator. | ||||
RecurringMinAmount | No/Yes | Number, 15 digits, two digits after the delimiter (delimiter '.') | Min amount of recurrent payments. Mandatory if RecurringIndicator = 1 | |||||
RecurringMaxAmount | No/Yes | Number, 15 digits, two digits after the delimiter (delimiter '.') | Max Amount of recurrent payments. Mandatory if RecurringIndicator = 1 | |||||
RecurringPeriod | No/Yes | Number, 3 digits | Frequency of recurrent payments in days. Mandatory if RecurringIndicator = 1 | |||||
RecurringMaxDate | No/Yes | Date as string in DD.MM.YYYY format | The end date of recurrent payments. Mandatory if RecurringIndicator = 1 |
...
| Code Block | ||
|---|---|---|
| ||
http://URL return/?billnumber=complete_unique_order_number&ordernumber=order_number |
If the parameters URL_RETURN_OK and URL_RETURN_NO are not sent in the authorization request, then URL_RETURN parameter value is used for a customer's automatic redirection. If this parameter is also not sent, then the return URL_RETURN_OK and URL specified in "Merchants settings" section in Personal account are used.
| Note |
|---|
When customer returns to the merchant site the value of the order number is always transmitted as URL-encoded string: all non alpha-numeric characters (except '-' and '_'.) are replaced by the percent sign '%' followed by two digits hex code; spaces are replaced by '+' sign. This is important when the order number contains characters of non latin alphabet or some special symbols. |
When using the option of a customer's return to the shop, it is recommended to sent an additional request about the authorization result to IPS Assist server after receiving data about the paid order at URL_RETURN_OK (see details) in order to make sure the order payments have been performed. It is recommended as well to send an additional request about the authorization result to IPS Assist server after receiving data about the paid order at URL_RETURN and URL_RETURN_NO, because a customer is redirected to these addresses with different payment state, including the state "In process".