Introduction
Implementation of TLA requires the development of support for a Terminal Menu on the payment device that can be used by a merchant to instigate the activation process and provide access to activation information for the purpose of support.
Terminal Menu
The following diagram provides an example flow for the terminal menu when support for TLA is being implemented:
Following is a summary of the terminal menu function:
-
The operator uses the terminal menu as part of the activation process and to confirm activation status
-
There will be a TruRating option on the terminal menu that when selected causes a Query to be sent to TruService
-
The response from TruService is used to determine which screen or options are presented to the operator
-
If TruService indicates this is a new outlet, then operator is taken to a screen that displays the activation code provided and instructions on next steps
-
If TruService indicates that the outlet is activated then operator receives a confirmation screen and can access several screens to receive their activation code, seek assistance of access optional configuration options
-
If TruService indicates that the outlet is currently suspended, then the suspended screen is shown and the operator will also be given access to the same screens as in the previous case
Activation Control
TruService via TSI 2.3.0 and above will send three fields in the response to a Query request that will be used by TLA to determine the activation status for the merchant and the outlet.
- RegistrationCode - Is applicable to a Partner ID (PID) & Merchant ID (MID) combination and once allocated is not re-used
- IsActive (True/False) - Indicates if there is an account for the PID/MID
- IsSuspend (True/False) - Indicates whether an existing account is suspended or not
The payment device or terminal can determine the activation status based on the values of these three fields as follows:
| IsActive | IsSuspend | RegistrationCode | Fetch Question/Send Transactions | Example Terminal Screen |
|---|---|---|---|---|
| FALSE | TRUE | NOT NULL | No | Screen 1 |
| TRUE | FALSE | NOT NULL | Yes | Screen 2 |
| TRUE | TRUE | NOT NULL | No | Screen 3 |
| FALSE | FALSE | NOT NULL | No | Screen 3 |
| FALSE | TRUE | NULL | No | Screen 5 |
| TRUE | FALSE | NULL | No | Screen 5 |
| TRUE | TRUE | NULL | No | Screen 5 |
| FALSE | FALSE | NULL | No | Screen 5 |
Example screens are include here. under the section on ‘Activation screens’
Note If TruModule is unable to connect with TruService or unable to exchange data then a dedicated terminal screen will be displayed reffered to in the examples as Screen 4.