Payment Page Customisation

Overview

Telr provides merchants with the option to customize the appearance and behavior of their Hosted Payment Page (HPP).

Merchants can customize elements such as:

Payment page button color
Button text color
Payment page logo
Font family
Border radius
Card header visibility
Arabic text input
Address collection
Default transaction type
Saved card options
Return URL payload

These settings can be accessed from the Hosted Payment Page section under Configuration.

Important: To use a custom logo on the Payment Page, the logo must first be uploaded under Additional Files. Once the logo has been successfully uploaded, it will become available for selection in the Logo dropdown under Payment Page Configuration.

Accessing Hosted Payment Page Settings

To access the Payment Page customisation options:

Log in to the Telr Merchant Dashboard.
Navigate to Configuration.
Select Hosted Payment Page.
Two options are available:
- Configuration
- Additional Files

These two sections are used together when customising the Hosted Payment Page.

Uploading a Custom Logo

Before selecting a custom logo in the Payment Page Configuration, the logo must first be uploaded under Additional Files.

Steps

Navigate to:

Configuration → Hosted Payment Page → Additional Files
Additional Files page displays any files that have already been uploaded.
Under Upload New File, click Choose File.
Select the logo file from your computer.
Click Upload.

Supported File Types

The uploaded file must be an image in one of the supported formats:

JPEG
PNG

Maximum file size: 256 KB

Important

The uploaded logo will initially appear under Existing Files.

The logo will then be available in the Logo dropdown under:

Configuration → Hosted Payment Page → Payment Page Configuration

Note: Uploading the logo under Additional Files does not automatically apply it to the Payment Page. The uploaded logo must also be selected from the Logo dropdown in Payment Page Configuration.

Payment Page Configuration

Navigate to:

Configuration → Hosted Payment Page → Configuration

Payment Page Configuration screen contains several sections.

Payment Page Appearance

The Payment Page Appearance section allows merchants to customise the visual appearance of their Hosted Payment Page.

Note: These settings must be activated/applied to appear on the live Payment Page.

Button Colour

Allows the merchant to define the colour of the buttons displayed on the Payment Page.

The colour can be specified using a colour value/hex code.

Example:

#05a787

Button Text Colour

Allows the merchant to define the colour of the text displayed on the Payment Page buttons.

Example:

#FFFFFF

Logo

Allows the merchant to select the logo that will be displayed on the Hosted Payment Page.

Logo Selection Process

The process must be followed in this order:

Step 1: Upload the logo under:

Configuration → Hosted Payment Page → Additional Files

Step 2: Return to:

Configuration → Hosted Payment Page → Configuration

Step 3: Open the Logo dropdown.

Step 4: Select the uploaded logo.

Important: A logo will only be available for selection after it has been uploaded successfully under Additional Files.

Font Family

Allows the merchant to select the font family used on the Hosted Payment Page.

The available options depend on the fonts supported by the system.

Border Radius

Allows the merchant to configure the roundness of UI elements such as buttons and other page components.

A higher value results in more rounded corners.

Hide Card Header

Allows the merchant to hide the card header and card brand logos from the Payment Page.

When enabled, the relevant card header information will not be displayed.

This option applies when the Payment Page is embedded in an iframe and cards are the only available payment method.

Recommended Logo Configuration Process

For clarity, merchants should always follow this sequence when adding a custom logo:

Login to Merchant Dashboard
          ↓
Configuration
          ↓
Hosted Payment Page
          ↓
Additional Files
          ↓
Upload Logo
(JPEG/PNG – Maximum 256 KB)
          ↓
Logo appears under Existing Files
          ↓
Configuration
          ↓
Open Logo Dropdown
          ↓
Select Uploaded Logo
          ↓
Click Update
          ↓
Test / Activate Configuration

📘
All payment page configuration changes are initially applied in the Test Environment. Merchants should verify the changes in the Test Environment before making them available to customers.
Once the changes have been verified and approved, merchants can publish the configuration to the Live Environment using the Activation option under Hosted payment page.
Important: Activation copies the latest Test Environment settings to the Live Environment. This action cannot be undone. If required, merchants can use the Restore option to discard the Test Environment changes and reload the settings from the Live Environment. The Restore action also cannot be undone.