Technical Note: 20070424004

Tender Retail EFT Setup (Canada)

(Maitre'D 2005, from Service Pack 4 Hot Fix 6 and later versions of Maitre'D)

Overview

Maitre'D supports the Tender Retail interface with the Toronto-Dominion (TD) Bank for the Canadian market. This protocol allows Debits and Credit Cards transactions.

Note: NCR handles the Credit Cards, but all communications are done through TD Bank.

What is needed

From Posera:

From Tender Retail:

Note: Make sure to get from Tender Retail the latest version certified for Maitre'D. At the time of writing, the version was 3.3.1.13. It must be installed on the main Back-Office server as well as on any workstation that has a debit PIN Pad attached to it.
Contact:
Tender Retail support: (416) 498-1200 x0

From TD Bank:

Contacts:
TD Bank Debit Card support: (888) 983-8373
NCR Credit Cards support: Yvon Langevin, (450) 974-6080

Requirements

Merchant Connect Multi Installation

  1. Install Merchant Connect Multi
  2. After the installation, you must copy the following files:
    client.pem, random.pem and root.pem
    from folder: \\merchant connect multi\SSL certificates
    to folder: \\merchant connect multi\CDCA

Merchant Connect Multi Configuration

The first time you start the Merchant Connect Multi application, the Configuration screen will be empty. You will need to configure:

  1. a CREDIT on the main Back-Office server.

  2. a DEBIT on each of the workstations that will have a PIN Pad attached to it.
    (Merchant Connect Multi must be installed on the main server and on each workstation that will have a PIN Pad attached to it)

Credit Configuration

Configuration / Add new file

Host:

NCR (Credit Only)

Diagnostic:

Enabled

Authorization Terminal:

As received from TD Bank (12 digits starting with 4664 including Terminal ID (normally 0001))

Note: You will receive only 1 number for credit

Line type:

TCP/IP

Protocol:

OpenSSL

IP Address:

As received from TD Bank

Port Number:

As received from TD Bank

Client Terminal ID (1-99):

any number

Description:

NCR Credit

Configuration / NCR Credit / Card Types

On this page, enable the accepted credit card types.

Configuration / NCR Credit / Printer/Header

Receipt Format:

Standard

Create Receipt:

Standard

Card Number Mask:

Master Card

Print tip row:

Enabled

Once your configuration is finished:
File / Save As
Enter a unique name (example NCR Credit)
Save / File (again) / Exit

Debit Configuration

Configuration / Add new file

Host:

TD (Ingenico PINSmart)

Diagnostic:

Enabled

Authorization Terminal:

As received from TD Bank (12 characters starting with a capital I)

Note: You will receive 1 number for each PIN Pad.

Line type:

TCP/IP

Protocol:

SSL

IP Address:

As received from TD Bank

Port Number:

As received from TD Bank

Client Terminal ID (1-99):

any number

Description:

PIN Pad Ws03

Configuration / TD (Ingenico PINSmart) / Devices

Connection:

COM port

PIN Pad Port:

Serial com on which PIN Pad is connected

Baud Rate:

9600

Parity:

Even

Data Bits:

7

Stop Bits:

1

Prompt for Tip:

Debit Card Only

Prompt for CashBack:

None (not supported)

Timeouts:

Do NOT modify the presets.

Configuration / TD (Ingenico PINSmart) / Card Types

On this page, only enable the Debit (Bank Card) option.

Configuration / TD (Ingenico PINSmart) / Printer/Header

Receipt Format:

Standard

Create Receipt:

Standard

Print Tip row:

Disabled

Once your configuration is finished:
File / Save As
Enter a unique name (example Debit Ws03)
Save / File (again) / Exit

System / Start Server

Click on the START button to start the server.

It will have to be manually started every time you reboot the computer.

Server Type:

IP Server

Output Directory:

Folder where the Merchant Connect Multi has been installed

Log File Directory:

Folder where the Merchant Connect Multi has been installed

PIN Pad:

0 (always)

Delay:

100

Diagnostic:

Enabled

IP Port:

5000 (this port has to be open and available)

Number of Connections:

10

Do Positive ACK:

Enabled

Sec:

2

Do Not Linger After Disconnecting:

Enabled

Maitre'D Setup

Electronic Funds Transfer / View / Options / Interface

Interface:

Tender Retail

Protocol:

Tender Retail

Port:

Port number through which you can access the remote Tender Retail server.

Note: This is the same IP Port programmed in Credit/Debit Server /System / Start Server screen of Merchant Connect Multi application.

IP Address:

Address of the local computer where the Merchant Connect Multi application is installed.

Note: Do not use the 127.0.0.1 local host loop back address, even if on same computer as Maitre'D. Use the exact address, such as 192.168.100.1

