Checkout & Payment Page
Overview
| Type | When does a payer see this page? | Customizable |
|---|---|---|
| ICEPAY Payment Page | - Card (Visa & Mastercard) payments - Bancontact payments - Pay by Bank payments |
Yes |
| ICEPAY Checkout Page | - When your integration does not provide a Payment method when creating a Checkout. - When creating a Payment Link via the ICEPAY Portal - When a customer cancels a payment on an external Payment Page. |
Yes |
| External Payment Page | iDEAL | Wero payments EPS payments Online Überweisen payments Pay by Bank PayPal payments |
No No No Yes No |
ICEPAY Payment Page
A payer selects a payment method at the (webshop)checkout, and is redirected to a secure ICEPAY Payment Page to complete the payment.
This Payment Page will be tailored for the selected payment method.
For example, on for a Bancontact payment we show the Bancontact logo.
ICEPAY Checkout Page
When your integration does not provide a payment method when creating a Checkout, we display the ICEPAY Checkout Page, which shows all available payment methods for the merchant.
We strongly recommend specifying a payment method when creating a checkout for optimal conversion.
However, for a quick go-live or limited technical capabilities, it is possible to allow the payer to choose a payment method on the ICEPAY Platform.
When you manually create a Payment Link via the ICEPAY Portal, we always show the ICEPAY Checkout Page.
When a customer cancels a payment on an external Payment Page. We offer the customer to finish the payment with a other Payment method.
Customize
Image formats
The images you upload can be in the following formats:
jpeg
png
svg
webp
We recommend customizing the ICEPAY Checkout & Payment Pages to increase conversion.
How to upload
- Login on the ICEPAY Portal
- Go to Merchants, select a merchant
- Go to Customize Checkout & Payment page
Dimensions images
| Element | Dimensions |
|---|---|
| Banner | > 128px height 512px width |
| Logo | > 96px height 96px width |
- The ICEPAY Checkout & Payment Page center on the middle of the image, so the images can be larger.
- Logo is only visible if a banner is uploaded.
- If no logo is uploaded the logo section is not shown.
Banner tips
| Color | |
|---|---|
| Green | Always visible |
| Orange | Visible when the screen is wider |
| Red | Visible when the screen is longer |
| Yellow | Visible when the screen is longer & wider |
Example 720x720 banner

Languages
The ICEPAY Checkout & Payment page supports the following languages:
- English
- Dutch
- French
The language is automatically displayed based on the customer's browser settings. If the customer's preferred language is not available, the page will default to English.
Redirect to the ICEPAY Checkout Page or Merchant
When your integration does not provide a payment method when creating a Checkout, we display the ICEPAY Checkout Page, which shows all available payment methods for the merchant.
We strongly recommend specifying a payment method when creating a checkout for optimal conversion.
However, for a quick go-live or limited technical capabilities, it is possible to allow the payer to choose a payment method on the ICEPAY Platform.
When you manually create a Payment Link via the ICEPAY Portal, we always show the ICEPAY Checkout Page.
When a customer cancels a payment on an external Payment Page. We offer the customer to finish the payment with a other Payment method.
A redirect URL has to be provided during the creation of a payment. Without a redirect url we always send the customer back to the ICEPAY Checkout Page
Please note that if the portal setting is set to Redirect back to merchant and the property in the API request is to false, the api request takes precedence and the customer will be redirected to the ICEPAY Checkout Page
Disable via the portal
- Login on the ICEPAY Portal
- Go to Merchants, select a merchant
- Go to Settings
- Edit the Redirect back to merchant setting. Selecting Redirect back to merchant disables the redirect to the ICEPAY Checkout Page.
Disable via the API
If you want to disable the redirect for specific checkout you can do so by providing the following setting the "redirectBackToShop" property in the meta object to true. For more info see our API FAQ