Configure USAePay in Cashiering

Overview

Complete these 5 key steps in the suggested order to fully configure USAePay. You will need to be logged into both Cashiering and USAePay during this process so you can go back and forth between the two systems. Login details for USAePay are provided by Persolvent when the account is created.

• Step 1: Create the USAePay credit card processor in Cashiering
• Step 2: Create a Fee Schedule
• Step 3: Create the USAePay tender type(s) in Cashiering
• Step 4: Pair the EMV device(s) to USAePay
• Step 5: Add the EMV device(s) to Cashiering
• Step 6: Set up the hardware console in Cashiering

Step 1: Create the USAePay credit card processor in Cashiering

You will need to have USAePay and Cashiering open at the same time to complete this step.

1. Go to the Credit Card Processors page in Cashiering
2. Click the + button to add a new processor
3. Name = USAePay
4. Type = select USAePay from the dropdown
5. Payment Engine Endpoint URL = https://usaepay.com/api/v2/
6. Payment Form URL = you will find this in USAePay (see below)
   If this field is not on your screen, you need to run the Cashiering 2024.1 Release
7. Query Limit = 10
8. API Key = you will find this in USAePay (see below)
9. API Pin = you will find this in USAePay (see below)
10. Click Save

Where to find information in USAePay.

• Payment Form URL: Go to Settings > Payment Forms > Cashiering Form. Click to view details. Use the Form Link at the top of the page.
• API Key and API Pin: Go to Settings > API Keys > Tyler Cashiering. Click to view details. Use data from the API Key and PIN fields, respectively.

Important! When selecting items to copy in USAePay, make sure there are no leading or trailing spaces. Spaces will impact functionality.

Step 2: Create a Fee Schedule (service fee pricing only)

If your pricing model charges your customer a service fee to cover the cost of the transaction, you must set up the service fee in Cashiering. This ensures the fee is included in the transaction total before your customer's payment is processed. If you are paying processing fees, skip ahead to Step 3. 

1. Go to Administration > Fee Schedules in Cashiering
2. Add or Edit a fee schedule named Serv Fee (Ext)
3. Configure the settings
4. Collected externally is off
5. Include all steps is on
6. Click + Add Step
7. Method = Percentage
8. Value = enter the service fee rate (example - use 0.0299 if you charge a 2.99% service fee)
9. Click Save

Step 3: Create the USAePay tender type(s) in Cashiering

There are two tender options for USAePay: an EMV device and manually keyed payments. You can enable both tenders to maximize options for your cashiers, but you do not have to enable both. If there is a method you aren't going to use, you do not need to add the Tender type.

Create a card present Tender type for your EMV device. 

1. Go to Administration > Tender Types in Cashiering
2. Create a new Tender type
3. Name = USAePay
4. Description = USAePay
5. Make sure the Active is on
6. Fee Schedule = If using a service fee, select Serv Fee (Ext). Otherwise, leave blank.
7. Click Save 
8. Go to the Advanced tab
9. Open cash drawer toggle is off
10. Allow debit PIN is off
11. Card not present is off
12. Real-time authorization is on
13. Processor = USAePay
14. Customize any other settings on the page
15. Click Save
16. Go to the Access tab
17. If your new tender type defaulted to no users, you need to add all users here to allow the new USAePay tender option
18. Click Save

Create a card not present Tender type for manually keyed payments. 

1. Go to Administration > Tender Types in Cashiering
2. Create a new Tender type
3. Name = USAePay CNP
4. Description = USAePay
5. Make sure the Active is on
6. Fee Schedule = If using a service fee, select Serv Fee (Ext). Otherwise, leave blank.
7. Click Save 
8. Go to the Advanced tab
9. Open cash drawer toggle is off
10. Allow debit PIN is off
11. Card not present is on
12. Real-time authorization is on
13. Processor = USAePay
14. Customize any other settings on the page
15. Click Save
16. Go to the Access tab
17. If your new tender type defaulted to no users, you need to add all users here to allow the new USAePay tender option
18. Click Save

Step 4: Pair the EMV device(s) in USAePay (card present only)

1. Turn on the device and wait for it to boot up
2. For Ethernet: Simply connect the Ethernet cable. No other configuration is needed.
   For WIFI: Hold down the 9-key on the device until it beeps twice, select your WIFI network, enter the WIFI password (Note: Your network must be secured with a password for this device. An open guest WIFI network with no password will not work.)
3. When ready, the device will prompt for a pairing code
4. Log into USAePay
5. Go to Settings in the left menu bar and expand your options
6. Click Device Manager
7. Click + to add a device
8. Device Name = type in Device 1
9. Search for Source Key = select Tyler Cashiering
10. Terminal Type = select Standalone
11. Click Register
12. Click Done
13. USAePay will display the 6-digit pairing code you need to enter on the device
14. Once properly paired, you will see a welcome screen on the device and USAePay will display the device key and serial number
15. Click Device 1 to view details
16. Check the box next to Update Notifications
17. Click Save
18. If you have more than 1 device, repeat this process until all devices have been added.

Once a device is configured, holding down the 9-key until it beeps twice brings up the Main Menu. This is where you can configure and customize settings such as changing the connection method, changing WIFI networks, turn off keyboard sounds, and unpair the device.

Step 5: Add the EMV device(s) to Cashiering (card present only)

1. Go to Credit Card Processors in Cashiering
2. Locate USAePay and click the 3 vertical ellipsis icon on the right
3. Select Devices
4. On the Credit Card Device window, click the + button to add
5. Device Name = Device 1 (or the device name you created in USAePay)
6. Go back into USAePay > Device Manager
7. Click on Device 1 in USAePay to view details
8. Copy the Device Key making sure there are no spaces on the front or the end 
9. Hardware Serial Number = paste the Device Key from USAePay
10. Click Save
11. If you have more than 1 device, repeat this process until all devices have been added.

Step 6: Set up the hardware console in Cashiering (card present only)

1. Go to the nine-box in the upper right corner of Cashiering
2. Select Hardware Console 
3. The page that opens lists your active devices
4. Click the Maintain icon in the lower right corner to add a device
5. Go to Credit Card Reader and select EMV Capable Device from the dropdown 
6. Go to HSN and select a device from the dropdown
7. Click Save
8. If you have more than 1 device, repeat this process until all devices have been added.