locale
option. If not provided, the locale is automatically derived from the browser:
Locale | Language | Minimum versions |
---|---|---|
ar | Arabic | v1.22.1 |
bg-BG | Bulgarian (Bulgaria) | v2.1.1, v1.37.0 |
cs-CZ | Czech (Czech Republic) | v2.3.0, v1.38.0 |
da-DA | Danish | v1.22.1 |
de-DE | German | v1.22.0 |
el-GR | Greek (Greece) | v1.22.1 |
en-US | English (United States) | v1.0.0 |
es | Spanish | v1.22.0 |
es-AR | Spanish (Argentina) | v2.2.1 |
et-EE | Estonian (Estonia) | v2.3.0, v1.38.0 |
fr-FR | French (France) | v1.19.0 |
hr-HR | Croatian (Croatia) | v2.3.0, v1.38.0 |
hu-HU | Hungarian (Hungary) | v1.18.0 |
it-IT | Italian (Italy) | v2.1.1, v1.37.0 |
ja-JP | Japanese (Japan) | v2.3.0, v1.38.0 |
lt-LT | Lithuanian (Lithuania) | v2.3.0, v1.38.0 |
ms | Malay | v2.26.1 |
nb-NO | Norwegian (Norway) | v1.22.1 |
nl-NL | Dutch (Netherlands) | v1.22.1 |
pl-PL | Polish (Poland) | v1.22.1 |
pt-BR | Portuguese (Brazil) | v2.3.0, v1.38.0 |
pt-PT | Portuguese (Portugal) | v1.22.0 |
ro-RO | Romanian (Romania) | v1.37.0 |
ru-RU | Russian (Russia) | v2.1.1, v1.37.0 |
sk-SK | Slovak (Slovakia) | v2.1.1, v1.37.0 |
sv-SE | Swedish (Sweden) | v1.22.1 |
th | Thai | v2.26.1 |
tr-TR | Turkish (Turkey) | v1.22.1 |
vi-VN | Vietnamese (Vietnam) | v2.3.0, v1.38.0 |
zh-CN | Chinese (Mainland China - Simplified characters) | v2.26.1 |
zh-HK | [BETA] Chinese (Hong-Kong - Traditional characters) | v2.26.1 |
zh-TW | [BETA] Chinese (Taiwan - Traditional characters) | v2.26.1 |
locale
to activate right-to-left:
style
object as a checkout option when calling showUniversalCheckout
.iframe.
So any font-family
that you have set in the CSS file will be used by the Universal Checkout. The example below uses MyFont
as the preferred font family for card input.
iframe
. This means that font-family
declarations, and @font-face
directives that load and define fonts are not passed to these specific fields.
To forward font-family
and @font-face
to the card input fields, you can set style.input.base.fontFamily
and style.fontFaces
.
Alternatively, to style.fontFaces
, you can forward stylesheets to the iframe
using the style.stylesheets
option, which facilitates the integration of fonts coming from services such as Google Fonts.
InputStyle
defined in input:base
will be used everywhere. You need to add value for InputStyle
only if you wish to override this style for inputLabel, hover, placeholder etc.
Styling Example
inputLabelsVisible
option.InputStyle
defined in input.base
will be used everywhere. But you can override this where you need different error message styling by specifying the style for input.error
and inputErrorText
. inputErrorText
also uses TextAlignmentStyle
.
Error Input Styling Example
ErrorMessageStyle
interface which extends Block Styling Options and Text Styling Options mentioned above.
formSpacings
properties.
submitButton
uses TextStyle and BlockStyle to define the style of the button.
By default, the style defined in submitButton.base
will be used everywhere. If you wish to override the default style for loading, disabled, hover or focus or other states, you will be required to add values for TextStyle and BlockStyle properties.
Submit Button Styling Example
customerId
is included in the client session.
showMorePaymentMethodsButton
uses TextStyle to define the style of the button. By default, the style defined in showMorePaymentMethodsButton.base
will be used everywhere. Add values for TextStyle only if you wish to override this style for the disabled state.
actionButton
uses TextStyle to define the style of the button. The confirmButton
uses both TextStyle and BlockStyle interfaces.
Pay by Card
card.preferredFlow
field:
DEDICATED_SCENE
EMBEDDED_IN_HOME
(default)style.input
property. The pay with card button can also be styled, if you prefer not to use the default styling. See Styling Payment Method Button for details.
paymentMethodButton
uses TextStyle to define the style of the button.
context
with the currentSceneId
. This enables you to determine which submit button to show/hide, enable/disable, or modify the content.
In addition, the onVisible
callback also contains previousSceneId
in the context object. This enables you to hide the button of the previous scene if necessary.
onTokenizeSuccess
depends on the payment method that the customer chooses. Some of them require the display of a screen that summarizes the order.
It is recommended best practice to show a success screen once the payment is validated. You can use the successScreen
options to determine whether to show a built-in success screen or a custom one.
The available built-in success screen types are 'PAYMENT_METHOD'
and 'CHECK'
.
successScreen
used when no type is defined is 'CHECK'
.Success Screen - Check
'CHECK'
as a success screen type, it is also possible to specify a custom success title which will be displayed under the success check mark icon.
successScreen
to false
overrides the default behavior so that you can show a custom success screen after onTokenizeSuccess
is called: