Advantages of using MyCheckout hosted pages

• Page responsiveness automatically adjusts to device screen sizes
• Customize the look and feel using our online MyCheckout editor
• Compatibility with desktop, tablet, and mobile screens
• Editable text options for the payment page
• Selection of 50 languages/locales
• Integration of all Worldline platform payment products into hosted pages

Add MyCheckout hosted page to your site

1. Initiate a hosted checkout via the Create hosted checkout API call (check the input details on our API reference)
2. The call will return you an HTTP status 201 and a partialRedirectUrl field with the URL to redirect your customer to the checkout page. The hosted process will run on the following domain: https://secured-by-ingenico.com
3. Consider the additional possibilities:

• set a custom return URL via returnUrl in HostedCheckoutSpecificInput for personalized redirection
• control display of the payment result page using showResultPage parameter in HostedCheckoutSpecificInput to either show the Worldline page or redirect customers to the return URL after payment

You can access all customization options via the sidebar menu in the configuration center:

• Look & feel
• Hosted payment page editor
• Language packs
• Subdomains
• Test URL

Before you begin

If multiple merchantIDs are linked to your account, make sure the right one is selected before starting the hosted page customization process.

Create a new variant for the look & feel 

To start designing your page's look and feel, you need to add a new variant.

In the appeared window, type the name of your variant and select one of the available templates:

• responsive: page adapts automatically to the screen of the consumer's device (desktop, tablet, and mobile, both in portrait and landscape mode)
• minimal (iframe):if you want to use an iframe to implement the page (offering you customization of your own preference around it), you can choose this format, although you might consider using our powerful JavaScript Client SDK to handle iframe-like situations in a much more graceful and flexible way

When you press the "Save variant" button, you'll it added to the list of existing ones. Every variant comes with the following information:

• Variant name - make sure to give the variant a definitive name you'll recognize later
• ID - number assigned to the variant that you need to put in the HostedCheckoutSpecificInput property of the Create hosted checkout API call
• State - the page status that can be published, has unpublished changes, and unpublished
• Latest change - when the page was altered and by whom
• Actions - the dropdown allows you to see what actions can be performed with the variant

My look & feel

This feature replicates your website's style and format by extracting and recreating your web page elements in MyCheckout hosted payment pages. To do so, web crawling and scraping techniques identify the design data needed to copy your website's style and format.

Once your website's style has been imported into the MyCheckout editor, you can easily customize your hosted payment pages.

How to use my Look & Feel

Step 1 - Log in to your Configuration Center account and locate the "Look & Feel" section in the left menu.
Step 2 - Click "Copy my look & feel" to start creating a variant. Or you can also click "Add variant" to begin. If you already have an existing variant and you want to use this feature, you will need to create a new variant.

Step 3 - Give the variant a name and set the template.
Step 4 - Fill in your website URL. The URL you enter is the one that is used for web crawling and scraping to extract your design data. By putting the website URL in the configuration center, you state that you have the full authority to allow Worldline to perform any action needed to replicate MyCheckout Hosted payment pages with your website's look and feel.

Step 5 - Click "Save variant" to continue. You'll see a message that you have successfully created the variant.

Step 6 - Click the variant to activate it.

Step 7 - To see the results of My Look & Feel, click "Actions" and "Edit". Your website will be analyzed once MyCheckout editor is opened. A window then displays the progress of the analysis. Once the elements of your website have been extracted and imported, you can see the result in the editor.

Step 8 - You can easily adjust the variant in MyCheckout editor to ensure it meets your requirements as you would with any new variant for which you don't use My Look & Feel feature.

Terms and Conditions

As these design data may be protected by intellectual property rights, you warrant us that you have the necessary rights to allow Worldline to perform any action that is needed (such for example, copying and displaying design data) in order to have your My Checkout Hosted Payment Page with the same look and feel as your website.

Depending on the number of pages of your website and depending on the code used in your website, it might be that we are not able to provide this service, or it might be that the result is not accurate. Worldline provides no guarantee in this respect.

Edit the payment page

MyCheckout editor is the tool to customize all your payment pages. It comes with a guided tour, which explains the options to design your payment pages how you like them. The first time you open this tool, you'll get notified by a popup in the screen's bottom left corner. You can always restart the walkthrough tour by clicking the question mark in the bottom left corner.

