Mobile UI Customization

The components of the mobile UI for the Default UI (formerly known as "PayButton 2.0") are designed to fit seamlessly into the design of your application. You can customize the color of all components and the shape of some components. The customization details for each component include suggestions for delivering the best user experience to clients, along with some basic UI principles for meeting accessibility design standards.
For more information about customizing the UI components, see UI Customization.
Primary Color
The primary color in the mobile UI can be modified to fit any corporate design. The selected color is applied to all clickable, active, or selected UI components and present-card animations, including text and icons. The default primary color is blue (#3974FC), as shown in the example below.
To meet accessibility design standards and to provide the best user experience for your clients, the recommended color contrast ratio is 3:1 for the primary color components. These examples show different primary colors applied to the Default UI integration's mobile UI.
Primary Text Color and Outlined Buttons
The primary text color can be changed to a variety of different colors. Changing the primary text color will also affect the color of the outlined buttons and their icons. To meet accessibility design standards and to provide the best user experience for your clients, the recommended color contrast ratio is 3:1. Examples of the primary text color and outlined buttons are shown below.
Primary Button Text and Animation Details
The default color for UI components displayed on top of primary color components can be changed to any desired color. The selected color is applied to the filled button text and animation details. To achieve the best user experience and to meet accessibility standards, the recommended contrast ratio is 3:1. Examples of the primary button text and animation details are shown below.
Transaction Animations and Icons
The default color of the transaction animations and icons can be changed to a variety of different colors. To achieve the best user experience and to meet accessibility standards, the recommended contrast ratio is 3:1. Examples of the transaction animations and icons are shown below.
Button Corner Radius
The mobile UI button corner radius is set to
4
by default. The corner radius of the buttons can be changed. Examples of the Abort button with slightly rounded, rounded, and squared corners are shown below.
Background Color
The background colors for the mobile UI screens can be changed to fit your corporate design. The default background color is white. Examples of a customized background color are shown below.
Dark Mode
Dark Mode can be enabled and customized for low-light environments such as restaurants and bars. Use this enhancement to display the Default UI payment flow screens in darker contrasting colors than are displayed when using the default settings.
Examples of Dark Mode payment flow screens are shown below. Note that the Visa logo can be displayed in white in this mode.
Dark Mode payment flow image
Logo
A company logo can be applied to many of the payment flow screens. This logo format will provide the best resolution result on the screens:
  • Size: 140 x 36
  • Format: SVG or PNG
Examples of how a company logo appears on the payment flow screens are shown below.
Contactless Visual Status Indicators
The default colors for the contactless visual status indicators are green for success and red for error. These colors can be changed to fit your corporate identity. However, red or a similar color is recommended for error states. Examples of different colors applied to the contactless status indicator are shown below.
Notifications and Error Messages
The recommended color for error icon and text message UI components is red. The alert notifications, error message icon, and text colors can be changed to different colors to fit your corporate identity. However, changing these colors will also affect the color of these other components:
  • Alert notification colors (typically yellow)
  • Red transaction animations (a white cross on a red circle)
  • Entry field error states
  • Declined transaction badges on the Summary screen
Examples of notification and error messages using the default colors are shown below.
Related Links