--- title: "Set Up the Pay Tray App for Heartland" slug: "set-up-the-pay-tray-app-for-heartland" description: "This article will show you how to set up the Pay Tray App for Heartland." updated: 2025-11-06T21:43:58Z published: 2025-11-06T21:43:58Z canonical: "www.civicplus.help/set-up-the-pay-tray-app-for-heartland" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Set Up the Pay Tray App for Heartland This article will show you how to set up the Pay Tray App for Heartland. > [!NOTE] > Important Notes > > - This article uses the PAX S300 as an example. Please [consult with Heartland](/civicplus-help-center/docs/heartland-support) if using a different device. > - In order to test a transaction, you will need to verify with CivicPlus that your payment gateway has been configured in CivicPlus Payments. Once that is complete, you will be able to run a transaction. ## Prerequisites - You must have [downloaded the latest version of the Pay Tray App](/civicplus-help-center/docs/pay-tray-app-downloads). - You must have the [Pay Tray App Installed](/civicplus-help-center/docs/install-the-pay-tray-app). - You must have a Heartland chip-read/pin pad device. The device must be plugged into the power and Ethernet, and already have its system updates performed. For more information on this step, reach out directly to [Heartland technical support](https://developer.heartlandpaymentsystems.com/Support). ## Instructions 1. Navigate to the directory in which you have installed the Pay Tray App > [!WARNING] > **Note**: The default installation path is C:\Program Files (x86)\CivicPlus\CpPay Tray App 2. Search for the application and select **Run as Administrator** ![Run as administrator.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/12831076580631.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A08%3A05Z&se=2026-11-22T14%3A08%3A05Z&sr=b&sp=r&sig=akki6%2BkLPBwoQS5kMnA10Fy5S7cU%2BN0l0oyJrCthvaE%3D) > [!WARNING] > **Note**: You must always run the app as an administrator. If you do not, you will receive the following error when you process transactions:![Transaction Processing Error.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/1500007917501.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A08%3A05Z&se=2026-11-22T14%3A08%3A05Z&sr=b&sp=r&sig=VhtRKxBgInBXr%2BEufej6iYBPuXJvDMDt0i27lg%2B42ow%3D) 3. Find the app in the **Windows tray**, and right-click to select **Settings![Windows tray, settings.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4404779482263.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A08%3A05Z&se=2026-11-22T14%3A08%3A05Z&sr=b&sp=r&sig=s%2BTpMqVaf%2BvWmbOU5Pav31p9GSMlAxLxs0AJ%2FwHZYSI%3D)** 4. Click to expand the **Heartland** section of the configuration dialogue ![Expand heartland.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4404779482519.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A08%3A05Z&se=2026-11-22T14%3A08%3A05Z&sr=b&sp=r&sig=M2P1lVX%2BXPk50HGMRNqQBvqDYzk6YaNAasyhfPa9TWY%3D) > [!WARNING] > **Note**: You will need the IP address and port of the device you are trying to communicate with. 5. Type the port number into the **HeartlandSecureSubmitPort** field ![Port number.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4404779481623.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A08%3A05Z&se=2026-11-22T14%3A08%3A05Z&sr=b&sp=r&sig=6AXErqGCkissFojePPivpSvuSUMkyV98yOGM0421zgw%3D) > [!WARNING] > **Note**: The default port number is **10009**. 6. Find the IP address of the device 1. Go into the **admin settings** of the device 2. Navigate to **Communication** using the arrow keys 3. Enter the password 4. Select **LAN Parameters** using the arrow keys 5. Touch **IP Address** to view the device's IP Address 7. Enter the **IP Address** into the **HeartlandSecureSubmitIpAddress** field ![IP address.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4404779481239.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A08%3A05Z&se=2026-11-22T14%3A08%3A05Z&sr=b&sp=r&sig=%2BVfzIxlI6HJqhhgCVlIXGS6J6vAXi2spBatfUJPCdo0%3D) > [!WARNING] > **Note**: Do not add any preceding zeroes to the IP address. For example, 192.168.001.051 would be entered as 192.168.1.51. 8. Click **Save![Save button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4404772390935.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A08%3A05Z&se=2026-11-22T14%3A08%3A05Z&sr=b&sp=r&sig=us%2FbZZ3B3v9CROnYorDKJiBfdbebUbjUBDoZs%2BpQrYk%3D)** 9. Run a test transaction Internet Protocol.A set of rules for communication over the internet or a local network, such as sending mail, streaming videos, or connecting to a website.