Interface language support

Overview

The text elements on the checkout page of the Payment Page—various names (including names of fields and other), hints and messages (including error messages)—are the integral part of the checkout page. These elements make the interface complete and clear and can have a significant impact on the user experience and the checkout page conversion.

Capabilities

The Payment Page interface texts are localized and can be used in languages from the basic set.

Along with that, due to different business nuances and for a better adaptation of Payment Page to a specific project, the following capabilities are available for you:

• Expanding the working language set—for example, by adding the Welsh and Scottish languages and using them along with English (from the basic set of languages) for targeting the corresponding regions of the UK. For more information, see Expanding the basic set of languages.
• Customizing text elements by using the languages from the basic set—for example, adjusting the standard German language to Low German. For more information, see Customizing text elements.
• Specifying the necessary language (or a customized text variant in one of the languages) when opening the checkout page—for example, depending on the language selected by the customer. For more information, see Specifying a language when opening the checkout page.
• Enabling customers to change the language on the checkout page—for example, if you are unsure of the customer preferences but knows what languages are relevant for the targeted region. For more information, see Enabling customers to change the language.

Combining these capabilities helps in achieving the authentic feel and behavior of the checkout page in various cases.

The default configuration

By default, unless otherwise specified in the project or request parameters, the checkout page opens without the capability of changing the language on the customer side and with the language selected automatically. In such cases, the language is set up according to the customer IP address, and the checkout page is displayed in English (if the customer is paying from any country except Russia) or in Russian (if the customer is paying from Russia).

Expanding the basic set of languages

To add new languages to the basic set, you should do the following:

1. Contact the Rocketpay technical support specialists in order to obtain the texts of the checkout page elements used within the projects for which the new languages should be added.
2. Prepare the texts translated into the necessary languages and provide them to the Rocketpay technical support specialists to have the texts embedded into Payment Page.

   In appropriate cases, this step also includes finalising the use of the language names (for displaying the names on the checkout page) and their corresponding codes (for using the codes in requests). If the languages are covered by the ISO 639-1 standard, their names and codes within the payment platform are given in the alpha-2 format of this standard, in other cases, the formats of the language names and codes are coordinated with you.

3. Receive the notification about the newly added languages and accept the result. It is also possible to check whether the text elements are displayed correctly on the checkout page with the new languages applied in the test project.

Note that, for working with some payment methods, the number of available languages can be restricted due to region-specific peculiarities and requirements of banks and other parties of the payment processing procedure. The information about such restrictions is provided in the payment methods descriptions.

Customizing text elements

For Payment Page localisation to better suit for your system, it is possible to replace the checkout page basic text elements by the customized ones.

The procedure of adding customized text elements is similar to the procedure of expanding the set of languages:

1. Decide on the projects and languages for which the customized text elements should be used and contact the Rocketpay technical support specialists in order to obtain the basic texts of the checkout page elements in the chosen languages.
2. Provide the Rocketpay technical support specialists with the ready-to-use texts in all the requested languages to have the texts embedded into Payment Page.
3. Receive the notification that the customization has been completed and accept the result. You may check the way the customized text is displayed on the checkout page in the test project at this stage.

Specifying a language when opening the checkout page

In order to localize the checkout page for a particular session, submit the request for opening the checkout page with the code of this language specified in the language_code parameter. Within the payment platform, the codes are passed in the alpha-2 format of the ISO 639-1 standard, the codes of the languages that are not covered by the standard are coordinated with the merchant.

{
   "project_id": "93211",
   "payment_id": "423289",
   "payment_currency": "EUR",
   "payment_amount": "131970",
   "customer_id": "customer_772",
   "language_code": "de",    // language code
   "signature": "TSzdE5rJZaA9TYAWEKoGpfXriFf82MxF..."
}

With this capability, the checkout page opens strictly in the language that has been specified in the request. This results in the following aspects:

• If the code in the request identifies the language beyond the working set of languages that are available in the project, the language of the checkout page is set to English.
• If the project has the capability of changing the language on the customer side set up, but the specified language is beyond the list of languages available for selection, the checkout page is displayed in the specified language and changing the language for this session is not supported.

Enabling customers to change the language

When using the basic design provided by Rocketpay, you can configure the capability of changing the language on the customer side. With this functionality, the checkout page is supplemented by a drop-down list with the names of the available languages for the customer to select the preferred one.

When using the capability of changing the language, consider the following aspects:

• If the language of the browser's interface is available in the drop-down list on the checkout page, the Payment Page is displayed in this language (unless a different language is specified in the request).
• If the language specified in the request is not among the languages available for changing in the drop-down list, the checkout page is displayed in this language and without the drop-down list.
• When the customer changes the language, they are redirected to the page that is initial within the current checkout page session, while all the previous actions are ignored.

For setting up the functionality of changing the language on the customer side, you should do the following:

1. Create the list of languages that should be available to the customers in the drop-down list and provide the list to the Rocketpay technical support specialists for embedding it into Payment Page. The list should always include English; any other languages can be selected from the working set at your choice.
2. Receive the notification about the configured functionality and accept the result. It is also possible to test the functionality of changing the languages in the test project.

Basic set of languages

Rocketpay supports displaying the checkout page in the following languages.