Heartlandhealthcare

How to enable Heartlandhealthcare Credit Card on a merchant.

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

Features

Refund A creditcard payment processed with can be / according to its status. ✅ Payment Authorization Payments can be authorized by customers using Credit Card. ✅ Payment Capture Payment authorizations made using Credit Card payment methods can be captured. This step happens automatically with CHARGE transactions.

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.

NameTypeDescriptionRules
hostBase URL used for API requests.
secretAPIKeySecret API key for authenticating requests to the Heartland service. Examples: sk_test_4eC39HqLyjWDarjtT1zdp7dc.
developerIDDeveloper identifier for the Heartland API.
versionNbrVersion number of the

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": "payments",
  "product": "creditcard",
  "provider": "heartlandhealthcare",
  "config": {
    "secretAPIKey": "sk_test_4eC39HqLyjWDarjtT1zdp7dc"
  }
}

Data Mapping

The following bullet points outline the mapping of data fields between the Authvia platform and the system, detailing the correspondence of specific attributes for seamless data integration.

  • Authvia transaction.reference.external maps to CardHolderPONbr
  • Authvia transaction.description maps to UNMAPPED
  • Authvia transaction.id maps to UNMAPPED
  • Authvia transaction.metadata.CardBrandTxnId maps to CardBrandTxnId
  • Authvia merchant.id maps to UNMAPPED