Electronic Funds Transfer / View / Options / Identification

Merchant Number:

Enter merchant ID supplied by TD Bank.

Note: This is the same Authorization Terminal ID programmed for Credit Cards in Merchant Connect Multi, as received from TD Bank (12 digits starting with 4664 including Terminal ID (normally 0001)) You will receive only 1 number for credit

Use Pre-Authorization:

Enabled for restaurants, disabled for retail.

Electronic Funds Transfer / View / Options / Operation

POS refresh:

Minimum 5.

Close Debit Batch:

Enable this option to close the debit batch when closing the credit card batch.

Note: Remaining information is as per your client's desired configuration and local authorities.

Electronic Funds Transfer / Transaction

Note: The other 2 functions are disabled, as Tender Retail does not support these operations.

Electronic Funds Transfer / Report / Current Batch

Current Batch:

This is the only report available from Maitre'D.

Above is a sample of a Current Batch Report

Note: This report can only be printed BEFORE closing the batch.

Credit Cards

Above is a sample of a credit card transaction record.

P.O.S. Control / Payments / Media Type

Each credit card media type that is managed by the EFT interface must be defined.

Payment type:

Charge

Payment surplus:

Tip Entry, as credit card companies do not allow cash advances.

P.O.S. Control / Payments / Media Type / Option

Folio:

Enabled.

Included in Report:

If you enable this option, the transactions closed with this payment type will be included in the Credit Card report. Otherwise, they will only be included in the Summary of Payments report.

P.O.S. Control / Payments / Card Property

EFT Category:

Select the credit card type.

Electronic Fund Transfer:

Enabled

Hide card number:

This option can not be disabled with CISP compliant protocols. It masks some digits of the credit card number on the EFT voucher.

Show on Merchant Copy:

This option can not be enabled with CISP compliant protocols.

Validation:

If you enable this option, the Back-Office verifies if the credit card number entered agrees with certain digits that are always present in credit card account numbers. If you disable this option, the Back-Office does not validate the credit card number. You can override this option from the workstation by entering a minus sign after the card number.

Expiration:

Enabled. The expiration date of a credit card has to be entered in the format MM / YY.

Debit Card:

Disabled

Custom Card:

Disabled

Expiration:

Enabled

Number of digits:

Some credit card companies have credit card numbers that may vary in their total number of digits. For example, Visa cards may have either 13 or 16-digit numbers, whereas other cards have a set number of digits, for example, Master Card cards that have 16 digits and American Express cards that have 15. Two fields should be filled in order to validate the credit card number's length. Type the credit card's appropriate number of digits in the first field then type 0 in the second field to specify that this is a fixed number of digits (zero is the default for the second field). Conversely, you will need to enter a number of digits in each field for cards, such as Visa, that have two possible card number lengths. Type in 0 in both fields for credit card numbers with varying lengths, which will remove the need to validate the number of digits.

Starting With:

Type in the first digits of the credit card. Some credit card numbers always begin with the same digits. These digits can be used for validation. For example: For Visa payment type's "Starting with" field, type in 4. For Master Card, type in 5, and for American Express, type in 34 or 37. If both fields are blank, the first digit is not selected.

Debit Card

Above is a sample of a debit card transaction record.

How to process Debit Cards

Ring up a transaction and touch the Close button. When you reach the Payment screen, touch the Debit Card button, and enter the full amount, or simply touch Enter, and follow the instructions on the PIN Pad for the rest of the transaction. Once the transaction is accepted, the workstation will print an approval receipt.
Note: Debit Cards are not supported on CE workstations by Tender Retail.

P.O.S. Control / Payments / Media Type

Payment Type:

Canadian Debit

P.O.S. Control / Payments / Media Type / Option

Folio:

Enabled

P.O.S. Control / Payments / Card Property

This page is left blank, with everything disabled.

P.O.S. Control / Workstation / Options / Devices / PIN Pad

Type:

Serial

Port:

Select the com port where theTD PIN Pad is connected.

Driver:

Canadian Debit

ID:

Enter individual 12 characters TD PIN pad ID received from TD Bank.
Note: This is the same Authorization Terminal ID programmed for Debit Cards in Merchant Connect Multi, with 12 characters starting with a capital I. You will receive 1 number for each PIN Pad.

Setting the Employees

P.O.S. Control / Employees / Configuration / Invoice / Payment

EFT reprint:

Enable this option to allow the employee to print duplicate EFT vouchers.

P.O.S. Control / Employees / Configuration / Media

Enable all Credit Cards and the Debit Card payment types.

P.O.S. Control / Employees / Employee / POS Operation / Option

Modify Check Amount:

Disabled, as Tender Retail does not support Tip Adjustment.
Note: Instead, perform a Void CCA Status followed by another pre-authorization.