Creating and editing translations

You do not need to create a copy of the skin for every language you want to support. A single skin may contain translations for multiple languages and choose the appropriate string to display.

When loading a page, HPP searches for the string in the following order:

1. Skin resources files using the payment session locale res file (specified in the shopperLocale field).
2. Skin resources files using the default locale.
3. Default resources files using the payment session locale (through the Adyen Customer Area).
4. Default resources files using the default locale (through the Adyen Customer Area).

Supported languages

Adyen provides translations for some languages by default:

*  British English is the default shopperLocale

Editing existing translations

To edit translations for supported languages using the Adyen Customer Area:

1. In your Customer Area, go to Settings > Skins and on the List tab select the desired skin.
2. On the Edit skin configuration page, under Extra options select Edit Language Files.
3. Select the language that you want to add or edit translations for.
4. Edit the translations and select Save to apply the changes.

Adding translations for new languages

If you want to provide translations for a language that Adyen doesn't support by default, we recommend that you use the Customer Area for this. Alternatively, you can create a resources file for the new language.

Add a new language in the Customer Area

To add a new language to a skin using the Customer Area:

1. Look up the locale code for the language you want to add.
2. In your Customer Area, go to Settings > Skins and on the List tab select the desired skin.
3. On the Edit skin configuration page, under Extra options select Edit Language Files.
4. Enter the locale code for the new language and select add.
5. Enter the translations for the new language and select Save to apply the changes.

Create a new resources file

To add a language by creating a new resources file, you download skin files from the Customer Area, manually create a skin resources file for the new language, and then upload the customized resources file to the Customer Area.

After downloading the skin files to your computer, you'll find the resources files for all languages in the res folder. The resources.properties file contains translations for the default locale, en_GB. Resources files containing translations for other locales have locale codes included in the filenames. For example, resources_fr.properties for French and resources_en_US.properties for US English.

Proceed as follows:

1. Look up the locale code for the language you want to add.
2. Download the default resources.properties file.
3. Add the locale code to the file name. For example, resources_ja.properties for Japanese, or resources_nb.properties for Norwegian Bokmål.
4. Edit this file and replace the field values with translations for the new language.
5. Upload your new resources file to the Customer Area.