![Logo|250](Pasted%20image%2020240227162405.png)

## Overview 

[Heartland Payments](https://www.heartland.us/?utm_campaign=23Q1_RG-Mktg_GB_HPY_PD_BRANDED-G-SEARCH&gad_source=1&gclid=CjwKCAiAloavBhBOEiwAbtAJO010iubrj2rXBqWGSp0raFKdIPuYrjxk1VIJRRnmSeO90VARj6kVnBoClk4QAvD_BwE) is committed to being the complete technology solution for growing small businesses. Heartland Payments is a payment processor who support processing credit card payments. They have two gateway entities, Heartland Payments Secure Submit and Heartland Payments Bolleta. Each one has its own set up process with ChargeOver. 

## Connect Secure Submit

Steps to connect Heartland Secure Submit and ChargeOver together are below!

### In Heartland Payment Systems

To connect your Heartland Payment Systems Secure Submit account to ChargeOver, you'll need to find the **Heartland Secret Key** from your Heartland Payments Systems account.

Once you have the **Heartland Secret Key**, you can go back to ChargeOver to get the two connected.

### In ChargeOver

1. Go to your **Settings** and select ==Payment Processing==
2. Click the ==Add or Configure a Payment Method or Merchant Account== button
3. Find **Heartland Payment Systems (Secure Submit) Settings**
4. Enter in the **Heartland Secret Key**

![](./bdaab40d-c70c-4778-9589-bbdaffbfdeb8-nyu.png)

## Connect Bolleta

Steps to connect Heartland Bolleta and ChargeOver together are below!

### In Heartland Payment Systems

Obtain the following credentials:

- API Username
- API Password
- Merchant Name
- Application ID

Once you have these, you can go back to ChargeOver to get the two connected.

### In ChargeOver

1. Go to your **Settings** and select ==Payment Processing==
2. Click the ==Add or Configure a Payment Method or Merchant Account== button
3. Choose **Heartland Payment Systems (Bolletta)** from the choices
4. Enter in the required information

![](./6ec51a18-7619-447c-bfd7-2a7a40911394-4wo.png)

## Common questions

Does the integration between Heartland Payments and ChargeOver support…

|Feature|Supported? ✅|
|---|---|
|[Dynamic Statement Descriptors](https://help.chargeover.com/docs/getting-paid/payment-processors/stripe/#dynamic-statement-descriptors)|✖️|
|[Tokenized Payments](https://help.chargeover.com/docs/getting-paid/payment-processors/#enable-tokenization) | ✖️ |
|Credit Card Payments|✅ |
|ACH (USA Only) Payments|✖️ |
|EFT (CAD Only) Payments|✖️|
|ACH (AUS Only) Payments|✖️|
|Credit Card Refunds|✅ |
|ACH Refunds|✖️ |

#### Can Heartland Payments send multiple ACH or EFT payments into a single settlement batch?

✖️ No. 

#### Can Heartland Payments report ACH payment status' to ChargeOver?

✖️ No. 

#### Does Heartland Payments support same-day refunds for credit cards?

✅ Yes!

## Common decline messages

If you are unsure what a Heartland Payments decline message means or what to do next, the most common error messages you might encounter are explained below.

| Error message   | What Heartland Payments is trying to tell you                                                              | Next steps                                                                                     |
| --------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| ERR_DECLINE     | Heartland Payments told ChargeOver the payment was declined.                                               | You or the customer should contact Heartland Payments to discuss the reason for the decline.   |
| ERR_CREDENTIALS | Heartland Payments told ChargeOver that your authentication credentials for Forte are incorrect.           | You should contact Heartland Payments and fix the credentials you use to connect to them.      |
| ERR_EXPIRED     | Heartland Payments told ChargeOver the credit card has expired.                                            | You should contact the customer and ask them to provide a new payment method.                  |
| ERR_CVV         | Heartland Payments told ChargeOver the credit card was declined due to an incorrect CVV/CVC security code. | Your customer should provide a correct CVV/CVC security code, or provide a new payment method. |

## Heartland Payments support

If you need to contact Heartland Payments's support team, you can use the information below.

**[Support Website](https://www.heartland.us/resources/customer-support)**

**Support Form - Can be found at the bottom of the support website

**Phone Number - 800-285-0005**