QloApps Heartland Payment Gateway

Offer your guests a smooth, secure, and hassle-free way to pay for room bookings directly on your hotel website with the QloApps Heartland Payment Gateway.

With this integration, you can accept online payments through major debit and credit cards, ensuring a fast, safe, and seamless checkout experience for your guests.

Please ensure that the configured region, currency, and customer location match the selected Heartland account settings. 

For example, if the region is set to the US, only USD payments from customers with a US ISO code and address will be accepted. Other countries cannot process payments.

Similarly, for other supported regions, the configured currency, country ISO code, and customer location must align with the selected region to ensure successful payment processing.

Note: QloApps Heartland Payment Gateway is currently supported only for the following regions: United States, Canada, United Kingdom, Ireland, and Europe.

• Allows guests to make secure online payments for hotel room bookings directly on the website.
• Supports payments through major debit and credit cards for a smooth checkout experience.
• Supports payment processing for the United States, Canada, United Kingdom, Ireland, and Europe regions.
• Validates payments based on configured region, currency, and customer country ISO code.
• Allows only region-specific customers to complete payments according to the configured Heartland settings.
• Enables hotel admins to process full or partial refunds directly from the QloApps back office.
• Provides a smooth, fast, and secure payment experience for hotel guests.
• Helps protect customer payment information with secure transaction processing.
• Easily integrates with the QloApps hotel booking system for payment management.

• Go to the Modules and Services tab from the QloApps back office.
• Click on Add New Module.

• Click on Choose a File and upload the ZIP file of the QloApps Heartland Payment Gateway module.

• After uploading the ZIP file, the module installation process will start automatically.

Once the installation is completed, your QloApps Heartland Payment Gateway module will be installed successfully.

Log in to QloApps as Admin, go to the Modules and Services tab, and search for the QloApps Heartland Payment Gateway module.

Then click on Configure to access the module settings.

The admin first needs to select the appropriate transaction environment for the configuration.

• Production (Live Mode): For real-life transactions, select the production.
• Test Mode: For testing, select the sandbox.

After selecting the environment, enter the required configuration details to establish a secure payment connection:

• App ID: Enter the App ID provided by Heartland/Global Payments to establish a secure connection between the QloApps Heartland Payment Gateway and your merchant account.
• App Key: Enter the app key provided by Heartland for authentication and secure payment processing.
• Merchant ID: Enter the Merchant ID to link payment transactions with your registered merchant account and ensure successful payment processing.

To create an app and obtain the required credentials, first visit the Global Payments Developer Portal:  

• Link: https://developer.globalpayments.com/ 

Once on the portal, register using your email address. After registration, you will receive an OTP verification email from Global Payments to verify your account.

After successful email verification, complete the required account details and finish the MFA (Multi-Factor Authentication) process.

Once registered, you can manage app test credentials for your different projects and test your integration before going live.

In Global Payments, an app is a set of credentials that includes an App ID and App Key, used to authenticate requests and securely connect QloApps with the payment gateway.

• Log into your account in the Developer Portal.

• Click the Profile icon and select My Account to access your dashboard.

• In the My Sandbox Credentials section of your dashboard, click the Create a New App arrow, and select Unified Payments. This will bring up the Create an App page.

• On the Create an App page, enter the required fields for your test app.

• When you’re finished creating the app, scroll down to the bottom of the page.

• Your app credentials will now appear on the left panel. You can copy them to use in the configuration section of your API request.

• To return to your account, you can click the breadcrumb link at the top of the page or on your profile in the upper right corner.

• Your new app will now appear in the My Sandbox Credentials table.

Note: Create a country-specific App in Global Payments and use its App ID, App Key, and Merchant ID in the QloApps Heartland Payment Gateway configuration.

For example, if you want to enable payments for the United States (US), create a US App in the Global Payments dashboard and use its credentials in the module configuration.

Admins can easily track and manage all Heartland payment transactions directly from the QloApps back office.

Steps to Access Transactions

• Log in to your QloApps admin panel.
• Navigate to the Heartland Transactions tab.
• Click on Transactions to view all payment transactions.

Once you open the Heartland Transactions page, you will see a complete list of all payment records processed through the QloApps Heartland Payment Gateway. 

The transaction list includes the following details:

• Order Reference – Displays the reference ID of the hotel booking order linked to the transaction.
• Heartland ID – Shows the unique transaction ID generated by Heartland for payment tracking.
• Customer – Displays the customer associated with the booking transaction.
• Total Amount – Shows the total payment amount processed for the booking.
• Refunded Amount – Displays the refunded amount, if any refund has been processed.
• Status – Indicates the payment status such as successful, refunded, or failed.
• Date – Shows the transaction date and time for easy tracking.

When the admin clicks View for a specific transaction on the Heartland Transactions page, a detailed transaction page opens where complete payment information and refund options are available.

The detailed view displays complete transaction information, such as:

• Payment Environment – Displays whether the transaction was processed in Sandbox or Production mode.
• Heartland Transaction ID – Shows the unique payment transaction ID generated by Heartland.
• Heartland Reference – Displays the payment reference associated with the transaction.
• Transaction Amount – Shows the total amount processed for the transaction.
• Order Reference – Displays the booking order reference linked to the payment.
• Customer – Shows customer details associated with the booking transaction.
• Payment Status – Displays the current payment status of the transaction.
• Transaction Date – Shows the date and time when the payment was processed.

Admins can also process refunds directly from the transaction detail page under the Heartland Transactions tab.

Refund Options:

• Full Refund – Refund the complete transaction amount.
• Partial Refund – Admin can enter a specific amount to be refunded.
• Refund Reason – Add a note or refund reason for reference.
• Process Refund Button – Initiates the refund request.

Once the refund is processed, a refund record will be created on the Heartland Transactions page for tracking and management.

The QloApps Heartland Payment Gateway provides a smooth and secure checkout experience for guests booking rooms online.

• The guest selects the desired room, booking dates, and proceeds to the checkout page.
• The guest enters the required booking details such as name, email address, contact information, and billing address.

Note: Heartland payment will appear only if the customer’s ISO code, billing address, and currency match the configured region settings.

• The guest selects the Heartland Payment Gateway from the available payment methods and proceeds with the payment.

• The guest completes the payment securely using a supported debit or credit card.

As QloApps uses the Heartland Drop-in UI, when a guest selects **Pay by Heartland**, the secure payment interface is displayed directly within the QloApps website.

This allows guests to enter card details and complete the payment without leaving the hotel website, ensuring a smooth, secure, and seamless checkout experience.

Once the payment is successful, the booking order is confirmed and the transaction is recorded in QloApps for admin tracking and management.

The QloApps Heartland Payment Gateway Module provides a secure and efficient way to manage online payments within QloApps.

It supports multiple currencies, ensures reliable transaction processing, and delivers a smooth checkout experience for guests.

Admins can manage payments easily, track transactions, view payment details, and handle full or partial refunds with proper records.

As a result, it enhances both guest satisfaction and overall operational efficiency for hotel businesses.

If you want to learn about the functionality of QloApps, then you can visit this link: All-In-One Property Management System

In case of any query, issue, or requirement, please feel free to raise it on the QloApps Forum

Current Product Version – 1.0.0

Supported Framework Version – QloApps 1.7.x & 1.6.x