Heartland provides secure electronic payment solutions with a focus on technology-driven services that simplify payment processing, payroll services, and enterprise solutions.

Features

✅ Tokenization Credit Card payment methods can be converted to Heartland payment tokens. ✅ Auto Tokenize Can use features.auto-tokenize to have all corresponding tender types auto converted to tokens. See tokenize for more details.

Resources

Configuration

To use Heartland for credit card payments, you need a secret API key which you can obtain by setting up an account on their portal. Visit their website for more details on getting started and integrating their services into your system.

This table describes the required or possible attributes needed to configure a merchant product for this type.

Name	Type	Description	Rules
secretAPIKey		(required) Secret API key for authenticating requests to the Heartland service. Examples: your-secret-api-key.

Features

All tokenize products support the following features attributes.

Name	Values	Description
auto-tokenize	true or false (default)	Can be provided for one tokenized product per payment method type (tender type). When set, any call to create a payment method for that underlying tender will automatically be converted to a token of the defined type.
auto-permission	single-use or use (default)	Used to determine the permission to automatically set on each token created using this tokenization provider. Setting a value of single-use will mean a token is deleted on each successful use.

Enabling this Product

Using create-merchant-product API you can add a new product to your merchant record. Below is an example configuration for the payload of that request.

{
  "line": "tokenize",
  "product": "creditcard",
  "provider": "heartland",
  "config": {
    "secretAPIKey": "your-secret-api-key"
},
  
}