NOTE: It is highly recommended that your computer be connected with an ethernet cable to your network. Wireless connections are not reliable for communicating with the PAX devices and could result in sudden connection failures.
This article covers how to verify the setup of your PAX payment terminal device to ensure it's ready to begin processing payments in RepairQ.
Testing the Connection
1. Navigate to the Payment Terminal Device list.
2. Click the "Test" button next to the device you wish to test
3. The first test run will be a connectivity test. Upon successful connection, you will see something like the following:
If when trying to run a test transaction, you receive an error message:
- Make sure the PAX device is not displaying any menu screens. The device may be unresponsive to requests when viewing a menu screen.
- Check to make sure the IP address and port were entered properly.
- Verify the device certificate is installed on your computer properly
- Verify your device has the correct certificate installed
- Ping the device to verify your point of sale can reach it over the local network.
- Verify the device is configured to communicate with RepairQ
- Verify the PAX device has the latest update installed.
4. Upon a successful connection, next we recommend you run a test authorization transaction. This will not charge the card used for the test, but the authorization may show up on credit card statements. Enter the amount you wish to test an authorization for, and then click the "Test" button.
If the test is successful, you will see something like the above in your window. If you configured the device to require a signature, then you will see it on screen as well.
In the event that an error occurred, the error will be displayed on screen. See the following for a list of errors and how to resolve them:
a. "CARD DATA UNDREADABLE" - this could mean that your device is not configured properly for your merchant account. Please contact Bluefin support firstname.lastname@example.org for help configuring your device.
b. "DECLINE: Token ID not found" - this could mean that your device is not configured properly for your merchant account. Double check that you have the right bluefin Account ID and API Key in your integration settings for the location you are testing. If those are correct, please contact Bluefin support email@example.com for help configuring your device.
c. "Invalid Group" - this means that the Merchant Account ID setting on the location settings page is invalid. Double check that the account id matches the location, and make sure you have the right Account ID and API configured in the Bluefin settings.