Classic-integration icon

Creating and editing translations

Hosted Payment Pages are no longer available

To accept payments through an Adyen-hosted page, use our Hosted Checkout.

This page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life. We are no longer processing transactions though HPP.

You don't 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:

Language ShopperLocale
Chinese – Traditional zh_CN
Czech cz
Danish da
Dutch nl
English – British* en_GB
English – Canadian en_CA
English – US en_US
Finnish fi
French fr
French – Belgian fr_BE
French – Canadian fr_CA
French – Swiss fr_CH
Frisian fy_NL
German de
Greek el
Hungarian hu
Italian it
Lithuanian li
Norwegian no
Polish pl
Portuguese pt
Russian ru
Spanish es
Swedish sv
Thai th
Turkish tr
Ukrainian uk

 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.

The resources files use the Latin 1 encoding (ISO 8859-1). We recommended that you treat them as US-ASCII only. Any character that is outside the US-ASCII set should be encoded in Unicode using the notation \u + UTF-16 code point. Thus "é" becomes "\u00e9" and "Ř" becomes "\u0158".