NAV Navbar

For any question, we are one click away

Contact us

Authentication

To sign in to Personal Area, complete the following steps.

  1. Open the Personal Area page.
    The authentication page will open.

  2. Enter you '-operator' login and password in the Login and Password fields.
  3. Click on the Log In button.
    If the credentials are correct, your Personal Area will open.

Logging out

To log out of the Personal Area, click on the button in bottom of the navigation bar to the left.

Changing interface language

To change the language in which the interface of your Personal Area is displayed, follow these steps.

  1. Log in to Personal Area.
  2. At the bottom of the navigation bar to the left, click on the icon with a flag.
    Available interface languages will be displayed.
  3. Click on the desired language icon.
    The Personal Area will automatically be displayed in the selected language.

Settings

To get to the Settings section, in the navigation bar to the left, click on the icon.

In the Settings section you can: * change Personal Area password * specify your email address to be able to recover your password to Personal Area * set the parameters of the Personal Area (not available in Sandbox).

Changing the password

To change the password to Personal Area, complete the following steps.

  1. Log in to Personal Area.
  2. In the navigation bar to the left, go to Settings by clicking on the icon.
  3. On the page that appears, select the General tab. The page will look as follows.
  4. Enter your current password in Current password field.
  5. Enter a new password in New password and Confirm password fields.

The password must meet the following requirements

  1. The password must not contain the name of the store or the login of any of the users created for the merchant (using logins in different leTTER CaSe as passwords is also not allowed).
  2. Password must contain the following characters:
  1. The password must be at least 8 characters long.

  2. Click on the Change password button.

E-mail for password recovery

To be able to recover the password for your Personal Area, enter your email address: 1. Log in to Personal Area. 1. In the navigation bar to the left, go to Settings by clicking on the icon. 1. On the General tab, in Email address section, specify the e-mail address you want to use for password recovery in the E-mail field. 1. Click on the Save button.

Reports

To display the Reports page, click on the icon in the navigation bar to the left.

The page contains information about transactions:

The menu at the top allows you to select the period for which the transaction information will be displayed. The following values are available:

Located under this sections are two fields:

The Number of transactions graph displays information about transactions for the selected period.

The counters on the chart are the following:

The Conversion graph displays the percentage of successful transactions to the total number of transactions.

The Failure codes graph shows the major causes of order processing errors.

Invoicing

You can issue an invoice to the buyer for payment for goods or services by e-mail. For this, use the Invoice to e-mail section ( in the navigation bar to the left). Once the invoice is issued, the buyer receives an e-mail and follows the link in it to the payment page.

To invoice a customer and send them a link to the payment page by email, follow these steps.

  1. Go to Invoice to e-mail section of the Personal Area. The page for entering the invoice parameters will be displayed:

  2. Configure the settings referring to the table below.

Setting Description
Payment type Choose from two options.
  • One-phase – after the payment has been made, no additional actions are required on your part.
  • Two-phase – after the client has confirmed the payment, you must complete the payment in your Personal Area. Before you do this, the money will be held (reserved) on the client's account until you confirm the payment or until the confirmation period expires.
    If you confirm the payment, the money will be transferred to your account.
    The reserved funds on client's account will be released if the reservation period expires before confirmation.
Client name Client's first name, last name, and patronymic. The data entered in this field is displayed in an email containing a link to the payment page.
E-mail The e-mail address to which the payment link will be sent.
Pay until Indicate the date and time by which the payment can be made. After this date and time it will be impossible to pay the invoice.
Description Free-form description of the payment.
Enter the amount Enter the payment amount here. If the order contains a shopping cart, the field value is populated automatically.
  1. Click on the Send button. Upon successful dispatch, a link to the payment form will be displayed below:

You can view the payment page sent to the client by clicking on the Link to payment page button.

Adding a shopping cart to invoice

When generating an invoice you can add a shopping cart for the order. The Cart section is located under the area for creating a link to payment page:

1. To add a goods item to the shopping cart, click on the Add product button. A row with the parameters of the product being added will be displayed. 2. Fill in the required fields referring to the table below.

Field Description
ID Identifier of a goods item in the cart. Filled in automatically.
Name Product/service name.
Price Price of one product unit.
Qty The number of units of the product.
Measure Units of measurement, for example: L – liters, pcs. – pieces.
Amount The total amount for specified goods item. Calculated automatically when the Price and Qty fields are filled out.
Article The vendor code of the goods item.
  1. Repeat the required steps for each item in the shopping cart. If you need to delete the added row, click on the icon.

