Partial Approval Testing

Note: The following setting is required for Swipe or Hand-Key transactions processed through the USAePay gateway:
easyIntegrator1.ConfigFields.AllowPartialApprovals = True

To support Partial Approval and Split Payments, ensure the following system requirements are met:

Operating System

• Windows 10 Fall Creators Update (Version 1709) or later
• Windows Server, Version 1709 or later

.NET Framework

• Version 4.8 or later
• How to determine installed .NET Framework versions

EI Server

• Latest version installed

Device Compatibility

• Clover Flex
• PAX: Version v1.04.08E or later

General Notes

• EI Server Compatibility: Requires EI Server version 5.3.4.2 or later.
• RDP Use: If a merchant is using Remote Desktop Protocol (RDP), the host server must be on the same network as client workstations. USB connections and COM port forwarding are not supported with the Clover Flex. Only Windows Server 2016 and Windows Server 2019 are supported.
• Device Pairing: Devices should be dedicated to individual workstations. Each workstation processing transactions with Clover Flex must have its own paired device.
• Network Support:
  • WiFi: Supported natively.
  • Ethernet: Requires a separate adapter for hard-wired connections if desired.
• Device Updates: Clover manages all OS and app updates. We have no control over the timing of these updates, as the device typically checks for updates at least once every 24 hours.

Tipping: Currently, Tip-on-Terminal is the only supported tipping method. Future EI Server releases will support tip adjustments post-transaction.

Box Contents

• Charging base
• Power adapter
• Screwdriver (for attaching Ethernet adapter and other accessories, sold separately)
• Receipt paper
• Quick start guide

General Notes

• EI Server Compatibility: Requires EI Server version 5.3.26.6 or newer.
• RDP Cable: The PAX A35 includes its own RDP cable and does not require a separate RDP kit.
• Network Connectivity:
  • Supports both Ethernet and WiFi connections.
  • Note: Network configuration details are not preloaded in the build from the PAX Store.
• Device Access: The password for accessing the settings app on the device is pax9876@@.

Box Contents

• A35 Terminal
• Dongle with Ethernet and RDP USB attachment
• USB-C to USB power cable
• Power adapter (USB to power outlet)

1. Ensure the dongle is connected to the PAX A35. (This should already be done during deployment.)
2. Connect the USB-C power cable to the USB-C port on the dongle to power on the device.
   • Note: The A35 does not have a power button, similar to the S300 model.
3. The A35 should power up automatically and display the home screen with a list of apps.

Upon receiving the PAX A35, you may see the Omaha BroadPOS app screen, which might open by default. You must exit this screen to access and configure the network settings.

Note: Tapping the triangle icon will not exit the app.

To exit the Omaha BroadPOS app:

1. Tap the icon located in the top-right corner of the screen.
2. Enter the password, which is the last 4 digits of the device serial number.

    

3. Scroll down and tap EXIT.
4. Re-enter the password when prompted.

Note: The top-right icon may be finicky and may require multiple taps to respond.

1. Set the device to use a static IP by tapping on the Settings app.
2. Enter the password pax9876@@, then press the green circle key at the bottom right.
   • Alternate Password: 9876
3. Select Ethernet or WiFi, depending on the device’s internet connection.

1. The screen should display the network settings obtained when the device powered on.
2. Troubleshooting: If the network information is blank or displays only zeros, reboot the device and verify all cables are properly connected. Ensure the Ethernet cable is plugged into the red Ethernet jack on the PAX A35 cable.
3. Scroll down to locate Ethernet Configuration. Tap on it to change the connection type to Static. A static IP address is required, as this will be used later for EI Server configuration.
4. IP Selection: Choose an IP address that is not already assigned to another device and is outside the DHCP pool range to prevent conflicts. Note the IP address for later use in EI Server setup.
5. Configure the network information as needed. This replaces network settings that would normally be set up in Broad POS. Use the down arrow at the bottom of the screen to close the keyboard.
6. Once all settings are complete, tap Save in the bottom-right corner.
7. After saving, you will be returned to the Ethernet/WiFi page where the updated network information should now be visible.

1. Tap on the currently connected network to open its settings menu.
2. Tap the pencil icon in the top-right corner to access network settings.
3. Select Advanced Options.
4. Scroll down to IP Settings.
5. IP Selection: Choose a high-range IP address that is not in use by another device, just as you would with any other networked device. Note this IP address for later use in EI Server setup.
6. Change the IP setting from DHCP to Static.
7. Update network information as needed. Confirm that you have selected a high-range IP address not currently in use. Record this IP address, as it will be required for EI Server configuration.
8. Tap Save to apply your settings.

4. Once the network information is configured, tap the circle at the bottom of the screen to return to the main menu, similar to any Android device.

1. Open the PAXSTORE app to confirm that it launches and connects properly.
2. If you encounter any errors, the device may not be connected to the internet.
   • Check the internet connection and, if necessary, repeat Step 3 to review the PAX A35 network settings

