QloApps Paddle Payment Gateway

The QloApps Paddle Payment Gateway Module enables hotel businesses to accept online payments through Paddle, a globally recognized Merchant of Record platform.

With this integration, hotels can offer guests a smooth checkout experience while simplifying payment management, tax compliance, and transaction processing.

Additionally, Paddle supports global payments across multiple countries and currencies, helping hotels expand their reach and accept payments from international guests with ease

Note: Paddle supports 30+ payment currencies and multiple payout currencies out of the box, letting you price in local currencies and receive payouts in USD, EUR, GBP, AUD, or CAD.

Check from here:https://developer.paddle.com/concepts/sell/supported-currencies

• Easily integrate Paddle with QloApps
• Provides secure and encrypted payment processing
• Delivers a smooth and user-friendly checkout experience
• Supports Sandbox and Production environments
• Enables real-time payment status updates
• Allows admins to track all transactions from the backend
• Displays detailed transaction information
• Supports Full and Partial Refunds
• Allows admins to enter custom refund amounts
• Maintains refund history for better tracking

Installing the QloApps Paddle Payment Gateway Module is quick and straightforward. Follow the steps below to get started:

1. Go to the “Modules and Services” tab in your QloApps admin panel.
2. Click on “Add New Module”.
3. Click on “Choose a file” and upload the module ZIP file.
4. After selecting the file, click on “Upload this module”.
5. Once the ZIP file is uploaded, the installation process will begin automatically.

After successful installation, QloApps displays a confirmation message, and the module appears in the list of installed modules

1. Log in to your QloApps Admin Panel.
2. Navigate to Modules & Services.
3. Search for Paddle Payment Gateway in the module list.
4. Click on Configure.

The admin must complete the required credentials and general settings to configure this module properly.

Configuration Settings

Once you open the configuration panel, you will find multiple fields that need to be filled correctly to enable Paddle payments.

Once you open the configuration panel, you will find multiple fields that need to be filled correctly to enable Paddle payments.

• Environment Mode: Defines the operational mode of the payment gateway
  • Sandbox: Used for testing transactions without real money
  • Production: Used for live transactions with actual payments
• API Key: A secure API key provided by Paddle used to authenticate API requests between QloApps and Paddle.
• Client Side Token: A public token used to initialize Paddle Checkout securely on the frontend.
• Webhook Secret Key: A secret key used to verify webhook notifications sent by Paddle to QloApps.

To integrate Paddle with QloApps, admins need to obtain API credentials from the Paddle dashboard.

Steps to Get Paddle Credentials

• Login to the Paddle Production Dashboard:
  https://login.paddle.com/start
• After logging in, the admin is redirected to the Paddle Dashboard.
• Navigate to Developer Tools → Authentication.

• Under the Authentication section, admins can:
  • Create a new API Key

• Generate a Client Side Token

• To generate the Webhook Secret Key, navigate to Developer Tools → Notifications.
• Click on “New Destination” to create a new notification destination.

• Enter the Webhook URL provided in the QloApps Paddle module configuration.
• Select the required events related to payments and refunds.
• Once the destination is created, Paddle generates a Webhook Secret Key for that notification endpoint.
• Copy the generated API Key, Client Side Token, and Webhook Secret Key, and enter them into the corresponding fields in the QloApps Paddle module configuration.
• Save the configuration to enable secure payments and real-time transaction updates between Paddle and QloApps.

Note: From the Paddle dashboard, admins can monitor and manage various business operations, including Transactions, Analytics, Reports, etc

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

Steps to Access Transactions

• Log in to your QloApps Admin Panel
• Navigate to Paddle Payment tab
• Click on Transactions

Transaction List Overview

Once you open the transactions page, you will see a list of all payment records with the following details:

• ID: Unique identifier of the transaction record in QloApps
• Order Reference: Unique booking reference associated with the order
• Transaction ID: Unique payment transaction ID generated by Paddle
• Payment Status: Displays the payment status of the transaction
• Order Status: Shows the current status of the order in QloApps
• Customer: Name and email address of the guest who made the booking
• Paid Amount: Total amount paid by the customer
• Date Added: Date and time when the transaction was created or recorded in the system

When the admin clicks on “View” in the QloApps Paddle Transactions page for a specific transaction.

A detailed transaction page opens where complete payment information and refund options are available.

The page displays complete transaction information such as:

• Payment Environment: Indicates whether the transaction was made in Sandbox or Production mode
• Paddle Transaction ID: Unique transaction ID generated by Paddle
• Transaction Amount: Total amount paid by the customer
• Order Reference: Unique booking reference ID in QloApps
• Customer Name: Name of the guest who made the booking
• Customer Email: Email address of the guest
• Transaction Status: Shows the current status of the payment
• Transaction Date: Date and time when the transaction was completed

Admins can also process refunds directly from the transaction detail page under the Paddle Transaction tab.

Refund Options

• Full Refund
• Partial Refund
  • In case of a Partial Refund, the admin can enter the specific amount to be refunded
• Remark Field: Add a note (e.g., cancellation reason)

Refund History

Displays all refund records associated with the transaction.

• Refund ID: Unique identifier generated by Paddle for the refund request 
• Transaction ID: Unique transaction ID associated with the refund
• Status: Displays the current status of the refund request
• Reason: Reason or remark provided while initiating the refund
• Refund Amount: Total amount refunded to the customer
• Refund Date: Date and time when the refund was processed

The QloApps Paddle Payment Gateway ensures a simple and fast checkout experience for guests booking rooms.

• Guest selects the desired room, dates, and proceeds to the booking checkout page
• Guest fills in required details such as name, email, and contact information
• Selects Paddle Payment Gateway from the available payment options

• QloApps redirects the guest to the Paddle payment interface
• Guest completes the payment using their preferred payment method

• After successful payment, QloApps redirects the guest back to the website
• Then, QloApps confirms the booking based on the payment status

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

Additionally, it supports global payments, multiple currencies, and delivers a smooth checkout experience.

Moreover, admins can manage everything through an easy-to-use backend. They track transactions, view detailed payment information, and handle full or partial refunds with proper records.

As a result, it improves both guest satisfaction and operational efficiency while helping businesses expand globally.

Current Version: 1.0.0

Supported Framework: 1.7.x & 1.6.x