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.

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.
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.
Only the Flow design (ui_version=11) uses this field.
Optional