1. Open the Omaha PAX BroadPOS app and confirm that it initializes. The Gravity logo should display once the app is open.
   Note: The Omaha app can function if left open or in the background. However, it’s highly recommended to leave the app open, as the device is primarily used for credit card transactions. Leaving it open reduces the chance of the app not opening automatically when a transaction is prompted.
2. Once initialized, the device is ready for use.

    

Note: Ensure EI Server is updated to version 5.3.26.6 or later. Download the latest version here: Gravity Payments Developer Downloads.

1. Processor Configuration
   • Click on Processor.
   • Select ChargeItPro.net.
   • Enable Test Mode and select Staging.
   • Enter the password: chargeitPro1.
   • Input your Sandbox Source Key and PIN.
     • If you do not have this information, contact Developer Support at developersupport@gravitypayments.com.
2. EmergePay Configuration (Optional):
   • If using EmergePay, enter your AuthToken and OID.
   • Select Use EmergePay for Manual Transactions.
3. Finalize Setup:
   • Click GET.
   • Click REGISTER.
   • Enable Verify Install On Save.
   • Click SAVE to complete the configuration.

1. Device Configuration

• Click on Devices.
• Select PAX MT30-S.
• Enable Activate Device.
• Enable Allow Manual Entry.
• Set Comm Type to TCP.
• Enter the IP Address from Step 3.
• Set Actions to Test.
• Click Start.

Finalize Device Settings:

• Enable Verify Install On Save.
• Click Save to complete the configuration.

IMPORTANT: Ensure the PAX A35 is in Demo Mode before proceeding.

1. Open the BroadPOS app on the device.

2. If the device is not in Demo Mode, stop here and contact Developer Support before continuing:

• developersupport@gravitypayments.com

3. If your device is in Demo Mode, proceed with running a test transaction.

USAePay Test Card Numbers:
Use the test card numbers provided here for the transaction: USAePay Test Cards & Error Responses

1. Run a transaction and compare the following values to verify partial approval:
   • AmountTotal Requested: easyIntegrator.transFields.AmountTotal
   • AmountProcessed Approved: easyIntegrator.ResultsFields.AmountProcessed
   • If AmountProcessed is less than AmountTotal, the transaction was partially approved.

PAX Devices

Note: Ensure the PAX device is in Demo Mode.

2. Use any test card number that returns an approval with one of the following amounts to trigger a partial approval response on PAX terminals:
   • $30.01: Results in a partial approval for $10.00.
   • $30.02: Results in a partial approval for $5.00.
     

Example:

• A transaction for $30.01 will display a partial approval for $10.

  

• Similarly, a transaction for $30.02 will display a partial approval for $5.

1. Once testing is complete, contact Developer Support to schedule a review:
   • developersupport@gravitypayments.com

Note: No actions are required in the PAX Store when connecting a device. All necessary updates and configurations have been completed by the Deployment team prior to shipping. If an app or firmware update is needed, please contact support for assistance. For detailed instructions, refer to: How To: PAXStore – Add and Activate an Integrated PAX Device for EI Server.

For any additional questions, reach out to Developer Support:

• developersupport@gravitypayments.com

General Notes

• Upon receiving the Clover Dev Kit, a member of the IP team will assist in pairing the device with the Clover Sandbox and adding it to the Gravity Dashboard Sandbox for testing.
• To initiate this setup, send an email to developersupport@gravitypayments.com with the following information:
  • Sandbox OID where the Clover should be registered.
  • Device Serial Number (located on a sticker under the receipt paper roll).
    • Note: Do not send the serial number from the charging base; only provide the actual device serial number.
• Alternatively, you can provide this information via Slack if a channel has been set up with Developer Support.

Box Contents

• Charging base
• Power adapter
• Screwdriver (for attaching Ethernet adapter and additional accessories, sold separately)
• Receipt paper
• Quick start guide

Step 1: Power on the Clover Flex Terminal

• WiFi: Connect the device to the appropriate WiFi network.

1. Once the network configuration is complete, contact your IP Specialist via:
   • developersupport@gravitypayments.com
   • OR your dedicated Slack channel (if one has been set up).
2. The IP Specialist will provide you with the activation code once the Clover device is added to the sandbox accounts.

1. Swipe to the second page of apps to confirm that the Signature app and CloudPay Display app are installed.
2. If these apps are missing:
   • Tap the More Tools icon to access the App Market and search for these apps to download.
   • OR notify your IP Specialist, who can assist in pushing the apps to the device.

Note: If prompted for a passcode, try 1234 for a 4-digit code or 123456 for a 6-digit code.

1. For a straightforward test, use the Modal Sale setup to complete a transaction.
   • Alternatively, you can use the HostedFields device control, though Modal Sale is recommended for a better user experience.
2. Follow the test transaction steps, including sample JSON (provide these details as needed).

1. Use the provided Clover test cards to validate partial approvals.

   • Clover Test Cards for Partial Approvals

After completing all tests, contact Developer Support to schedule a review:

• developersupport@gravitypayments.com