This guide sums up all the requirements to be able to theme the Handpoint app. There are two theming options available for partners/merchants:
Partner/merchant logo on payment screen and receipt
Partner/merchant logo on payment screen and receipt, as well as full colour theme of screens and buttons as described below.
Please contact your account manager for commercials for app theming.
Handpoint has an intuitive, simple-to-use yet powerful app that enables any merchant (from pop-ups to big retailers) to accept payments instantly and securely. As a way to provide the same seamless experience to our partners’ customers, the app can be customized to include the partner’s logo and even colours. Thus, offer the same simple user experience with some of their own branding.
Logos provided to Handpoint should be in SVG format. If SVG is not possible, a transparent PNG of max 100px of height would be required. Handpoint typically requires two logos, one that works for darker backgrounds and one for lighter ones.
Where will my logo appear in the App ?
On the numerical keypad in standalone mode
On the cloud ready screen in integrated mode
At the bottom of the settings screen ( along with “powered by Handpoint”)
Format example → --theme-image-logo: url('https://theme.handpoint.com/theme_name/logos/handpoint-logo-hvitt.svg');
Links to your website
Handpoint allows partners to add links to their website, user guides or FAQs directly in the settings of the app. For PAX devices, a QR code is generated to be scanned with a phone because the terminals do not have internet browsers installed for security reasons.
The logo appearing on the receipt will be the same one as in the payment application, it is also possible to not display any logo on the receipts if required. At this point in time it is not possible to display a merchant specific logo on the receipt.
This is how the logo on the receipt looks rendered as HTML in the Handpoint app:
For payment devices with a printer, this the printed version of it:
There are background patterns that can be modified or removed.
--theme-bg-pattern-background: (Transparent white pattern with transparent background for dark backgrounds)
--theme-bg-pattern-background-inverted: (Transparent grey pattern with transparent background for light backgrounds)
The following backgrounds are defined as a gradient color and the format to define them is “linear-gradient(‘inclination in deg’, ’color 1’, ‘color 2’)” where ‘color1’ is the bottom color and ‘color 2’ is the upper color (if you want to have a solid background color, you can choose color 1 = color 2).
Format example → linear-gradient(0deg, #2c3059, #303b70);
--theme-gradient-bg: Used in onboarding, payment status and filter period.
--theme-gradient-clean: Used in currency, device and language configurations.
--theme-keyboard-background: The background for the numeric-keyboard.
--theme-gradient-success: background for success actions.
--theme-gradient-error: background for error actions.
--theme-gradient-warn: background for warning actions.
The backgrounds described above can be combined with the background pattern.
The button colors are defined by their type of action
--theme-color-light: Light color is also for the list divider
--theme-color-placeholder: The label of the divider
--theme-color-super-light: Super light color is for odd items from the list and even items are white.
--theme-color-light is used in different component: buttons, lists and checkboxes.
--theme-keyboard-button-border: format example → --theme-keyboard-button-border: 1px rgba(0, 0, 0, .1) solid;
--theme-screen-background-image: Format example → linear-gradient(0deg, #2c3059, #303b70);
--theme-screen-text-color: The text on the screen.
Note: ‘change due’ with positive values are always --theme-color-success and negative values are always --theme-color-danger