The editor allows you to change elements such as the logo, background colors, images, buttons, fonts, input fields, and more.

Payment products

Our MyCheckout hosted payment pages supports all payment products that the Worldline platform offers, so credit cards, wallets, bank transfer etc. Some of these products are hosted on the page itself and some require a redirect to the third party (e.g. Skrill). Products that are hosted on the page itself will follow the styling you configure in the configuration center. Redirect products will not, as their visual appearance is not handled by the Worldline platform.

Language packs

The texts shown on the MyCheckout hosted payment pages are translated into 35 languages and many more locales, so you can offer the page in the language your customers speak.

If you want to change the default text as we provide it, you have the following options:

• change the texts for all variants (use the language pack option in the configuration center)
• change the text for one variant (use MyCheckout editor of the payment page, which is in the "Look & Feel" section of the configuration center)

Change the text

To change the language packs, you first download the default package of the language you want to change. Alter the words in the second column as the first column provides the details of which text belongs to which field on MyCheckout hosted payment pages. Once you are done, remember to save the file locally on your computer.

How to upload new language packs

• Press the "Actions" button
• Choose the option "Upload new language pack"
• Select the language and locale
• Add the file by dropping it in the pop-up screen or upload it by clicking "click to upload"

• Press the "Next" button
• We'll provide you with an overview of the language keys that have changed, and you can verify these again
• If the changes are correct, press "Yes, this is correct." If they are incorrect, you can go back or cancel the upload completely
• Your new texts are uploaded to our system and will be activated automatically after publishing

To show your customers the language of their country, you need to provide us with this info in the API. It can be done by setting the locale field in the HostedCheckoutSpecificInput field of the Create Hosted Checkout API call you use to start the hosted process for your customer.

