Are you looking for test card numbers?

Would you like to contact support?

Classic-integration icon

Error handling for Hosted Payment Pages

Hosted Payment Pages are end-of-life
This page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life. This means we are:
  • No longer developing the HPP integration.
  • Not accepting new HPP integrations.
  • Preparing to stop accepting transactions using HPP.
Find out more about the timeline and what you need to do.

When an error condition occurs, there are some cases where Adyen cannot determine which skin and language to use to display the error message with.

To enhance the shopper experience, you have the option to include the following fields in the URL that the shopper is directed to:

Field Description
skinCode The code of the skin used.
shopperLocale A combination of a language code and country code to specify the language used in the session.

These fields are prepended to pay.shtml or select.shtml, and they separated by a forward slash (/), resulting in the following format options:




These values are used as a fallback when Adyen is unable to determine skin and language configuration.