Pre-Requisites & Getting Started
This guide is assuming that you are already running your company website on Magento 2 / Adobe Commerce.
Configuration
Log in to the Admin Panel for Adobe Commerce and navigate to Stores > Configuration. Under the Sales heading, click the Payment Methods option. From here, you can configure the various integration types supported by Adobe Commerce.
The Heartland Settings section allows you to enter your overall account credentials. These are global settings that apply to all integration types. You can enter specific credentials for different websites by changing the website scope in Adobe Commerce.
| Field | Description |
|---|---|
| Enable/Disable | Determines if the payment method is available at your Magento 2 store’s checkout. |
| Title | Description of the payment method displayed to the customer at checkout, e.g.,"Credit Card." The title will also be recorded in Magento 2 to indicate how the transaction was processed. |
| Live Mode | Allows you to switch between the Live and Sandbox versions of your Heartland account. |
| Sandbox/Live Public API Key | The Public API Key and Secret API key are used to securely tokenize credit card data and process the payment transaction with the gateway. |
| Sandbox/Live Secret API Key | |
| Enable Logging |
Allows logging of all requests to and from the gateway. Can also log private data and should only be enabled in a development or stage environment. |
| Payment Action | The sale transaction can be flagged for automatic capture (Authorize + Capture) or flagged as requiring a separate capture action later (Authorize only). |
| Allow Card Saving |
Determines whether a customer’s card can be saved to Global Payments Card Storage following a successful transaction. If set to Yes, a checkbox will display on the Hosted Fields that gives the customer the choice to store their card or not. If set to No, no checkbox is displayed and the card will not be stored. |
| Order Transaction Descriptor | During a Capture or Authorize payment action, this value will be passed along as the transaction-specific descriptor listed on the customer's bank account. |
| Check AVS CVN | This enables a post-authorization check to reject and automatically reverse payment transactions based on AVS/CVN result codes. |
| AVS Reject Conditions | |
| CVN Reject Conditions |