One of the languages in the list is set as default. If you don't specify the language yourself, we'll present your customer with your chosen default language (we'll also default to this language when the locale you provide is not recognized). To deactivate a specific language, click the Actions > Deactivate.

Available languages and locales

Expand to see more

Language name	LanguageCode ISO 639-1	Locale
Arabic	ar	EG
Chinese (Simplified)	zh	CN
Chinese (Traditional)	tc	HK
Croatian	hr	HR
Czech	cs	HR
Danish	da	DK
Dutch	nl	NL
Dutch-Belgium	nl	BE
English	en	GB
English-Australia	en	AU
English-Canada	en	CA
English-Ireland	en	IE
English-NZ	en	NZ
English-US	en	US
Estonian	et	EE
Farsi (Persian)	fa	IR
Finnish	fi	FI
French	fr	FR
French-Belgium	fr	BE
French-Canada	fr	CA
German	de	DE
German-Austria	de	AT
German-Belgium	de	BE
German-Switzerland	de	CH
Greek	el	GK
Hebrew	he	IL
Hindi	hi	IN
Hungarian	hu	HU
Italian	it	IT
Italian-Switzerland	it	CH
Japanese	ja	JP
Korean	ko	KR
Latvian	lv	LV
Lithuanian	lt	LT
Malaysian	ms	MY
Norwegian (Bokmal)	nb	NO
Polish	pl	PL
Portugese-Brazil	pt	BR
Portuguese	pt	PT
Romanian	ro	RO
Russian	ru	RU
Slovak	sk	SK
Slovene	sl	SL
Spanish	es	ES
Spanish-Argentina	es	AR
Spanish-Colombia	es	CO
Spanish-Mexico	es	MX
Swahili	sw	KE
Swedish	sv	SE
Thaï	th	TH
Turkish	tr	TR
Ukrainian	uk	UA
Urdu	ur	PK
Vietnamese	vi	VN

Subdomains

In this section, you control the subdomains for hosting MyCheckout payment pages. By default, we provide a handful of subdomains that are ready to go for all our clients. These are labeled as "shared" and can't be altered. The page that your customers see depends on the API key you use when making the hosted payment page URL.

If you'd like a subdomain that connects with your company's name or website, adding an extra layer of trust for your customers during payments, you can request up to 5 subdomains. Just remember these won't include the ones already marked as "shared." The main domain for the MyCheckout hosted payment pages is https://secured-by-ingenico.com

Adding subdomains on your own through the configuration center is simple. Just click "Request new subdomain" and enter the desired name in the pop-up window. Afterward, hit "Request subdomain," and we'll let you know if the domain gets approved.

Testing your design

Generate test URL

The test URL is used as a starting point for your device to enter the test mode, accessible from the page editor. It can be the homepage of your website, shopping cart, or checkout page, depending on your needs. To test your design, please press the "Test" button in the MyCheckout editor.

Alternatively, you can set the test URL in the submenu of the "Merchant settings" section of the configuration center.

How do you start the test?

Once you have set up the test URL, you can validate your hosted payment page in your regular checkout flow. Press the "Test" button in the MyCheckout editor to do so. You can scan the QR code, copy the URL, or send it via email.

What happens once you click the test URL?

The device you used to click the test URL link is linked to a particular version of MyCheckout's hosted payment page. This means that when you perform a checkout on your sandbox website using this device, it will automatically use this specific version. This allows you to test this version in a real-world environment. Other visitors, on the other hand, will still see the currently published version that is set up by default.

To begin testing, go to your website and initiate a checkout process. Keep in mind that you'll be operating within the sandbox environment, so any orders you make will be treated as real orders.

Test mode message

Whenever you initiate a checkout, you'll see a message confirming that it's in test mode. This message will keep appearing whenever you access the checkout as long as this device is configured for testing. If you decide to close this message, it won't reappear unless you restart your browser. When you exit the test mode, the device will no longer be set to use the test version. You can easily switch it back to test mode by clicking the URL that brought you there.

Test mode end message

The person who sent you the test link can end the test anytime. If they do so and you begin a checkout, you'll see a special message. To initiate a new test, reach out to the person who originally started it, as they can provide you with a new test link. During this time, the standard published variant will be in use.

Testing multiple variants

Each test link configures your device to test a particular variant. Remember that a device can only have one test variant enabled at a time. If you wish to test multiple variants sequentially, simply click on the respective test links before starting each test. Your device will switch to the chosen test variant, and you can switch as many times as needed.

A/B testing

You can perform A/B testing by preparing different versions of your payment pages. However, please note that you must have at least two versions published simultaneously to engage in A/B testing. Afterward, you can analyze the results to make informed decisions.

To utilize A/B testing effectively, simply add the ID of the variant you want to test to the "variant" field in the HostedCheckoutSpecificInput data element within the Create Hosted Checkout API call. When you initiate a new MyCheckout hosted page session for your customers, you can specify which variant to use.

By monitoring the conversion results for a particular variant, you can conduct A/B testing with various alternatives, ranging from A and B to even C to Z if you wish. It's worth noting that you have complete flexibility in how you use this variant field. You can control it from your e-commerce system, implement a straightforward 50-50 split, base it on time or location, or employ any method that suits your needs.

Redisplaying instructions page

Certain products display payment instructions to customers towards the end of the payment process. Giving your customers the option to see those instructions again can be helpful.

With MyCheckout hosted payment pages, you get the benefit of having this feature available. It enhances the e-commerce experience by allowing customers to see the instructions again easily. It's worth noting that customers often need to refer back to the instructions after the initial payment session has ended.

• Start the redisplay process by creating a new session using the Create SessionKey Server API call.
• The API call will return you clientSessionId.
• With the initial Server API response for CreatePaymentRequest or CreateHostedCheckout you received (for an instructions type payment product) a text return value in the CreatedPaymentDetails field named instructionsRenderingData.

As a merchant, you should store this exact value in your order history for the customer as you need it to redisplay the instructions.

• Using the newly created clientSessionId and the instructionsRenderingData, post to the /instructions endpoint of the API in the /instructions/// format. In addition to the instructionsRenderingData, you can optionally provide a locale and variant if you want to use A/B testing here. If you don't specify it, the defaults will be used.

Feel free to redisplay the instructions page whenever needed: there's no limit to how many times you can do this, as long as you have the instructionsRenderingData saved in your system.

If you modify the appearance of MyCheckout hosted payment pages through the configuration center, the way the instructions are shown will change in looks. However, the financial information will stay the same as when the payment was made. It's important to remember that the instructions redisplay adjusts well to different devices like smartphones and tablets, providing a smooth experience.