Multi-Language support

GPA supports a menu that allows the user to change the default language if authorized to do so. The user can select the desired language listed in the UI menu or request to configure the desired language at the time of deployment. The default language is English and other supported languages are French, Portuguese, Spanish, and Korean. The language list is available in the config.DB, Language table. For language support other than the aforementioned languages, the corresponding font file and catalog files should be preloaded to the device and parameters must be configured in the database.

Multi-byte Languages

Certain languages require particular character sets such as Cyrillic, Korean, Chinese, etc. The language catalog system supports multiple catalogs and each catalog can use a combination of ASCII and UTF-8; in fact if your selected text editor supports UTF-8 then this can be used to directly edit the catalogs in a visual format.

Note

GPA uses UTF-8 encoding to support international characters. However, to make full use of Unicode, the installed fonts need to support the characters in use. Providing an appropriate font is in the scope of the respective application.

Language Selection

The below table demonstrates how to select a language for the UI display:

Step	Screen	User Action	Terminal Action
1.0		Select Menu button from the idle screen.	Menu option allows the user to search for various types of transactions. Proceed to the next step.
1.1		Select Management.	The terminal proceeds to the next step.
1.2		Select Settings.	The terminal proceeds to the next step.
1.3		Select Set Language.	The terminal prompts to enter the password.
1.4		Enter the password and press  key.	If valid password is entered, proceed to the next step. If invalid password is entered, proceed to step 1.6.
1.5		Select any one of the listed languages. You can scroll to explore all the languages that are supported by the terminal.	Selected language will be set on the terminal. The screen goes back to step 1.3 while displaying the contents in the selected language.
1.6		Press  key or user time-out.	The terminal prompts to enter the password again. If correct password is entered, proceed to step 1.5. If incorrect password is entered, the terminal prompts to re-enter password the last time. If failed again, proceed to step 1.3.

Note

English is set as the default language. The default language can be changed:

1. When the device is powered on, by default, the UI menu is displayed in English. The application takes the set default language by the host from the Terminal table, CONFIGURED_LANGUAGE_ID.
2. When you change the language of the UI menu, the display is in the selected language. The selected language is retained after a power cycle.

Pre-loading Language Files

Follow the below steps to pre-load the Catalog and Font files:

1. Go to gpa_solution_baseconfigurationsolutionLocaleData.py file and add the new language details using LanguageTable.addRecord(rec)
2. Create a new catalog file in gpa_ui_vfi_blueUIwwwdefault
3. Create a new font file in gpa_ui_vfi_blueUIfonts
4. Build the new solution package

Card Language Support

The application allows the printing of a transaction receipt for customer in the language supported by the card swiped/inserted/tapped. For example, if the terminal language is set as Spanish, and a transaction is performed with a card supporting English language, then while the merchant receipt is printed in Spanish, the customer receipt will be printed in English.

This is applicable for all transaction types including Void transaction. For Void, where no card is inserted and the void of a transaction with a card supporting different language than the terminal is performed, then the customer receipt is printed in the card language only.