Having added all items to the shopping cart, invoice the client.

Making a test transaction

You can test the payment process on behalf of the client. To do so: 1. Create an invoice for the client. 2. Go to the payment page by clicking on the Link to payment page button in the invoice-issued-successfully message.

  1. Enter the details of one of the test cards. Leave the Cardholder name field blank.
  2. Click on the Pay button. To confirm the transaction, use the 3-D Secure code specified for the test card.

Working with transactions


The Transactions page contains detailed information about orders and payments. To go to the page, click on the icon in the navigation bar to the left.
The left-hand side of Transactions page contains the search area where the filter can be set. The list of transactions that meet the search criteria is located on the right side of the page.

Using the transactions filter

To work with transactions, you must first define and apply the filter settings.

To set search criteria for transactions, follow these steps.

1. In your Personal Area, go to the Transactions page. 2. In the search area on the Filters tab set the required parameters and click on the Apply button. Matching transactions will be displayed in the area to the right.

Transaction filter parameters

The filter allows you to set the criteria for selecting transactions.

Date range. In the first drop-down list, specify by which kind of date the selection should be made. For example, Creation Date. In the second drop-down list, specify the type of time interval: * Date range – allows you to set the time interval by selecting the start and end dates in the calendar. * Period – allows you to choose the recent period over which the transactions will be shown: day, week, month, or year.

Amount The order amount. Specify the upper and lower bounds for the range.

Status Order status. The following statuses are available (multiple choice):
Created. Invoice is issued but has not been paid yet.
Approved. Invoice paid. Funds are reserved on payer's account.
Deposited. Funds are charged from payer's account.
Reversed. All funds are returned to payer.
Declined. Invoice issued but expired without payment.
Refund. There had been a partial refund.

Order number The number automatically assigned to the order in the store. If you need to find a specific order, indicate its number here.

Merchant login Merchant login in the Payment Gateway system. Enter your login (displayed in the upper right corner).

Last 4 digits of the payment card The last four digits of the payer's card number used to pay for the order. If you are looking for transactions made with a specific card and you know its number, enter the last four digits here.

See description of other search criteria here.

Transaction filter settings

Transaction filter settings are located in the Search area of the Transactions page. In this section, you can set which fields will be displayed as the transaction filter criteria ...

Transaction filter templates

To make working with transactions more convenient, you can save a set of filter settings that you constantly use as a template.

To create a template, follow these steps:

  1. Set and apply the transaction filter criteria.
  2. Click on the Save as a template button.

To use a saved template, follow these steps: 1. While on the Transactions page, in the Search area, go to the Templates tab.
2. Click on the required template in the list. The filter settings saved in the template will be applied.

Transactions table

The transactions table is on the right side of the Transactions page. Transactions appear in the table after the filter is applied.

By default, the table contains the following columns with transaction attributes:

Payment type Means of payment used to pay for the order.

Date The date the transaction was registered.

Amount The order amount.

Exporting transactions

In some cases you may need to export your transactions. Two formats are available: XLS or CSV. To do so:

  1. Find the desired transactions by specifying the search criteria in the filter.
  2. Click the Export button and choose one of the two formats suggested for saving: CSV or XLS.
  3. The report generation process will start. Depending on the settings of your browser, either the report file will be downloaded automatically or a dialog box will appear allowing you to choose a location where to save the report file.

Transaction details

Personal Area provides detailed information about each payment.

To learn more about a payment, while on the Transactions page, click on the row of respective transaction in the table.

The Transaction information page will open. It always contains the Operation info and History tabs.

For transactions of certain types, the Cart and Refund tabs can be displayed in addition.

Also, depending on the status and type of transaction, the Complete and Refund buttons may be present on this page.

The Complete button is used to confirm two-phase payments from clients. This button is active only when the order is in the Approved status.

The Refund button is used to return the payment to the client. The functionality of the button depends on the status of the order and whether a shopping cart was used or not.

Transaction details

The transaction details are shown on Operation info tab which contains three sections: * Operation info. This section shows the attributes of the transaction. * Information about the payer. Here you can find information about the card and the payer. * Additional parameters. Some additional technical details.

Fields in Operation info section:

