View Source

General provisions

“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.

Payments on demand

On-demand payments are made by the customer at a time when buying a product/service.

Payment against an invoice issued using a web service

The web service for creating a bill accepts bill parameters (HTTP POST/SOAP formats) and returns (if the bill is created successfully) the payment token/ID corresponding to this bill. 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 по адресу: shop 1@ testpost . by

_____________

С уважением,

Отдел технической поддержки

ASSIST

www.belassist.by

The notification template must be discussed with support service ( support@belassist.by ).

The customer can pay the bill in the SSIS system at any time within the specified period. To set up a due date for paying bills, the merchant should contact the technical support service (support@belassist.by).

Request URL to create a bill:

https://<SERVER-NAME>/bill/createbill.cfm

List of request parameters:

Parameter	Mandatory field	Adopted values	Default value	Description
Merchant_ID	Yes	Number		The merchant 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>

SOAP web-service description:

https://<SERVER_NAME>/bill/createbill.wsdl

Example of bill creation request:

<Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header/>
    <Body>
        <CreateBill>
            <Bill>
                <merchant_id>423422</merchant_id>
                <login>login</login>
                <password>password</password>
                <bill>123456</bill>
                <bill_amount>100.00</bill_amount>
                <bill_currency>BYN</bill_currency>
                <bill_comment></bill_comment>
                <customer_name>Test</customer_name>
                <customer_lastname>Testov</customer_lastname>
                <customer_middlename>Testovich</customer_middlename>
                <customer_email>test@testpost.by</customer_email>
                <customer_phone></customer_phone>
                <language>RU</language>
                <pay_until>20150611T1212</pay_until>
                <sendnotification>0</sendnotification>
                <checkvalue> AA3BC3F48B7FE23988044B53AA98F169</checkvalue>
            </Bill>
        </CreateBill>
    </Body>
</Envelope>

Example of request result:

<soapenv:Envelope
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
        <ASS-NS:BillResponse xmlns:ASS-NS="http://www.paysecure.ru/ws/">
            <return xsi:type="si:SOAPStruct" xmlns:si="http://www.paysecure.ru/type/">
                <Hash xsi:type="xsd:string">6CPV7F4a0aWQg9XsXhrS</Hash>
            </return>
        </ASS-NS:BillResponse>
    </SOAP-ENV:Body>

Payment according to a bill issued from the Personal Account of IPS Assist

The Bills section is designed to obtain information about invoiced and paid bills; the section also allows you to create new bills, cancel invoiced bills, send issued bills by email to customers, pay invoiced bills and receive other necessary information about the bills and bill payments.

Separate button " Create new bill " allows the operator to create new bill directly from your personal account. Clicking this button opens a window for bill creation. Required parameters are marked with asterisks.

Documentations English Bel > Features of ERIP payments > bel12e.PNG
Bill creation window

List of the parameters for creating a new bill

Name	Description
Common info
Merchant	Select from the drop down list available merchants for the current user.
Bill #	The bill number that is defined by the enterprise. When bill auto-numbering is switched on IPS Assist side then this field can be empty.
Bill amount	Bill amount
Currency	Bill currency (select from the drop down list of currency codes).
Comment	Bill comment
Language	Customer language, which is used for E-mail messages and payment page (language of the merchant by default).
Pay_until	Expire date of bill payment (date and time in GMT), by default 1 day.
DelayPayment*	Check box. Attribute of a credit card authorization for the double-stage operation mode: 0- one-stage operation, 1 - double-stage operation.
Customer info
Customer Number	Merchant's internal customer identification
Last name*	Customer's last name
First name*	Customer's name
Middle Name	Customer's middle name
Phone	Customer's phone number
Mobile phone	Customer's mobile phone number
E-mail	Customer's E-mail address
Send bill*	Drop-down list: Don't send, Send via E-mail, Send via Email and SMS.

*The parameter value can be set by default. In this case, the bill creation window will be opened with the already filled default values. During creating a bill, the values of these parameters can be changed by user. Please, contact support team (support@belassist.by ) to set the default parameters.

All changes are applied after pressing ' Save ' button.

If you select the 'View bill' option in the bill's context menu then the window 'Bill details' appears with selected bill. If you select the 'Edit bill' option in the bill's context menu you can also edit the bill parameters. Work in this window is carried out in the same way as in the Create new bill window.

Documentations English Bel > Features of ERIP payments > bill33be.PNG
Bill details window

Attention! If a template for notifying the customer about invoicing the bill for payment in the SSIS system is configured for the merchant (see example), then the customer will be able to pay the bill within the specified period using SSIS. If the merchant uses a standard notification template, the customer will receive a link to pay the bill using not only SSIS, but also other payment means. At the same time, no more than 48 hours are given for payment using SSIS. The operator transmitting the bill link to the customer in any way will lead to the same result.

On-demand payments from the Personal Account of IPS Assist

On-demand payments via payment pages

In order for the IPS Assist server to accept a payment authorization request, the merchant must send the following parameters:

Merchant_ID – the merchant identifier in IPS Assist;
OrderNumber – order number in the merchant's payment system corresponding to this payment;
OrderAmount – purchase amount.

This is a minimum set of payment parameters that is transmitted from the merchant when the customer is redirected to the IPS Assist server, after which the customer enters personal data (full name, address, Email, telephone, etc.) and information about the payment means on the IPS Assist authorization pages.

An example of a button with all necessary parameters:

<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=" B20042011_27">
<INPUT TYPE="HIDDEN" NAME="OrderAmount" VALUE="205.50">
<INPUT TYPE="HIDDEN" NAME="OrderComment" VALUE="Example of an order payment">
<INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Buy">
</FORM>

A customer, however, often enters his/her personal information (name, address, e-mail etc.) on the enterprise pages during registration. The merchant can send this information along with the payment parameters. In this case a customer enters on IPS Assist pages only the payment means data.

Example of a button with the payment parameters and the customer's personal data:

<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="A03032011_26">
<INPUT TYPE="HIDDEN" NAME="OrderAmount" VALUE="66.66">
<INPUT TYPE="HIDDEN" NAME="OrderCurrency" VALUE="BYN">
<INPUT TYPE="HIDDEN" NAME="FirstName" VALUE="Test">
<INPUT TYPE="HIDDEN" NAME="LastName" VALUE="Testov">
<INPUT TYPE="HIDDEN" NAME="Email" VALUE="test@assist.ru">
<INPUT TYPE="HIDDEN" NAME="OrderComment" VALUE="Example of an order payment">
<INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Pay">
</FORM>

URL of the authorization request is: