Feature Deployment Instructions: Automated VAR

The Automated VAR feature as its name suggests, has automated the process of generating and assigning payment processing credentials to each terminal. Users can view credential statuses and remotely update them via the KioCentral portal. This automation reduces the complexity of credential generation, minimizes human handling errors, improves overall efficiency, and streamlines the workflow. Additionally, it decreases reliance on manual interventions and after-sale technical support, leading to improved customer satisfaction.

During the deployment of this product, in addition to following the general deployment process outlined in a separate document, please pay special attention to the aspects mentioned below.

Scope and Limitations

• Country: only USA

• Market: All

• Payment gateways: only supports TSYS

• Auth mode: Single Auth

• Payment Types: only supports credit/debit cards

• Reader Work Mode: Retail

• Minimum Terminal Version Requirement: Ultra VX Series [1300.847.017.008]; Ultra LX [1200.839.010.001]

Define Settings on Market Server

When configuring Settings options on the Vendor Portal, please make sure the section “Credentials for New Development (Automation) (Payroc)” in General Settings has been well configured so that this feature can be supported.

Create/Edit Location

Please make sure the Credit/Debit Card is supported by the location.

Creating CCM Profile

When creating/editing the Universal Pulse / Universal Continental Girbau Max / Ultra Data profiles for readers supporting the Automated VAR feature, you can leave the default values of POS ID, Auth Code and Auth Factor to 0. The system will automatically request the credentials from Payroc when setting up this reader using KLM, thus eliminating the manual input efforts.

Reader Setup using KLM

Please follow the steps below to set up the reader. The key injection procedure will be implemented together with the setup for a new reader.

During this process, the reader’s UIs will present as follows:

Manage Credentials Remotely in KioCentral Room View

The payment gateway credentials are automatically updated in the Room View and are updated on a real-time basis.

Navigate to Location Management > View Location > Room > View to open the room view.

Roles that have access to features in Room View include Laundry/Amusement/Integration Vendor Admin, Laundry/Amusement/Integration Staff, Laundry Portal Role, Integration Portal Staff, KioSoft Express Laundry/Amusement User, and Laundry Technician. Roles that do not have the Room Management permission won’t be able to access this section.

At the bottom of each machine information card, you can find a section called Reader Credentials. This feature is designed to automate the process of generating and assigning payment processing credentials to each terminal, eliminating the need for manual input. But it does not apply to kiosks. Below are descriptions of the fields and feature buttons in this section.

• Status (Active / Inactive / Activation in Progress / Null / Error / Pre-auth / Demo):

Active: Indicates that payment credentials have been successfully returned from Tsys and the terminal is activated.

Inactive: Signals that the terminal is not activated, with a prompt on the reader’s idle screen indicating activation failure. When credentials are obtained but the reader is not activated, the system will automatically attempt activation one more time.

Activation in Progress: Represents the status when a request for credentials has been sent but not yet returned.

Null: Appears if the credentials have been deleted by clicking the Edit > Delete > Save button.

Error: Will display when it fails to get the reader credentials. When it fails to get callback data from the payment gateway provider, the system will automatically attempt to get them one more time.

Pre-auth: The auth mode of the machine is set to Pre-auth mode.

Demo: Indicates that the machine is in demo mode

• Provider (Tsys): Specifies the payment gateway provider. Currently Tsys is supported.

• POS ID & Auth Code & Auth Factor: These are payment processing credentials. They can be auto-generated using the Request New Credentials button, manually edited with the Edit Credentials button, or uploaded from manually defined CCM profiles.

• Request New Credentials: This button can be used to call the Payroc-Tsys API to get new credentials. The credentials will be updated in about 2-3 minutes and the reader will be activated immediately after credentials are received. This only works with payroc tsys. This button is hidden for all the other providers.

• Edit Credentials button allows you to manually modify credentials for operational flexibility. Like the Request button, it is available only when all specified conditions are met. During editing, you need to click the save button to apply changes and/or exit editing mode. Immediately, the credentials will be updated and the reader will be activated.

• Delete button appears after clicking the Edit Credentials button. Clicking it will clear all credentials and disable credit/debit card transactions when confirmed, and the reader will become inactive immediately.

For machines where Credit/Debit card functionality is enabled at the location level but not in its CCM profile, the status will display as Inactive. If a user clicks the Request New Credentials button or the Edit button, we interpret this action as intending to enable Credit/Debit card payment and will execute the command to activate the payment gateway.

The UI for a failed Automated VAR is as follows:

FAQ