Recurring payments
The service is intended for initiation payments for continued services by subscription. This possibility is determined by the settings of the acquiring bank processing. For more information, contact the support service support@belassist.by.
The parameter RecurringIndicator = 1 should be set in initial authorization request in order to initiate the recurrent payment. Also the parameters of the range of amounts in subsequent recurring payments, payment frequency (in days) and the end date of subscription should be provided.
Then periodically the company will initiate the payment, setting the payment amount only and the rest required payment information (bankcard data) is taken from the original payment.
To make the subsequent recurring payment, send a request to IPS Assist server by HTTP POST in the request body in the key=value format, by SOAP method (in UTF-8 coding), or in JSON format (swagger description: https://docs.belassist.by/swagger/).
The request URL for the recurring payment:
Parameter | Mandatory field | Adopted values | Default values | Description |
BillNumber | Yes | 15 or 16 characters | BillNumber of initial order | |
OrderNumber | Yes | 128 characters | New order number for this recurrent payment | |
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) | |
Amount | Yes | Number, 15 digits, two digits after the delimiter (delimiter '.') | Recurring payment amount The value of recurring payment amount should be between the values of the min and max amounts of recurring payments transferred at the primary request for authorization of the initiating payment. | |
Currency | Yes | 3 characters | Recurring payment currency The currency of the recurring payment should be equal to the currency of the initiating one, otherwise the order closes with an error. | |
OrderComment | No | 4000 characters | Comment | |
Language | No | RU EN | EN | Language of the results output |
Format | No | 1 – CSV | 1 for POST request and 4 for SOAP | Format of the results output |
All request parameters are automatically validated. The validation rules are given in the table "The validation rules for input parameters".
Request example for HTTP POST format:
<FORM ACTION="https://<SERVER-NAME>/recurrent/rp.cfm" METHOD="POST"> <INPUT TYPE="HIDDEN" NAME="BillNumber" VALUE="511111100000001.1"> <INPUT TYPE="HIDDEN" NAME="OrderNumber" VALUE="A1_R1"> <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="Amount" VALUE="20"> <INPUT TYPE="HIDDEN" NAME="Currency" VALUE="BYN"> <INPUT TYPE="HIDDEN" NAME="Format" VALUE="3"> <INPUT TYPE="HIDDEN" NAME="Language" VALUE="EN"> <INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Buy"> </FORM>