Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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)

Note

All parameters, which set by the user within the personal Account are automatically  validated .

...

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 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)

...

Merchant URL

URL that used for results delivery

Protocol type

Protocol type – POST or SOAP

Sign type

Signature type – PGP or md5

Download the key file

To obtain a key file, please, contact support team (support@belassist.by).

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)

Anchor
reg
reg



Registry and notifications sending options

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

Panel

BillNumber:000000000000001;BillNumberExt:000000000000001.1;OrderNumber:0001-01; OrderState:Approved; OrderTest:1;OrderAmount:300.00;OrderCurrency:BYN;OrderDate:01.01.2011 07:00:05;OrderComment:тестовый платеж;CustomerName:Testov Test T.;OperationType:Approve;OperationState:Success;Protocol:NET; OperationAmount:300.00;OperationCurrency:BYN;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:

Panel

BillNumber: 000000000000001 OperationType:Approve OrderNumber:0001-01 Total:300.00 Currency: BYN Status:Approved Comment:Test payment Response_Code:AS000 MeanType: MasterCard

A confirmation (charge) notification example:

Panel

BillNumber: 000000000000001 OperationType:Charge OrderNumber:0001-01 Total: 300.00 Currency: BYN Status:Approved Comment:Test payment Response_Code:AS000 MeanType: MasterCard

A cancelation notification example:

Panel

BillNumber:000000000000001 OperationType:PaymentCancel OrderNumber:0001-01 Total: 300.00 Currency: BYN Status:Canceled Comment:Test payment Response_Code:AS000 MeanType: MasterCard

Limit options

This tab shows the limits of merchant in table. The table displays:

  • limit name;
  • limit current values;
  • thresholds values.

Active limits are checked in the ' Active ' column. Limits are displayed in read-only mode. Contact the support team to change limits (support@belassist.by).

Anchor
sign
sign



Order signature options

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 (support@belassist.by) to settle it.

All changes are applied after pressing ' Save ' button.

Warning

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.

Message appears on save which informs that new key is activated and the old one will be deactivated soon.

Warning

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 the  'Generation of a string for signature or for checkvalue '  section.

Anchor
oneclick
oneclick



One Click

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. If the " Customer number " field is empty and you click the " Search " button, then the full list of One Click clients of this merchant will be displayed as search results.

Image Added
One Click details of the customer

Possible values of customer status:

Status name

Description

New

Customer who have made some successful payments but not agreed to store the card for future payments. The customer will have the same status also, if his first payment was unsuccessful or closed after the timeout.

Member

Customer who agreed to store the card for future payments.

Not active

When the all stored cards of this member are expired or not valid. The status is set automatically.

Deny

Customer has rejected the offer to activate One Click.

Fraud (highlighted in red)

100% fraud status was received from System Of Fraud Intelligence (SOFI) during the payment by this card or  'Card stolen'  status received from the processing. Payments by this card are blocked.

Suspicious (highlighted in yellow)

Received a fraud status from System Of Fraud Intelligence (SOFI) for one of the cards of this customer (when paying to any merchant). The status is set automatically, but it can also be set manually.

By right click on the desired customer record you can change the customer status.

Note

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.

Saving date

Date of saving the card with the first successful payment.

Last success payment date

Date and time of the last successful payment by this payment mean.

Number of successful payments

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.

Card expired

A card that has expired.

Deleted

The card has been removed from the One Click service.

Image Added
Information on customer cards

By right click on the desired card record you can delete this card from One click program data base.

An additional confirmation prompt appears before the card is deleted. Before deleting the card the confirm window will appear as it shown on the picture below.

Image Added
Confirm window for card deleting

More details about One Click can be found in documents of section One Click program .

Change password

This section is used to change password of current user.

Enter the  'Current password ' then  'New password'  and repeat a new password in  'Confirm password ' field.

Note

Password should be 8 to 20 symbols long and should contain Latin alphabet symbols (upper/lower case) and digits. Password must contain both – alphabet symbols and digits.

Password changes after pressing ' Save ' button.

Two-factor authentication

To increase the level of security of enterprise data in the Personal Account, you can additionally use two-factor authentication. A special code, which can be obtained using a mobile device (smartphone), is used in addition to the main account password. You should download the application and choose a more convenient way to get the code.

