Creating your own language versions

You can create your own language versions of the Payment Service pages and emails by downloading an appropriate messages_*.properties files from our server, then translating the messages to suit your needs, and then uploading the modified file to your Test environment on our server.

Before proceeding, we suggest that you contact Technical Support with information about the language you want to use, as we may already have Payment Service pages in that language.

To create a new language version based upon the English message properties files:

1.      Download the following files that we use to provide all of the standard English text messages for the Payment Service pages and Confirmation Emails:

2.      Collect all of these messages into one file, then rename its two-character language identity to suit the target language: for example, messages_la.properties for the Latin language. For more information on naming conventions, please refer to The message files.

3.      Open the messages_la.properties file with a text editor and translate the value of each message value as required, take care to translate only the value of each property rather than the property name: for example, to change the English value of the Make Payment button, alter the property value card.makePaymt.butt=MAKE PAYMENT to card.makePaymt.butt=SERVITIUM,

4.      Add target language identity properties and appropriate values, such as, lang.name=Latin and lang.charset=ISO-8859-1: for more information please refer to Message files - language identifiers.
If your new language will use a specific character set to enable support of non-English characters, such as Arabic, Russian or Chinese characters, then please refer to Character sets for the selected language.

5.      Upload the new messages_la.properties file to your Test environment, using the File Management option in the Payment Page editor.

Testing and using the new language version

To view your new language on the Payment Service pages, use the Preview option in the Payment Page editor and select your new language from the Select Language drop down box.

We advise that you test the Payment Service pages for your new language version at the earliest opportunity, by sending some test transactions through the Worldpay payment service.

You may also want to provide help files for the Payment Service pages in your new language. To do this you will need to provide translated help files and a message properties file with updated links to your new files. For details, please refer to Help message files.

If your Payment Service pages support several languages, you can make use of display tags that will automatically display texts in the appropriate language. For more information, please refer to Display tags for multiple languages.

You can also pre-select this language for your shoppers, so that the Payment Service pages will be initially displayed in the language, by including the parameter 'lang' within the order details submission - for example, with its value set to 'la', as shown below:

<input type=hidden name="lang" value="la">