Shift4 UTG

NetSuite’s integration with the Shift4 UTG (Universal Transaction Gateway) payment gateway provides EMV and other functionally for your NSPOS setup. To begin your setup with Shift4, visit their site at www.shift4.com. Then review and follow the sections in this topic.

Setting Up Shift4 UTG

Follow the steps in this topic to set up Shift4 UTG.

Important:

Before starting, you must have the following ready for each RA-Workstation on which you want to configure and use the Shift4 gateway.

Terminal ID: This is the serial number found on the register credit card PIN pad or swipe device. It is usually an 8–digit number. On many devices, this ID displays during the initial power-up.

URL: This is the URL/ IP address of the server running UTG.

Client GUID: (NSPOS 2018.2.X & 2019.1.X only) Contact NetSuite Customer Support and request the Client GUID value to enter in the steps below. This value will be the same for all RA-Workstation records.

The GUID is set up automatically for NSPOS 2020.1.X and later. No action is needed.

Authentication Token: Each RA-Workstation record requires a unique Authentication Token. This can be obtained from the Shift4 Portal. Shift4 will provide you with the information needed to access their portal, and they are available to help you with this process.

The following steps require an update to each RA-Workstation record for which you want to configure and use the Shift4 UTG gateway.

To set up Shift4 UTG:

  1. Log in to NetSuite as an administrator.

  2. Go to Customization > Lists, Records, & Fields > Record Types.

  3. Locate the RA-Workstation row and click List.

  4. Click Edit for the first workstation to update.

  5. For Payment Provider, select Shift4.

  6. In the Shift4 section, complete the following fields:

  7. C:

    • Use New UTG(NSPOS 2018.2.X & 2019.1.X only) – Check this box to show you are using Shift4 controlled devices.

      Box does not exist for NSPOS 2020.1.X and later. No action is needed.

    • Terminal ID – Enter the serial number found on the register credit card PIN pad or swipe device. It is usually an 8–digit number.

    • URL – Enter the URL/ IP address of the server running UTG.

    • Client GUID (NSPOS 2018.2.X & 2019.1.X only) – Enter the value provided by NetSuite Customer Support. This value will be the same for all RA-Workstation records.

      The GUID is set up automatically for NSPOS 2020.1.X and later. No action is needed.

    • Authentication Token – Enter the token value generated from the Shift 4 portal. Each token must be unique to each RA-Workstation record.

  8. Click Save.

  9. Repeat for the next workstation.

For NSPOS 2018.2.X and 2019.1.X:

Payment provider info fields for Shift4 UTG controlled devices.

For NSPOS 2020.1.X and later:

Shift4 setup for NSPO 2020.1.X
Important:

After configuring your RA-Workstation records, verify that your Tender in NSPOS is configured to use EMV. If you are not certain how to do this, please contact NetSuite Professional Services.

Important:

During register staging, if using an Ingenico device with Shift4, you must also select to install the Ingenico extension. See Get the NSPOS 2018.2.X or 2019.1.X Download and Begin.

Note:

Before your cashiers can user Shift4 at the workstation, the set up must first perform a synchronization download from NetSuite. This takes approximately 15 minutes.

Shift4 and EMV Receipt Requirements

Warning:

NetSuite Professional Services must update your receipts to match EMV requirements.

Shift4’s EMV standards include requirements for the information printed on merchant and customer receipts. EMV requirements can vary across payment processors, but in most instances receipts must include:

End of Day Report for Shift4 UTG

NSPOS includes a report for verifying transaction amounts processed on registers through the payment gateway over a period of time. Called the End of Day report, it is designed to closely match the end of day report available from Shift4. Use this report to compare the results from similar reports provided by your gateway.

Administrators may want to configure this report function as a button for easy access by your store managers. The function is called End-of-Day Report and is available from every register. Be sure to include any access restrictions that you believe are appropriate.

To run an End of Day Report:

  1. In Sales Mode, complete all sales transactions.

  2. From the Main button bar, tap Manager Functions and/or tap Reports.

  3. Tap End of Day. The report displays.

  4. To adjust criteria, choose from the fields at the top and tap View Report.

  5. To print or save and export the report, choose from the options at the top.

  6. Tap X in the upper right to return to the Journal window.

Line Item display for Shift4 UTG PIN Pads

You can display items as they are processed for a sales transaction on Shift4 UTG PIN pads. This option is disabled by default. Enabling Shift4 line item display on one register will populate registers across your network during the next synchronization cycle.

Important:

Performance issues from Shift4 UTG may impact the item-display refresh rate. This can cause a lag between a physical scan and the item appearing on the PIN pad. The issue is being worked by Shift4, and affects the PIN pad item display only.

To enable Shift4 Line Item Display:

  1. Log in to any NSPOS register as an administrator.

  2. Go to Universal Settings (Ctrl+F10).

  3. Search for Shift4.

  4. Enter the desired values using the table below as a guide.

  5. Tap Done.

Setting

Description

Value

Default Value

Response timeout

Time POS waits for a response from UTG.

Milliseconds

120000

UTG PIN pad refresh interval

Interval to prevent PIN pad from moving to idle state due to no Journal changes.

This prevents the display from going idle while a transaction is delayed, but in progress.

Milliseconds

Set to 0 to disable this feature. If items are scanned at the POS more than one time every 10 seconds, this setting is not needed.

10000

UTG PIN pad update changes interval

Periodically check for Journal changes and update on PIN pad display.

Changes include items added and quantities updated. No update if no changes.

Milliseconds

Set to 0 to disable this feature. If disabled, the PIN pad display will update with each new scan.

1000

UTG PinPad Line Item width

Line width supported by PIN pad. Refer to PIN pad documentation.

Number of characters

30

UTG PinPad max lines

Maximum number of line items supported by PIN pad, including last line with tax and total amount.

If set to a number greater than supported by your PIN pad, the display may not work as intended. Refer to your PIN pad documentation for the maximum lines allowed.

Number of lines

10

UTG PinPad line item display enabled

Enable PIN pad to display line items.

Check to enable, clear to disable

Cleared

Shift4 Universal Settings form.

Credit or Debit Card default setting for Shift4 UTG PIN pads

You can set the default card type accepted at your Shift4 UTG PIN pad – credit, debit or both. The default is both (blank), with the PIN pad prompting the customer to select the card type. Setting the default card type on one register will populate registers across your network during the next synchronization cycle.

To set the default card type:

  1. Log in to any NSPOS register as an administrator.

  2. Go to Universal Settings (Ctrl+F10).

  3. Search for Shift4.

  4. Enter the Default card type.

  5. Tap Done.

Setting

Description

Value

Default Value

Default card type

Default card type for all transactions.

If card type is not specified, PIN pad prompts user to select Debit or Credit.

If card type is specified, PIN pad will not prompt user to select. Instead the default is assumed.

CC – All cards are credit cards

DB – All cards are debit cards

(blank) – PIN Pad prompts user to select Debit or Credit

Note:

  • If CC selected as default, PIN pad can accept debit cards as credit.

  • If DB selected as default, only debit cards can be used.

(blank) – No value entered

Related Topics

Payment Gateways
Worldpay (Vantiv) [Mercury Payment Systems]
FreedomPay
Worldpay (YESpay)
Linkly (PC-EFTPOS)

General Notices