This section displays a brief instruction on how to enable two-factor authentication, and there is also a field for entering a special verification code.

Image Added


Anchor
841
841


Users

In this section you can see and change users of the enterprise. Only merchant administrator has rights to amend and create new users.

Actions over users

Enterprise administrator has rights to create a user.

In addition, administrator can perform the following action on existing users:

  • user password change;
  • enabling/disabling the user possibility to change own password;
  • user details change;
  • user rights amendment;
  • changing of user rights on the tab "Operations";
  • user – merchant assignment change;
  • user deletion.

Image Added
Create new user window

For example, a user should be created to monitor orders in Order monitor . The following steps should be done:

  • press New User  button and enter all necessary user information in the dialog box (Login, Password, Confirm password, select the User's type as USER , select the user default language, required parameters are marked with asterisks);
  • press Save  button. The new user will appear in table;
  • right-click on the new user in the table and select  'Edit Rights;
  • in the Roles section of the Edit Rights tab set the check mark in the Use ' row in Access column (Picture "Adding a role to user" below);
  • on the Edit merchant list  tab the user can be assigned to merchant(s) of the enterprise; check/uncheck the merchants to attach/detach merchant to the user (Picture "Change user-merchant assignment" below);
  • press Save  button.
Note

By creating of new user note, that:

  • login  should be 8 to 20 symbols long and should contain at least one Latin alphabet symbol (upper/lower case), may also include digits and underscore;
  • password  should be 8 to 20 symbols long and should contain Latin alphabet symbols (upper/lower case) and digits. Password must contain both – alphabet symbols and digits.

Image Added
Adding a role to user

Image Added
Change user-merchant assignment

Now new user can login to the Personal Account and watch the orders in Orders monitor .

  • If user should have ability to charge or cancel order payments and/or export data in the file, then the following actions should be done additionally:
  • right-click on new user in table and select Edit Rights;
  • in Component section of the Edit Rights tab check Confirmations and Cancellations and/or Button “Export” ’ in the Access column (Picture below);
  • check that ACCOUNT/ACCOUNT: Order menu is checked on;
  • press Save button.

Image Added
Granting rights for cancel and charge

Now the user may confirm or cancel payments and/or export data to the file in the Orders monitor  of Personal account.

If the administrator wants to change a user password then following steps should be done:

  • right-click on the new user in the table and select Change password;
  • enter twice a new user password in the dialog;
  • Press Save  button.

If a user should be deleted should be done by the administrator the following steps:

  • right-click on the new user in the table and select Delete ;
  • confirm the deletion in the dialog. User will be deleted.
Warning

It is not possible to restore a user which was deleted!

Using profiles

The profile mechanism is convenient for the merchants that need to create a lot of different user accounts with the same rights. To do this, a special user profile with all the necessary rights is created. For creating the next user, the administrator will only need to set his personal data and the profile name.

The use of profiles must be coordinated with the technical support service of Assist, then at the request of the merchant, the necessary profiles will be created and the administrator is given the appropriate rights.

Clicking the Profiles  button opens a new window, which displays information about the current profiles of the merchant.

Profile parameters

Name

Description

Name

Profile name

User’s type

Type of user

Company

User profile company

Enterprise

User profile enterprise

E-mail

E-mail default profile user address (will be automatically assigned to all users of the profile for which the own E-mail address isn’t set)

Level of display errors

Assigned level of display errors

To create a user profile, call the context menu by right click and select Create User.

The list of fields in the form for creating a new user profile is given in the table.

New user creation options

Name

Description

User profile

Select from the list of available values of merchant’s profiles

Login

It should be 8 to 20 symbols long and should contain at least one Latin alphabet symbol (upper/lower case), may also include digits and underscore.

Password

It should be 8 to 20 symbols long and should contain Latin alphabet symbols (upper/lower case) and digits. Password must contain both – alphabet symbols and digits.

First name

Text field

Middle name

Text field

Last name

Text field

E-mail

Text field (100 characters). E-mail user address, if not specified, then the default profile address will be automatically assigned

To save the changes, click the Create button.

Back on top

...