The QloApps PhonePe Payment Gateway Module enables property owners to accept payments effortlessly through one of India’s most trusted digital payment platforms—PhonePe.
This allows guests to complete bookings quickly using their preferred payment methods such as UPI,Net Banking,Debit and Credit Cards, improving conversion rates and overall user experience.
Whether you are managing a boutique hotel, resort, or multi-property chain, this module ensures faster transactions, real-time payment updates, and a secure checkout process.
Note: PhonePe payment services are primarily available for businesses operating in India. Ensure that your business and merchant account are supported by PhonePe before enabling this payment gateway.
Features of QloApps PhonePe Payment Gateway
- Easily integrate PhonePe with your QloApps.
- Supports a variety of payment methods, including UPI, cards, and net banking.
- Allow customers to pay instantly using UPI apps by scanning QR codes or entering UPI IDs.
- Payments and refunds are updated by webhook as well as manual update through the update button, which is visible if the webhook fails
- Ensures encrypted and safe payment processing through PhonePe’s trusted infrastructure.
- Provides a smooth and intuitive payment interface for guests.
- Supports both Sandbox (UAT) and Production environments for testing and live usage.
- Real-time payment status updates ensure accurate booking confirmation.
- Dedicated transaction panel for admins to view and manage all payments.
- Detailed transaction view with complete payment and customer information.
- Easy refund management with Full Refund and Partial Refund options.
- Allows admins to enter custom refund amounts in case of partial refunds.
- Maintains refund history for complete transparency and tracking.
How to Install QloApps PhonePe Payment Gateway
Installing the QloApps PhonePe Payment Gateway Module is quick and straightforward. Follow the steps below to get started:
- Go to the “Modules and Services” tab in your QloApps admin panel.
- Click on “Add New Module”.

- Click on “Choose a file” and upload the module ZIP file.
- After selecting the file, click on “Upload this module”.
Once the ZIP file is uploaded, the installation process will begin automatically.
How to Configure QloApps PhonePe Payment Gateway
- Log in to your QloApps Admin Panel.
- Navigate to Modules & Services

- Then Search for your Module in Module List
- Click on Configure
The admin must complete credentials and general settings to configure this module properly.
Configuration Setting
Once you open the configuration panel, you will find multiple fields that need to be filled correctly to enable PhonePe payments.

- Environment:Defines the operational mode of the payment gateway
- Sandbox (UAT): Used for testing transactions without real money
- Production: Used for live transactions with actual payments
- Merchant ID: A unique merchant identifier provided by PhonePe
- Client ID: Used for authentication between QloApps and PhonePe APIs.
- Client Secret: A secure key provided by PhonePe for API authentication
- Client Version (PhonePe Version): Specifies the PhonePe API version being used. It ensures compatibility with the PhonePe API
- Webhook Endpoint URL: Used to receive real-time payment updates from PhonePe.
- Only HTTPS URLs are supported
- Sends payment status updates like: Success, Failure, Pending
How Admin can get APIs for QloApps PhonePe
Register on PhonePe Payment Gateway
- First, sign up using this link:
https://business.phonepe.com/pg/register?utm_source=website_dev_docs - Complete your business registration and KYC process

- Once registered, log in to your PhonePe merchant dashboard
- In the dashboard, navigate to Developer Settings

- Inside Developer Settings, you will find options to:
- Create API credentials
- Configure Webhook


- After creation, you will receive:
- Merchant ID
- Client ID
- Client Secret
- Client Version
- Copy the Webhook URL from QloApps module configuration
Note:
- You can switch between Sandbox (Test Mode) and Production directly from the PhonePe dashboard
- Sandbox (Test Mode):
- Used for testing payments
- No real transactions happen
- Limited functionality
- Production Mode:
- Used for real payments
- All live transactions are processed
How Admin view Transactions & Refunds in PhonePe Dashboard
Go to the Transactions tab in PhonePe dashboard
You can view:
- Live Transactions
- Transaction History
- Refunds
Important Note:
- Transaction and refund data are only available in Production (Live mode)
- In Sandbox mode, these features may not be available or fully functional
How Admin can view all QloApps PhonePe Transactions
Admins can easily track and manage all PhonePe transactions directly from the QloApps back office.
Steps to Access Transactions
- Log in to your QloApps Admin Panel
- Navigate to PhonePe 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:

- Order Reference: Unique booking/order ID associated with the transaction
- Customer: Name and email of the guest who made the booking
- Merchant Txn ID: Unique transaction ID generated from the merchant (QloApps side)
- PhonePe Txn ID: Transaction ID generated by PhonePe for tracking
- Amount: Total transaction amount paid by the customer
- Refunded Amount: Amount that has been refunded (if any)
- Status: Shows payment status such as Completed, Pending, or Failed
- Date: Date when the transaction was made
- View: Option to see detailed transaction information
How Admin can view QloApps PhonePe Transaction Details View
When the admin clicks on “View” in the Transactions page for a specific transaction, a detailed transaction page opens where complete payment information and refund options are available.
Displays complete transaction information such as:
- Payment Environment (Sandbox/Production)
- PhonePe Transaction ID
- Transaction Amount
- Order Reference
- Customer Name & Email
- Payment Status
- Payment Date

How Admin can Manage QloApps PhonePe Refund Management
Admins can also process refunds directly from the transaction detail page under PhonePe Transcation Tab:
- Refund Options
- Full Refund
- Partial Refund(In case of Partial Refund, admin can enter the specific amount to be refunded
- Remark Field: Add a note (e.g., cancellation reason)
- Process Refund Button: Initiates the refund request

Refund History
- Displays all refund records associated with the transaction

- Includes:
- Refund ID
- Merchant Refund ID
- Refunded Amount
- Status (Completed/Pending)
- Remark
- Date
QloApps Phonepe Frontend Payment Flow (Guest Experience)
The QloApps PhonePe 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 PhonePe Payment Gateway from the available payment options.

- Guest is redirected to the PhonePe payment interface
- Complete Payment Using Preferred Method
- Pay via UPI (QR code or UPI ID)
- Use Debit/Credit Card
- Choose Net Banking

- After successful payment, the guest is redirected back to the website
- Booking is automatically confirmed based on payment status
Conclusion
The QloApps PhonePe Payment Gateway Module offers a reliable and efficient way to handle online payments for your hotel booking system.
With support for multiple payment methods, real-time transaction updates, and a secure payment environment, it enhances both the guest experience and admin control.
By integrating PhonePe with QloApps, businesses can simplify payment processing, reduce booking drop-offs, and deliver a faster, more convenient checkout experience to their guests.
Current Version: 1.0.0
Supported Framework 1.7.x & 1.6.1

Be the first to comment.