Iframe
Yellow
Embed
Naked
Short
Embed Short
Box
Open Banking
Flow
Flow

Our newest design. One page from start to finish with no confirmation step, the payment method can be changed without losing what has already been typed, and it supports a wide two column layout. Select it with ui_version=11. See all Flow options.

Controlling the design

You can load the specific design by passing the ui_version param in your payment page request, if the field will not be passed the default template set to the merchant account will be loaded - You can configure the default template under the MCP configuration .

Parameter Name Length Parameter description Mandatory
ui_version 1 1 = Default
2 = Box
3 = Embed
4 = Short
5 = Embed Short
6 = Iframe
7 = Open Banking
8 = Yellow
9 = Crypto
10 = Naked
11 = Flow
 Optional
Layout 1 Controls how the Flow design (ui_version=11) arranges the page. Every other template ignores it.

1 = single column (default if the field is empty or omitted). Everything is stacked in one narrow column: the order details, then the payment method, then the form.
2 = two columns on a wide screen. The order details, cart, amount options and payment method list are placed on one side and the payment form on the other, for a fuller checkout feel. Below roughly 900 pixels it falls back to the single column layout on its own, so it is safe to send for mobile traffic.
3 = full width. The page fills whatever space it is given instead of being capped and centred, for merchants who frame it in their own iframe and set the width there. The border around the form is not drawn in this mode.
4 = the Iframe design's look, applied to this template: a 600 pixel sheet with a soft shadow, and underlined input fields with the label above them, rather than the boxed fields of layout 1. Useful for merchants moving over from the Iframe template who want the form to keep looking familiar.
5 = showcase. The product on one side and the payment column on the other, for a product page that ends in a payment.
6 = invoice. A full invoice document with the payment form beside it.
7 = landing page. A full marketing page with the checkout further down.

See Flow template options for a wireframe of each layout.
 Optional
background 9 Background colour for the payment page, as a hex value (for example #eef2f7 or eef2f7).
The form itself stays white and is given a thin border and rounded corners, so it reads as a sheet on top of the colour.
Only the Flow design (ui_version=11) uses this field. If the value is not a hex colour it is ignored and the default background is used. 		Optional
show_chrome 5 true/false - controls whether the payment page shows its surrounding furniture.
true = normal page (default if the field is empty or omitted).
false = the header (merchant logo and language selector), the footer (security marks and brand line) and the order details are all hidden, leaving the payment form and the pay button.
Amount, shipping and installment selectors are NOT hidden, because the customer still has to answer them. The pay button shows no amount.
Only the Flow design (ui_version=11) uses this field. 		Optional
disp_payButtonText 40 Your own wording for the pay button once the form is ready to submit. It is shown exactly as sent, with no amount added, so translate it to the customer's language and URL-encode it.
If it is empty, omitted or longer than 40 characters, the default wording applies.
Only the Flow design (ui_version=11) uses this field. See Flow template options. 		Optional
Custom Text

Add additional text to your payment page.
Custom CSS

Control the CSS of your payment page.
Product pages

Learn about our product pages.