“The “Settlement” system is an automated information system of a single settlement and information space (SSIS) created by the National Bank of the Republic of Belarus in order to simplify the organization of accepting payments from individuals and legal entities.
Payment through SSIS allows you to pay for a purchase from your card account using Internet banking, ATMs and information kiosks of many banks in the Republic of Belarus. You can pay in cash through SSIS at bank cash desks or through cash-in devices.
This document is intended for merchants wishing to accept payments for goods/services on their websites using SSIS. Organization of payment using SSIS is carried out through IPS Assist.
Using SSIS, you can make on-demand payments or advance payments.
On-demand payments are made by the customer at a time when buying a product/service.
The web service for creating an invoice accepts invoice parameters (HTTP POST/SOAP formats) and returns (if the invoice is created successfully) the payment token/ID corresponding to this invoice. IPS Assist sends a notification via E-mail to the customer's address specified in the parameters with the order number (payment token/ID) for payment in the SSIS system.
Subj | Вам выставлен счет для оплаты |
Text | Здравствуйте, Тестов Тест Тестович, Сообщаем, что для вас был сформирован счет № 15912778124 на сумму 88.80 BYN Вы можете оплатить его в срок до 11.09.2020 16:36:55 (GMT +03:00). Для оплаты счета воспользуйтесь системой «Расчёт» (ЕРИП). Для быстрого поиска используйте код услуги ЕРИП (481287) Номер заказа в системе ЕРИП: 15912778124 По всем вопросам, связанным этим счетом, пожалуйста, обращайтесь в интернет-магазин №1 по адресу: shop1@testpost.by _____________ С уважением, Отдел технической поддержки ASSIST |
The notification template must be discussed with support service (support@belassist.by).
The customer can pay the invoice in the SSIS system at any time within the specified period. To set up a due date for paying invoices, the merchant should contact the technical support service (support@belassist.by).
Request URL to create an invoice:
https://<SERVER-NAME>/bill/createbill.cfm
List of request parameters:
Parameter | Mandatory field | Adopted values | Default value | Description |
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) | |
Bill | Yes/No* | 30 characters (digits and latin letters) | Unique bill number (in creating order will be used as OrderNumber, and also as a number for payment in SSIS) | |
Bill_amount | Yes | Number | Bill amount (OrderAmount in order) | |
Bill_currency | Yes | String | Bill currency (OrderCurrency BYN only) | |
Bill_comment | No | String | Comment (OrderComment in order) | |
Customer_Name | No | String | Customer's name (FirstName in order) | |
Customer_Lastname | No | String | Customer's last name (LastName in order) | |
Customer_Middlename | No | String | Customer's middle name (MiddleName in order) | |
Customer_Email | Yes/No** | String | Customer's e-mail (Email in order) | |
Customer_Phone | No | String | Customer's phone number (HomePhone in order) | |
Customer_Mobile | No | String | Customer's mobile phone number (MobilePhone in order) | |
Language | No | RU EN | Setting of basic merchant account language | Language of authorized pages |
Pay_until | No | Date/time | 1 day | Expire date of bill payment (date and time in GMT): YYYYMMDDThhmm, when parameter is not passed then its value is calculated based on merchant settings |
SendNotification | No | Number | Depending on merchant settings | Bill sending by E-mail: 0 – not send, 1 – send by E-mail |
Checkvalue | Yes | String | Request validation code*** |
*parameter Bill is not mandatory in case when automatic bill numbering is switched on.
**If the value of the E-mail address is not sent, sending the bill by E-mail is not possible and the SendNotification value is ignored.
***Check value is calculated by following formula:
uppercase(md5(uppercase(md5(SALT) + md5(Х)))), where SALT – secret word; Х – result of string concatenation (with semicolon (;) as delimiter) of the request parameters in order as they located in table from top to bottom excluding DelayPayment, SendNotification, Checkvalue and CustomerNumber, '+' – string concatenation.
When bill with the same number is already exist then new bill is not created and an error is returned: "Bill with the specified number already exists".
If request doesn't contain mandatory parameters or wrong data format provided the new bill is not created and an error is returned (similar to the error of order creation with not enough or wrong parameters).
When unique payment token/ID cannot be created the new bill is not created and an error is returned: "Unique payment token/ID cannot be created".
Example of bill creation request (HTTP POST):
<FORM ACTION="https://<SERVER-NAME>/bill/createbill.cfm" method="POST"> <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="Bill" VALUE="Bill number"> <INPUT TYPE="hidden" NAME="Bill_amount" VALUE="Bill amount"> <INPUT TYPE="hidden" NAME="Bill_currency" VALUE="Bill currency"> <INPUT TYPE="hidden" NAME="Bill_comment" VALUE="Bill comment"> <INPUT TYPE="hidden" NAME="Customer_Name" VALUE="Customer name"> <INPUT TYPE="hidden" NAME="Customer_Lastname" VALUE="Customer lastname"> <INPUT TYPE="hidden" NAME="Customer_Middlename" VALUE="Customer middlename"> <INPUT TYPE="hidden" NAME="Customer_Email" VALUE="Customer Email"> <INPUT TYPE="hidden" NAME="Customer_Phone" VALUE="Customer phone"> <INPUT TYPE="hidden" NAME="Customer_Mobile" VALUE="Customer mobile phone"> <INPUT TYPE="hidden" NAME="Language" VALUE="Language of authorized pages"> <INPUT TYPE="hidden" NAME="Pay_until" VALUE="Expire date of bill payment"> <INPUT TYPE="hidden" NAME="SendNotification" VALUE="Bill sending flag"> <INPUT TYPE="hidden" NAME="Checkvalue" VALUE="Request validation code"> <INPUT TYPE="Submit"></FORM> |
List of response parameters:
Parameter | Value |
| Hash | Payment token/bill ID |
Example of return parameter in CSV format:
Hash: xKPWpz4ZzDe5A9anPhnN |
In XML format:
<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<result
firstcode="0"
secondcode="0"
count="1">
<return>
<Hash>akPWp08t84MTQ9anTy30</Hash>
</return>
</result> |