Dynamic Checkout Customization with Parameters

By default, the Hosted Payment Pages dynamically localize the currency, language, and payment options based on the shopper's IP address. You can control the appearance of some of the fields on your checkout pages, and pre-populate values in the fields, by adding specific parameters to your checkout page URL. These parameters are called "Hosted Payment Page parameters."

For the complete list of available parameters, see Hosted Payment Page Parameters.


For example, you could force the checkout page to appear in Danish and with the currency set to Euros by adding the &currency=EUR and language=DANISH parameters to the checkout page URL.

This is what a complete URL may look like with these parameters:

What can I do with Hosted Payment Page parameters?

Here are some common ways to use Hosted Payment Page parameters:

  • Accelerate the shopper's checkout experience by passing in shopper details you have previously collected
  • Take control over the default settings on the page, such as default language, currency, and payment method
  • Improve shopper convenience by passing coupon codes and promotions into the checkout page

How do I send the Hosted Payment Page parameters?

You can send Hosted Payment Page parameters in two ways:

1. As an HTTP GET request, with the parameters added directly to the URL.
You can manually add any of the Hosted Payment Page Parameters to your URL, using & as the separator between parameters (see example above).

2. As an HTTP POST request, so that the parameters are inside the request rather than added to the URL.
To learn how to generate the Hosted Payment Page via an HTTP POST request, click here.

Back to Top