Customization options
Airwallex.js supports visual customization of Elements using various parameters.
Global options
You can provide global customization options such as locale in the init() function to extend it to all Elements.
locale
Allows you to globally configure localization for Airwallex.js Elements. The specified locale will be applied to both the Element UI strings and error messages unless overridden by the locale field at the Element level (except Payment Elements).
For Payment Elements, the locale defaults to the browser's locale; however, if the browser's locale is not supported, it will default to 'en'.
For supported locales for all Elements, see the init() locale JS property.
KYC Element
The KYC Element kyc requires that the provided locale is supported by the onboarding business’s registration country. For example, ‘fr’ is supported if the business is registered in Canada or an EU country.
Here's a list of supported locales by country.
| Locale | Business registration country |
|---|---|
| fr | AT, BE, BG, CA, CY, CZ, DE, DK, EE , ES, FI , FR, GR, HR , HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK, IS, LI, NO, GF, GP, MQ, YT, RE, MF |
| zh | China, Hong Kong |
fonts
Only applies to Payment Elements.
You can provide the fonts option in the init() function and extend it to all Payments Elements. src, family and weight properties may be specified.
Customizing Payment Elements
The customization options listed below apply only to Payment Elements. For other Elements, please contact your Airwallex Account Manager to enable customization in line with your business requirements.
| Element | Customization options |
|---|---|
| Drop-in Element | appearance and layout objects. See Drop-in Element customization.See also: Hosted Payment Page customization |
| Card Element | style, appearance objects. See Card Element customization.
|
| Split Card Element | style, appearance objects. See Split Card Element customization.
|
| Google Pay Element | style, appearance, buttonType, buttonColor, buttonSizeMode objects. See Google Pay Element customization.
|
| Apple Pay Element | style, appearance, buttonType, buttonColor objects. See Apple Pay Element customization.
|