In the 'Options' section settings of enterprise, its merchants and users can be changed. This section is available only for users who have appropriate rights.
In this section settings of the enterprise can be changed. It has 'Common' and 'Banking details' tabs.
Common enterprise's data is displayed on the 'Common' tab. See table below for details.
List of enterprise data that is displayed on the 'Common' tab
Name | Description |
ID | System Enterprise ID (for reference only) |
Name | Full enterprise name |
Administrative contact | Administrative contact (Name, Position, Phone, Mobile phone, E-mail) – editable fields, you can specify multiple addresses separated by commas in the E-mail field. |
Technical contact | Technical contact (Name, Position, Phone, Mobile phone, E-mail) – editable fields, you can specify multiple addresses separated by commas in the E-mail field. |
Legal address | Legal enterprise address (for reference only) |
Post address | Postal address of the enterprise (for reference only) |
Time zone | Enterprise time zone (for reference only) |
All parameters, which set by the user within the personal Account are automatically validated. |
All changes are applied after pressing 'Save' button.
Only enterprise administrator can change these settings.
The bank requisites of the enterprise are displayed on the 'Banking details' tab. See table below for details.
List of enterprise data that is displayed on the 'Bank details' tab
Name | Description |
Bank | Bank name |
BIK | Bank identity code |
OKVED | OKVED of the enterprise |
OKPO | OKPO of the enterprise |
Payment account | The enterprise payment account |
Correspondent account | The enterprise correspondent account |
TIN | The enterprise TIN |
Accountant E-mail | Accountant E-mail |
KPP | The enterprise RPP |
All changes are applied after pressing 'Save' button.
Only enterprise administrator can change these settings.
This section allows to see and to change merchant settings. The choice of a subsection (group of settings) is made using the menu on the right side of the screen. All subsections contain drop-down boxes in header that set the merchant which data are displayed on the subsection.
The settings subsection selection menu
The list of merchant data, which are displayed on this subsection is described in the table below.
Common merchant properties
Name | Description |
ID | System merchant ID (for reference only) |
Enterprise | The merchant's enterprise (for reference only) |
Name | Names of the merchant in different languages (editable) |
Goods and services | Goods and services that merchant provides (for reference only) |
URL | Merchant's URL (editable) |
Administrative contact | Administrative contact (Name, Position, Phone, Mobile phone, E-mail) – editable fields, you can specify multiple addresses separated by commas in the E-mail field. |
Technical contact | Technical contact (Name, Position, Phone, Mobile phone, E-mail) – (editable fields), you can specify multiple addresses separated by commas in the E-mail field. |
E-mail to receive fraud information | E-mail that is used for notifications about fraudulent transactions – (editable fields) |
All parameters, which set by the user within the personal Account are automatically validated. |
Name (merchant name) can be provided in different languages. Write down the name's translations next to corresponding languages.
All changes are applied after pressing 'Save' button.
The list of merchant data, which are displayed on this subsection is described in the table below.
List of merchant's settings displayed on the 'Payment options' subsection
Name | Description |
Base currency | Code and name of merchant's base currency (for reference only) |
Test mode | «Yes» - The merchant is in the test payment mode «No» - The merchant is in the production payment mode (for reference only) |
Timeout | Timeout (in minutes), customer can enter his personal data and card data during that time period. When time is up transaction is closed with time-out status. |
URL_RETURN | URL, which is used to redirect customer in one of 2 cases: 1) in case of unsuccessful payment if 'URL_RETURN_OK' is filled; 2) in all cases if 'URL_RETURN_OK' is not filled. 'Action after authorization' should be set in 'Redirect to merchant page' to redirect customer by 'URL_RETURN'. It is recommended to use HTTPS protocol for secure communication. |
URL_RETURN_OK | If 'Action after authorization' is set to 'Redirect to merchant page' then customer is redirected by this URL after successful payment. It is recommended to use HTTPS protocol for secure communication. |
Action after authorization | Drop-down list that sets the system behavior after finishing of payment: 'Redirect to merchant page', or 'Redirect to authorization result page' |
Secret word | Merchant’s secret word. |
All changes are applied after pressing 'Save' button.
Please note that values of 'URL_RETURN_OK' and 'URL_RETURN' are used only when 'Action after authorization' is set to 'Redirect to merchant page' and if the authorization request does not contain URL_RETURN, URL_RETURN_OK, URL_RETURN_NO (otherwise request parameters are used; request parameters have a higher priority).
This subsection provides a reference only information about general bill settings: the algorithm of the bill numbering, template of the bill number, version of payment token and display bill settings.
In this subsection you can also view and edit such parameters as bill payment expiration period, whether to send the bill to the customer via E-mail after the bill creation, as well as whether to send notice of bill revoke.
List of merchant's settings displayed on the 'Bill options' subsection
Name | Description |
A method of forming a bill number | For reference only. |
Bill number template | Template to generate of bill numbers. For reference only. |
Token | For reference only. |
Show bill before payment | Check box. By default, bill is shown to the customer when he/she has followed by the payment link. If it is not checked then, the customer immediately goes to the payment page. For reference only. |
Period of bill payment | Expiration period of bill payment, displayed as DD.HH.MM, by default – 1 day. This field can not be empty or null. When parameter Pay_until is not passed in the bill creation via web-service then Pay_until is calculated as the bill creation time plus value of this setting. This parameter also used to determine the "Pay until" value during the bill creation in personal account. |
Send notice of bill revoke | Check box is responsible for sending of notifying about the revoking of the bill. By default, notice is send. |
Secret word | Merchant’s secret word. (for reference only). You can set it in the ”Payment options” section. |
Check value for bills | Check box is responsible for using of check value code when creating bill. |
Default values | |
Send bill | Drop-down box: Don’t send, Send via E-mail, Send via SMS, Send via E-mail and SMS. |
Source of cheque items | Drop-down box: No (cheque items are entered manually), Price list (cheque items can be entered either manually or loaded from the price list), Only price list (cheque items can be loaded only from the price list). |
Double-stage operation mode | Check box. If it is checked then payments in double-stage operation mode on the bills of this merchant are allowed. |
First name | Payer's first name |
Last name | Payer's last name |
All parameters, which set by the user within the personal Account are automatically validated. |
Part of the parameters in the "Bill options" subsection are displayed for reference only. Contact the support team to change these parameters. |
All changes are applied after pressing 'Save' button.
The sending of authorization results to the merchant's server can be set up on the 'Payment result options' subsection.
For security reasons results are sent only on ports 443, 8443, 80, 8080. No other ports can be used to receive the results! |
If sending of payment results is activated and notification sending has failed then a special e-mail notification is sent to the address, which is specified in the parameter "Technical contact" on tab "Common options" under "Merchants options." |
The list of merchant data, which are displayed on this subsection is described in the table below.
List of settings on ’Payment result options’ subsection
Name | Description |
Send approve results | Check box. If it is checked then results of payments are sent. |
Send cancel results | Check box. If it is checked then cancellations results are sent. |
Send order positions | Check box. If it is checked then order positions are sent. |
Send fiscal results | Check box. If it is checked then fiscal results are sent. |
Send charge results | Check box. If it is checked then results of charges are sent. |
Send only success results | Check box. If it is checked then only successful results are sent. It is active only when at least one of above is selected. |
Sending results awarding points to the merchant server | Check box. If it is checked then results of bonus point accruals are sent. It is actual for merchants, which use 'Thank YOU' program of SberBank. |
Sending results cancellation awarding points to the merchant server | Check box. If it is checked then results of bonus point accrual cancellations are sent. It is actual for merchants, which use 'Thank YOU' program of SberBank. |
Merchant URL | URL that used for results delivery |
Protocol type | Protocol type – POST or SOAP |
Sign type | Signature type – PGP or md5 |
Secret word | Secret word for md5 signature (for reference only). You can set it in the ”Payment options” section. |
Response type | Type of expected response on the results' sending from merchant's server (for reference only) |
You can view the current fiscal settings for the merchant on the 'Fiscal settings' subsection.
Fiscal settings
Name | Description |
Generate a fiscal cheque for card payments | If checked then permits the generation of fiscal cheques for payments by cards to the merchant is allowed. |
Generate a fiscal cheque for e-wallets payments | If checked then permits the generation of fiscal cheques for payments by e-wallets to the merchant is allowed. |
Generate a fiscal cheque for non-electronic means | If checked then permits the generation of fiscal cheques for payments by non-electronic means to the merchant is allowed. |
Merchant works with external fiscalization | If checked then the merchant uses external fiscalization for its payments |
The stage of the cheque creation/notification | Authorization or Charge. The Charge can only be applied to the double-stage payment. |
Do not send fiscal cheque | Permission not to send fiscal cheques to customers. |
Default payment method | The default payment method (in the mode without transfer of the cheque items). |
Address of payment place | The address of the payment place, printed in the cheque (or domain address when buying online). |
Default tax rate | The default tax rate (in the mode without transfer of the cheque items). |
Default taxation system | The default taxation system (in the mode without transfer of the cheque items). |
URL of FDO | URL address of FDO |
Default text of cheque item | The default name of the product (in the mode without transfer of the cheque items). |
Default text of cheque item for external payments | The default name of the product (in the mode without transfer of the cheque items during fiscalization of external payments). |
Send notification on a failed payment | If checked then notification will be sent to the buyer in case of unsuccessful payment. |
Cheque sender E-mail | E-mail address of the cheque sender (as agreed with the merchant). |
Default customer E-mail | The default customer E-mail address. |
* All the parameters in the "Fiscal settings" table are displayed for reference only. Contact the support team to change the fiscal settings.
There are two blocks of settings on this subsection. List of settings, which are related to 'Daily registry' are described in table "List of settings for Daily registry". List of settings, which are related to 'Notifications' are described in table "Notifications settings".
List of settings for Daily registry
Name | Description |
Send daily registry | If checked then every day the daily registry is sent to the specified e-mail. |
E-mail to receive registry | Sets the e-mail(s) for registry delivery (use comma (',') as e-mails list separator) |
Report type | Drop-down box that sets type of transaction that are included in the registry: All, Only successful, All except unsuccessful |
Time zone in the registry dates | Sets time zone of date/times in the registry: GMT or enterprise time zone (that is set in the Enterprise options) |
Decimal delimiter | Sets the point ('.') or comma (',') for decimal delimiters |
Send daily registry for | The control allows to enter the year, month, day as the date for which you want to resend the registry. Note. You can order the registry only for the past dates, not later than yesterday. To build and send the registry, click the "Send" button. The "Send" button is only active when the checkbox «Send daily registry» is checked. |
If sending is enabled then every day the daily registry (prepared according to selected type) is sent to the specified e-mails. E-mail message contains the TXT file with payments. If no payment were made then the file contains 'NO PAYMENTS THIS DAY' text.
Example of one row from the registry file
BillNumber:000000000000001;BillNumberExt:000000000000001.1;OrderNumber:0001-01; OrderState:Approved; OrderTest:1;OrderAmount:100.00;OrderCurrency:RUB;OrderDate:01.01.2011 07:00:05;OrderComment:тестовый платеж;CustomerName:Testov Test T.;OperationType:Approve;OperationState:Success;Protocol:NET; OperationAmount:100.00;OperationCurrency:RUB;OperationDate:01.01.2011 07:00:08;MeanType:VISA; MeanSubType:Visa Gold;MeanNumber:411111****1111;CardHolder:Testov Test;OperationResult:Success; ErrorMessage:;Recommendation:;Response_Code:AS000;ApprovalCode:F00001;ProcessingName:Name; |
Notifications are e-mail messages, which are sent after finishing of the payment. Each message contains payment details
Notifications settings
Name | Description |
E-mail to receive notifications | Sets the e-mail which is used for notification delivery |
Send pay notification | If checked then notifications are sent after payment completion |
Send pay approve notification | If checked then notifications are sent after payment confirmation completion (charge) |
Send pay cancel notification | If checked then notifications are sent after payment cancellation completion |
A payment notification example:
BillNumber: 000000000000001 OperationType:Approve OrderNumber:0001-01 Total:100.00 Currency:RUB Status:Approved Comment:Test payment Response_Code:AS000 MeanType: MasterCard |
A confirmation (charge) notification example:
BillNumber: 000000000000001 OperationType:Charge OrderNumber:0001-01 Total:100.00 Currency:RUB Status:Approved Comment:Test payment Response_Code:AS000 MeanType: MasterCard |
A cancelation notification example:
BillNumber:000000000000001 OperationType:PaymentCancel OrderNumber:0001-01 Total:100.00 Currency:RUB Status:Canceled Comment:Test payment Response_Code:AS000 MeanType: MasterCard |
This tab shows the limits of merchant in table. The table displays:
Active limits are checked in the 'Active' column. Limits are displayed in read-only mode. Contact the support team to change limits.
When the merchant uses up the order check value (MD5) and/or the order signature the settings for this checks can be configured on this tab. Parameters are described in the table below.
Order signature settings
Name | Description |
Check order code (MD5) | |
Check order code (MD5) | If checked then the order value (MD5) is verified on the request receiving. |
Secret word | Merchant’s secret word. Note! The same secret word is used for the order check value and for the payment result options. |
Check order signature | |
Check order signature | If checked then the order signature is verified on the request receiving |
New public key | You need to generate the RSA public key with length of 1024 bits and upload it as a * .pem format file by button «Select files» which allows to select a file with public key. |
Current public key | Field that displays current public key (for information only) |
Period when new and old keys are valid (days) | Period in days, during which the old key and new one are both active. It is transition period to smoothly move to a new key on the old key expiration. If the old key should be deactivated immediately after new one applied – contact the support team to settle it. |
All changes are applied after pressing 'Save' button. Message appears on save which informs that new key is activated and the old one will be deactivated soon.
If merchant has activated order check value (MD5) verification then authorization request must contain the 'Checkvalue' parameter with correctly calculated value. Otherwise requests will be denied with error. The 'Checkvalue' parameter has to be generated as follows: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), where SALT – secret word; Х – result of the following parameters string concatenation: merchant_id, ordernumber, orderamount, ordercurrency (without delimiters), + means string concatenation. |
If merchant has activated order signature checking then authorization request must contain the 'Signature' parameter with correctly calculated value. Otherwise requests will be denied with error. See more details about order signature in 'Setting up an enterprise's technical interaction' manual. |
Merchant parameters on One Click are displayed on this subsection. Parameters are not editable and they are displayed for information only. Contact support team to change One Click parameters. One Click parameters are described in the table below.
One Click parameters
Name | Description |
Enable One Click | If checked then One Click is activated for the merchant |
Mode | Drop-down box: Standerd (the buyer can store new cards to the program or pay with previously stored cards), Payments by stored cards only (the buyer can pay with stored cards only), Cards store only (the buyer can only store new cards to the program). |
In expandable block 'Customers' of One Click tab you can see the information about a customer by his unique number (that merchant assigned to that customer and sent in the authorization request as value of parameter 'CustomerNumber'). Value of 'CustomerNumber' also must be included in the order signature.
Enter the desired CustomerNumber into the field and press 'Search'. The information about customer will be displayed on screen.
One Click details of the customer
Possible values of customer status:
|
By right click on the desired customer record you can change the customer status.
If a customer makes payments to a merchant with different bank cards, each of them is included in the One Click program using the same rules. With payment for the next order, the customer has the opportunity to choose the desired card from the drop-down list of his stored payment means (for which there were successful payments). |
Clicking on the black triangle at the beginning of the line with the customer record allows you to open an additional window. Here you can see the data on all the saved cards of this customer in a table with the following columns.
Name | Description |
Mean number ID | Unique identification of payment mean number. |
Mean type | Payment mean type (Visa, MasterCard etc.). |
Mean number | The payment means number, for example card number. Only 6 first and last 4 digits are shown in the card number. |
Last success payment date | Date and time of the last successful payment by this payment mean. |
Successful payments count | The number of successful payments by this card. |
Order | The order of the last payments on the cards of this customer. By default at the next payment, the client will be offered to pay for the order with the last used card (Order 1). |
Card state | Card state. |
COF status | COF payment type in processing. |
Possible values of customer card state:
State name | Description |
Member | One or more payments were successfully made on this card and the customer agreed to store it. |
Fraud | 100% fraud status were received from Anti-Fraud system during the payment by this card or 'Card stolen' status received from the processing. Payments by this card are blocked. |
By right click on the desired card record you can delete this card from One click program data base.
Information on customer cards
More details about One Click can be found in documents of section 'One Click program' on web site.
IPS Assist provides a processing service for payments via token (e.g, Apple Pay). This tab displays information about payment permissions for this merchant via various payment services and information about certificates of the merchant. Also you can upload the signed certificate for payments via tokens through Assist system.
The top of the tab displays the following information about payment permissions via payment services:
This information is displayed for reference, please, contact support team for setup the payments via payment services.
The table of current merchant certificates is displayed below.
Certificate parameters for the token payment
Name | Description |
Type | Type of certificate, e.g. Apple Pay |
Public key hash | Public key hash, created by IPS Assist. |
Valid | The validity of the downloaded certificate. |
State | Current status of the certificate (Request – certificate is creating, Active – certificate is active). |
Press the button "New Certificate" to upload the certificate. Select the type of certificate in the following window:
Selecting the type of certificate
By pressing of "Approve" button you get the window, where you can find the description of required steps that you have to perform to receive the signed certificate. You also can upload the signed certificate here.
Uploading of the signed certificate
Click on "Upload signed certificate" opens a standard browsing window for selection of a signed certificate file.
Generation of the certificate signing request file and the upload the signed certificate can be only done by using browsers Chrome, Firefox, Edge, Opera and Safari (for Mac). |
If uploading the certificate has not been completed and the upload window is closed, in the certificates table is created the certificate with the status «Request» and validity time of this certificate is missing. Uploading of the signed certificate can be done later - this action is available via the context menu
Context menu
|
For getting rights to change token pay settings, please, contact support team (support@assist.ru). |
The tab is intended for the merchants, which are working with the mobile application Assist mPOS.
The list of the parameters, which are displayed on this tab is described in the table below.
mPOS settings