Handpoint is proud to offer an online portal for Terminal Management System, the place to manage your merchants and their card readers. Please get in touch with us if you would like to learn more about how you can get access to it.
...
Clicking the dropdown menu on the right lets you update your user profile.
...
Change User Password
We strongly recommend changing the password when Handpoint creates a new user for an SWP.
This is done by clicking on User Profile. It will require to enter the assigned password and the new one of your choice. Your password must be at least 8 characters long and include both numeric and alphabetic characters.
...
Searching terminals: On the Terminals screen (click on the Terminals button on the page), simply enter part of the terminal's serial number into the search bar – the last 4 digits should suffice. The results list updates automatically when it finds data matching the criteria.
Searching merchants: On the Merchants screen (click on the Merchants button on the page), simply enter what you are looking for into the search bar – at least 3 characters. You can search by fields such as merchant's name, location, ID, category code, etc. The results will be updated automatically.
Creating a Merchant
The Handpoint TMS requires just a few pieces of information to set up and activate a merchant in just a few minutes:
Merchant’s information (including MID provided by the processor).
The serial number(s) of the Handpoint card reader(s)
Use the VAR sheet to CREATE a merchant profile in the TMS
Next, use the TMS to ASSIGN the correct card readers to that merchant and easily EDIT special terminal features, e.g., tipping
Finally, the TMS generates a SHARED SECRET that is the “key” for merchants’ terminals. This key must be provided to an SWP (Software Partner) if they are storing the keys, or to the merchant directly if they are using the Handpoint app.
Configuring Merchants
Configuring Merchants
Please note that the any change on the merchant’s configuration is effective immediately and might prevent your merchants from taking payments.
Depending on your agreement with Handpoint, you might need to create and configure the merchants to onboard them into the Handpoint platform. This can be done within a few minutes and with just a few pieces of information. Please contact Handpoint support team if you need to create merchants and have questions about it.
The screen below shows the typical merchant configuration screen. From here you can configure:
Merchant information (Company name, MCC, Location and Contact details, etc..).
ISV (if applicable), Acquirer, and MID.
Parameters for Tokenisation (If it is a card token it will be used).
Card NOT Present payments: MOTO (Mail Order / Telephone Order) can be enabled on this screen.
Allow using Handpoint SmartPOS terminals as a standalone (only for merchants using Handpoint SmartPOS terminals).
Default language and tipping options for merchants using Handpoint mPOS terminals.
You can save an incomplete profile and edit it at a later stage. Once the Merchant Information is complete, you would need to Publish in order to activate the merchant.
Which fields are required?
Typically all fields are required. The system will let you know if some required fields are missing before activating the merchant.
or refer to the specific section of this help centre.
Where is the merchant key?
Partners with Native integrations - the merchant key is found on
...
the merchant profile as Shared Secret Key.
Partners with Cloud integrations - the merchant key can be created when publishing the merchant. Remember to copy or download the Merchant API key at that moment, since afterwards it will not be visible. If necessary, you can create a new API key from the merchant
...
Assigning terminals to merchants
...
page
...
On the Assign terminal screen, you are able to select a merchant and one or more terminals to assign to it. The terminals are identified by the Serial Number found on the back of the card reader. If you don’t found the Serial Number in the list of available terminals, it may be that it is assigned to another merchant or that it is not yet assigned to your profile.
...
.
To Edit a terminal, locate the terminal in the management view and click Edit terminal. You can duplicate the information from the merchant setup to speed up the process. The fields required on this step might differ depending on which processor the merchant is setup for.
In order to make the changes effective, save and publish when done.
...
Can I start creating a merchant without assigning terminals?
Yes. It is very possible to first create the merchant and add the terminal later on when you know the serial number for the card reader shipped to the merchant.
Where do I locate the Serial Number?
The terminal serial number can be found on the back of the Card Reader and on its packaging. It is a unique identifier for the terminal.
When do changes go live?
Changes are live as soon as they are published. However, changes that propagate to the card reader do not go live until the card reader connects to the gateway, i.e., through a transaction or an update. At that moment, the reader will automatically download the new configuration and update itself. This generally takes less than a minute to complete.
Deleting and unassigning
...
Deleting a merchant:
Merchants can be deleted (🚨) and terminals can be unassigned. Obviously, deleting a merchant is a high-risk operation and should only be done if there was an error during the onboarding and it is considered quicker to just delete and start over.
Terminals can be unassigned from merchants. This is done if, e.g., a merchant returns the device to you for replacement or to upgrade to an alternative Handpoint device, such as the PAX A920 PRO. Merchants with no assigned terminals are considered inactive.
Unassigning a terminal:
When terminals are unassigned from a merchant they are moved to the list of unassigned terminals (terminals view).
...
...
Terminals can be reused and moved from merchant to merchant. In order to do so, the following best practices help ensure a smooth merchant experience and minimise the risk of additional customer support.
...
Unassign terminal from old merchant
Assign terminal to new merchant
Clear the cache of the device following the instructions.
The terminal will get its new configuration after restarting the application
Datecs devices (HiLite, Hi5,..)
Unassign terminal from old merchant
Assign terminal to new merchant
Update terminal information if needed
Extract and send the shared secret
Perform a flash reset following the instructions
Initiate an update to the card reader
Steps 5 and 6 can be done by the merchant, and require minimal effort.
Locating the Merchant key: Shared Secret (Native Integrations)
The shared secret is the key to the merchants’ terminals – It is needed by the organisation responsible for storing the key on the behalf of the merchant. Typically it is the SWP’s responsibility. The shared secret is a randomly generated string of text and is the same for all terminals assigned to a single merchant. It can only be edited by Handpoint admins.
To locate the shared secret click Edit Merchant next to the merchant listed on the management page. This will bring up the Merchant Information screen.
Locate the Shared Secret as shown below. Click on the text to highlight it and Download or copy it.
...
Locating the Merchant key: API key (Cloud Integrations)
The shared secret is the key to the merchants’ terminals – It is needed by the organisation responsible for storing the key on the behalf of the merchant. Typically it is the SWP’s responsibility.
The merchant API key can be created when publishing a merchant after its creation or edition. Remember to copy or download the Merchant API key at that moment, since afterwards it will not be visible. If necessary, you can create a new API key from the merchant page.
...
Tipping Configuration
Handpoint supports tipping on the card reader only on mPOS terminals. If enabled, the cardholder is prompted to tip on the card reader during a sale. The cardholder can choose between preset values, a custom value, or “No Tip”. Tipping is enabled per terminal and custom values can be configured both on a merchant and on a terminal level.
...