Page History
| Table of Contents |
|---|
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.
...
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.
| Anchor | ||||
|---|---|---|---|---|
|
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.
...
| Code Block | ||
|---|---|---|
| ||
<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.
...
| Warning |
|---|
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:
...
After completing the request, a payment receipt is displayed on the payment page, which indicates the payment status as “In Process”. The customer is invited to use the SSIS “Settlement” system to complete the payment. At the same time, a letter with the SSIS order number and instructions for completing the payment is sent to the customer’s email address.
On-demand payments via web service
A special web service allows a merchant to generate an order in SSIS without going to the payment page.
...
| Code Block | ||
|---|---|---|
| ||
{"errorCode":"51", "errorMessage":"Customer first name must be specified"} |
Advance payments
An merchant can receive either advance payments or on-demand payments through SSIS, depending on the system settings.
...
The prepared file with the register can be downloaded in the “ Customers ” section in the IPS Assist Personal Account.
Advance payments with customer verification on the merchant side
The merchant can organize replenishment of the client’s personal wallet through SSIS. The customer of the merchant will be able to use the wallet funds for subsequent payment of the order. To identify a customer, you can use a phone number, email address or other client ID. Verification is carried out using a pre-agreed ID (the customer must know what exactly needs to be used as an ID on the SSIS side to start top up his wallet).
...
| Code Block | ||
|---|---|---|
| ||
{"status":"NotFound","errorMessage":"account not found"} |
Payment notifications
To notify the merchant about the payment result in real time, the IPS Assist system provides a service for synchronously sending payment results to the merchant server. After the buyer completes payment for the order (using a bank card or one of the of electronic cash payment means), a message with payment parameters is sent to the merchant server using the HTTP POST or SOAP method.
...
| Warning |
|---|
Attention! If a merchant receives daily registers of completed transactions from IPS Assist, for such registers it is also possible to indicate personal accounts in SSIS for which payments were made (if the merchant has advance payments). To configure such registries, you should contact IPS Assist technical support service (support@belassist.by). |