Field Description
Order number Order number in the store system.
Unique order number Order ID in the Payment Gateway.
Response code Processing code
Payment type Means of payment used to pay for the order.
Fee The amount of the fee (if charged).
Registration amount The order amount.
Deposited amount The amount that was actually debited.
Refund amount Refund amount, if a refund was made.
Creation date Date and time of order creation.
ECI

Electronic Commerce Indicator. Possible values are:

  • 01 - Secure Code was available but not used;
  • 02 - full authorization, MasterCard;
  • 05 - full authorization, Visa;
  • 06 - 3-D Secure was available but not used;
  • 07 - SSL payment.
Order description Arbitrary description of goods and services

Fields in Information about the payer section:

Field Description
Card number Masked number of the card used for payment.
IP address IP address of the payer.
Expiry The payer's card expiration date.
Payment system The name of the International Payment System (card network) to which the payer's card belongs.
Cardholder name Cardholder name used for payment.
E-mail Payer's e-mail address.

History


The history tab contains information about all events relevant to the order: payments, refunds, etc.

Column Description
Operation type Operations made while working with an order.
Date Date and time when the operation was made.
Description The order amount.

Cart


The Cart tab contains information about goods and services paid for in the transaction.

Column Description
ID Number of a goods item in the cart.
Name The name of the goods item.
Article Alphanumeric ID of a goods item (vendor ID).
Price Price of one product unit.
Qty The quantity of the goods item.
Amount The total amount for specified goods item (calculated automatically).
Refund Refund amount. Displayed only if there was a refund. The icon in the row means that there was a partial refund.

Refund


The Refund tab contains information about goods items in the order and allows making a refund to the payer. The refund can be made for the full amount or for specific goods items.

Full refund

To issue a full refund to the payer for the order, follow these steps:

While on the Refund tab, click on the Full refund button. The order status will become Reversed:

Refund for specific items

To issue a refund for specific items, follow these steps:

  1. While on the Refund tab, use the table with content of the shopping cart.
Column Description
ID Number of a goods item in the cart.
Name The name of the goods item.
Article Alphanumeric ID of a goods item (vendor ID).
Price Price of one product unit.
Qty The quantity of the goods item.
Amount The total amount for specified goods item (calculated automatically).
The qty of refund The number of items to be returned.
Refund amount The amount to be refunded. The field is calculated automatically.
  1. In The qty of refund field, indicate the number of items for which the refund should be issued. The resulting amount will be populated in the Refund amount field.

  2. Click on the Refund button.

    If the refunded amount is less than order amount, the order status will become Refund. If the refund is for full amount, the order status will become Reversed.

Available operations with a transaction

The main operations that can be carried out with transactions in the Personal Area are: completion of a two-phase payment and a refund to client. These operations are invoked by corresponding buttons on the transaction information page.

Order completion

In case of a two-phase payment, the funds are first reserved on the client's account (order status is Approved) and only then are credited to the merchant's account (order status is Deposited). Usually the debit occurs automatically after a certain time set in the system, for example, after 24 hours. But this operation can be performed manually from the merchant's Personal Area.

To complete a transaction, while on the Transaction information page, click on the Complete button.

A confirmation window will open. Its appearance is shown below and depends on whether the cart was used in the order or not.

If the cart was NOT used, the confirmation window looks like this:

Check the value in the field and click on the Confirm button.

If the cart was used, the confirmation window looks like this:
Check the data, change it if necessary and click on the Complete button.

Refund

From your Personal Area you can issue refunds on transactions (orders paid by customers).

Refunds are issued from the Transaction information page by using the Refund button.

The Refund button is used to issue a full or partial refund to the client. The functionality of the button depends on the status of the order and whether a shopping cart was used or not.

Refund

To issue a refund to a client, follow these steps:

  1. While on the Transaction information page, click on the Refund button.

A refund confirmation window will open.

  1. Check the refund amount.

  2. Click on the Confirm button. The order status will become Reversed.

Refund specifics depending on phases, status, and shopping cart

The table below shows all refund options depending on the status of the payment, the number of phases in it, and whether a shopping cart is used or not.

With cart Without cart
One-phase Deposited - refund for specific items Deposited - refund in amount, partial available
Two-phase Approved - refund in amount, full amount only
Deposited - refund for specific items
Approved - refund in amount, full amount only
Deposited - refund in amount, partial available

Tokenization and Certificates

The Payment Gateway supports tokenized payments using Apple Pay, Google Pay, and Samsung Pay.

Documentation is available here