Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

1. POS Tasks

  • Switching your RTP|One POS over to Heartland Payments requires working with your Active, Heartland, and Aspenware Representatives. It also requires RTP|One to be on the latest 2021 version.

    Status
    colourRed
    titleRequired

Status
colourYellow
titlePrerequisite

2. Infrastructure Tasks

  • Set up account with Heartland Payment Systems and obtain required information

    Status
    colourRed
    titleRequired

  • Register for a Developer Account with Heartland Payment Systems to obtain test credentials.

  • Work with your Aspenware Representative to ensure that the Unity rtp-config.jsopn file is setup properly. Ensure the following settings are set.

    • UsePaymentCardTokenTable set to TRUE

    • EncryptPaymentCardTokenValue set to FALSE

    • Validate the credit related settings in the Unity rtp-config.json when that switch occurs.  

  • If on a version earlier than 2.27, your Aspenware Representative will also need to set the following in the Azure appsettings.json file:

    • AllowStorageOfCC = TRUE

    • AllowTransferOfCC = FALSE

Status
colourYellow
titlePrerequisite

3. Commerce Tasks

  • Install and enable the Heartland Plugin

    Status
    colourRed
    titleRequired

Status
colourYellow
titlePrerequisite

Update Settings

Status
colourRed
titleREQUIRED

  • In Configuration > Settings > All Settings, configure the following:

    1. ecommercesettings.allowstorageofcc = TRUE

    2. ecommercesettings.allowtransferofcc = FALSE

Status
colourYellow
titleprerequisite

Update Language String

Status
colourBlue
titleoptional

  • Edit ‘Checkout.ResortCharge.UsePaymentCreditCardForResortCharge’ language string

Status
colourYellow
titlePrerequisite

  • Configure Payment Method

    Status
    colourRed
    titleRequired

Status
colourGreen
titleDetailed Setup

  • Install and enable the Heartland and Global Payments Payment Provider HTML Widget

Status
colourGreen
titledetailed setup

...

Info

NOTE: If you are interested in implementing Heartland PaymentsPayment Systems, please reach out to Phil Kilpatrick at Heartland (philip.kilpatrick@e-hps.com).

...

  • Work with your Aspenware Representative to install the Heartland Payments Plugin. Go to Configuration > Local Plugins and find the Heartland Payment Provider plugin to install and enable the plugin. You need to restart the application for the plugin install to take effect.

  • Next, from Configuration > Settings > Payment methods choose to Edit the Heartland Payment Provider. Check Is Active and Update to activate.

Note

IMPORTANT: Make sure to mark all other payment gateways, except Affirm, as inactive so that only the Heartland Payment Plugin is installed for payment. Aspenware strongly recommends working with your Aspenware representative to uninstall other payment gateway plugins that are no longer in use.

...

Insert excerpt
Setting, Language String and/or HTML Widgets for this feature
Setting, Language String and/or HTML Widgets for this feature
nopaneltrue

Language Strings

  • Go to Configuration > Languages > English, search for the resource name: 'Checkout.ResortCharge.UsePaymentCreditCardForResortCharge.' Change the value associated with this string to a reminder that the card the guest has entered will be saved for Resort Charge use in RTP|One.

...

Update the following settings in Commerce Admin.

  • Go to Configuration > Settings > All settings (advanced)

    1. Search for ecommercesettings.allowtransferofcc

      1. Click Edit.

      2. Set the Value to FALSE and click Update.

    2. Search for ecommercesettings.allowstorageofcc

      1. Click Edit.

      2. Set the Value to FALSE.

      3. Click Update.

Note

IMPORTANT: AllowStorageofCC must be set to TRUE for the GL Export function to work.

...

1. Configure Payment Method

  • Once installed, go to Configuration > Settings > Payment methods. Select to Configure ‘Heartland Payment Provider.’

    1. Use Sandbox: checked for test environment, Unchecked if configuring for a production environment.

    2. Public Key: This will be received from Heartland to input. Note that the public and secret keys are unique, and cannot be interchanged between Sandbox and Production environments.

    3. Secret Key: This will be received from Heartland to input. Note that the public and secret keys are unique, and cannot be interchanged between Sandbox and Production environments.

    4. Requires Billing Address: Must be checked, so AVS verification can function.

  • The following values can be entered from the Configure screen to customize the field labels and error messages on the payment page. The following items can be customized:

    1. Card Number Label:

    2. Card Number Placeholder:

    3. Card Number Invalid Title:

    4. Card Number Invalid Message:

    5. Expiration Label:

    6. Expiration Placeholder:

    7. Expiration Invalid Title:

    8. Expiration Invalid Message:

    9. CVV Label:

    10. CVV Placeholder:

    11. CVV Invalid Title:

    12. CVV Invalid Message:

    13. Name Label:

    14. Name Placeholder:

    15. Name Invalid Title

    16. Name Invalid Message

...

2. Install and enable the Heartland and Global Payments Payment Provider Widget

  • Go to Configuration> Widgets

  • Scroll to find the ‘Heartland and Global Payments Payment Provider’ widget in the list.

  • Click Edit.

  • Check ‘Is Active’.

  • Click Save.

Common Troubleshooting

Q: What functionality is and isn’t available to me because of having Heartland as a Payment Provider? 

...

A: You must uninstall the previous payment provider plugin and ensure that Heartland is the ONLY payment provider plugin that is enabled. Go to Configuration > Payment Methods in Admin to ensure that Heartland is the ONLY payment provider installed and enabled.

...