Pre-Requisites & Getting Started
This guide is assuming that you are already running your company website on WordPress and WooCommerce.
Configuration
Log in to the Admin Panel for WooCommerce and navigate to WooCommerce > Settings > Payments. From here, you can configure the various integration types supported by WooCommerce.
The Heartland Settings tab allows you to enter your overall account credentials. Navigate to WooCommerce > Settings > Payments. Use the toggle under Enabled to select the Heartland gateway. If this is your first time activating our plugin, the Settings page will appear. If you already enabled the plugin and want to change the settings, select Manage.
| Field | Description |
|---|---|
| Enable/Disable | Determines if the payment method is available at your WooCommerce 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 WooCommerce 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. Logs can be found at WooCommerce > Status > Logs. |
| 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 |