WHMCS add funds lets hosting clients prepay an amount into their account and use that credit for future invoices. With the PaymentSetu WHMCS module, you can let clients pay the add-funds invoice by UPI into your own connected merchant account and have the verified payment recorded in WHMCS automatically.
This setup is useful when clients renew domains, hosting, VPS, SSL or add-on services regularly. Instead of asking a client to make a separate payment for every renewal, you can enable a prepaid credit balance and let WHMCS use it during billing.
What Add Funds does in WHMCS
WHMCS calls prepaid account money credit. A client chooses Add Funds, enters an amount, and selects a payment method. WHMCS then creates an invoice for that deposit; the balance is not increased merely because the client submitted the form.
After the invoice is paid, WHMCS records the transaction and adds the deposit to the client’s credit balance. The client can then use that balance against unpaid invoices. WHMCS also allows an administrator to create an add-funds invoice from the client profile.
The WHMCS Credit Balances documentation describes the standard client flow: open Add Funds, enter an amount, choose a payment method and pay the resulting invoice. Clients may need at least one active approved order before the Add Funds option is available, depending on your settings.
For an Indian hosting business, the payment path looks like this:
- The client requests a top-up in the WHMCS Client Area.
- WHMCS creates an add-funds invoice for the requested amount.
- The client opens the invoice and pays by UPI.
- PaymentSetu matches the UPI payment to the invoice and sends the result to the module.
- WHMCS marks the invoice paid and records the amount as client credit.
- WHMCS can use that credit when it generates a later renewal invoice.
What you need before setup
Prepare these items before changing your WHMCS settings:
- A self-hosted WHMCS installation with administrator access.
- An active Paytm Business or PhonePe Business merchant account to receive UPI payments.
- The PaymentSetu WHMCS module files.
- A PaymentSetu API key and a callback URL.
- At least one WHMCS client with an approved active order for a realistic test.
PaymentSetu is a payment verification service, not a payment gateway. Your client pays the UPI merchant account connected to your business, while PaymentSetu matches the payment to the WHMCS invoice and reports the verified result. The money does not pass through or sit in a PaymentSetu wallet.
If you have not installed the module, open the PaymentSetu WHMCS plugin page first. The module download is free and works with any PaymentSetu plan from ₹399 per 30 days.
Step 1: Enable WHMCS credit balances
Why this matters: the PaymentSetu module can confirm the invoice payment, but WHMCS must have its credit system enabled to turn a paid add-funds invoice into usable client balance.
- Sign in to the WHMCS Admin Area.
- Go to Configuration > System Settings > General Settings.
- Open the Credit tab.
- Select the option to enable the credit system.
- Click Save Changes.
Success looks like this: the Client Area can show an Add Funds option for eligible clients, and the Credit tab displays the deposit and balance controls described below.
The current WHMCS Credit settings reference lists these controls under the Credit tab:
| Setting | What it controls | Practical starting point |
|---|---|---|
| Minimum Deposit | Smallest amount allowed in one top-up | Set this above your smallest useful renewal amount |
| Maximum Deposit | Largest amount allowed in one top-up | Set a ceiling that fits your normal billing pattern |
| Maximum Balance | Highest total credit a client may hold | Keep it aligned with your refund and support process |
| Require Active Order | Whether a client needs an approved active order before adding funds | Keep enabled for a client-only hosting portal |
| Automatic Credit Use | Whether available credit is applied to newly generated invoices | Enable if you want renewal billing to use credit automatically |
Choose deposit limits carefully
The minimum deposit prevents very small invoices that create unnecessary billing records. The maximum deposit limits the size of a single top-up. Maximum Balance is different: it limits the total credit held by a client across multiple deposits.
For example, if you set a minimum deposit of ₹500, a maximum deposit of ₹25,000 and a maximum balance of ₹50,000, a client can add ₹500 to ₹25,000 per transaction but cannot build a credit balance above ₹50,000. Use limits that match your service prices and customer support process rather than copying another hosting company’s values.
Step 2: Decide how credit will pay renewals
Why this matters: WHMCS has separate behaviour for new invoice generation and invoices that already exist.
When Automatic Credit Use is enabled, WHMCS checks a client’s available credit while generating new recurring invoices. If the credit covers the invoice, the invoice can be paid from the balance without another UPI payment. If the credit only covers part of the invoice, the remaining amount stays due for the client to pay.
The setting does not retroactively apply a newly added balance to every existing unpaid invoice. For an existing invoice, the client can open it in the Client Area and apply available credit where WHMCS shows that option. You can also manage credit from the client profile in the Admin Area.
This distinction helps you explain the experience to clients:
- Top-up paid before a renewal invoice is generated: the balance can be applied automatically when WHMCS creates the renewal invoice.
- Top-up paid after an invoice already exists: the client may need to apply credit to that invoice from the Client Area.
- Top-up does not cover the full invoice: the client must pay the remaining balance using an available payment method.
For account-level details, see the WHMCS client profile Summary tab. Admins can also use Create Add Funds Invoice from a client profile when they need to prepare a specific deposit for a customer.
Step 3: Install the PaymentSetu WHMCS module
Why this matters: WHMCS needs the module and callback handler to display the UPI payment option and receive the verified invoice result.
- Download the PaymentSetu module from the WHMCS plugin page.
- Extract the download on your computer.
- Upload
paymentsetu.phpto your WHMCSmodules/gateways/directory. - Upload the callback file to
modules/gateways/callback/. - In the WHMCS Admin Area, go to Setup > Payments > Payment Gateways.
- Activate PaymentSetu.
Success looks like this: PaymentSetu appears as an active payment method and its configuration screen displays fields for the API key and callback URL.

Do not paste the API key into a theme file or a client-facing template. Keep it in the module’s protected configuration fields and limit WHMCS administrator access to people who need it.
Step 4: Connect the callback URL and API key
Why this matters: the callback is the return path through which the verified UPI result reaches the correct WHMCS installation and invoice.
- Open the activated PaymentSetu settings in WHMCS.
- Copy the callback URL shown there.
- Sign in to your PaymentSetu account and create an API key.
- Add the WHMCS callback URL to the API key configuration.
- Copy the API key into the PaymentSetu settings in WHMCS.
- Save the module configuration.
Success looks like this: the settings save without an error, the callback URL is the exact URL generated for this WHMCS installation, and the API key field contains the key without extra spaces or quotation marks.
The callback URL is installation-specific. Do not replace it with a generic homepage URL, a browser address copied from an unrelated invoice, or a URL from a staging system. If you have separate staging and production WHMCS installations, configure each one with its own module settings.
Step 5: Let a client pay the add-funds invoice by UPI
Why this matters: the client should see the same payment method on the add-funds invoice that you tested on a normal WHMCS invoice.
Ask a test client with an approved active order to follow these steps:
- Log in to the WHMCS Client Area.
- Open Add Funds.
- Enter an amount within your minimum deposit, maximum deposit and maximum balance rules.
- Choose the PaymentSetu UPI payment method.
- Select Add Funds to create the invoice.
- Open the new invoice and scan the displayed QR code or use the available UPI payment option.
- Pay the exact invoice amount from a UPI app to the connected merchant account.
- Keep the UPI transaction reference number until the invoice changes to Paid.
Success looks like this: the UPI payment is visible in the connected merchant account, the PaymentSetu verification result reaches WHMCS, the add-funds invoice becomes Paid, and the client’s credit balance increases by the invoice amount.
Do not mark the invoice Paid manually as part of the normal workflow. Manual marking can bypass the payment record and make the client’s credit history harder to reconcile. If you need to investigate a payment, retain the invoice ID and UPI transaction reference and check the module and WHMCS transaction records.
Step 6: Verify credit is applied to a renewal
Why this matters: a paid top-up proves the payment path works; a renewal test proves the credit balance is useful for recurring hosting billing.
- Note the client’s credit balance before the test.
- Create or wait for a small test renewal invoice.
- Confirm whether Automatic Credit Use is enabled.
- Check the invoice’s payment and credit entries.
- Confirm that the credit amount reduced the invoice balance.
- If the credit covers the full invoice, confirm the invoice is Paid.
- If the credit covers only part of it, confirm that the remaining amount is still due.
Success looks like this: WHMCS shows a traceable credit transaction, the renewal invoice reflects the applied amount, and the client’s remaining balance matches the arithmetic.
For example, a client who adds ₹2,000 and later receives a ₹1,200 renewal invoice should have ₹800 left after the full renewal is paid from credit. This is an example of the accounting flow, not a required deposit amount.
Verify the complete WHMCS add-funds setup
Run this short checklist after installation:
- Credit is enabled in General Settings > Credit.
- Minimum Deposit, Maximum Deposit and Maximum Balance accept the values you intend to use.
- Require Active Order matches your onboarding policy.
- Automatic Credit Use matches your renewal workflow.
- PaymentSetu is active under Setup > Payments > Payment Gateways.
paymentsetu.phpis inmodules/gateways/.- The callback file is in
modules/gateways/callback/. - The API key and callback URL belong to the same WHMCS installation.
- A test add-funds invoice is created for an eligible client.
- The invoice records the verified UPI payment and increases credit.
- A later renewal uses the credit as expected.
Keep the invoice number, payment reference and WHMCS client ID in your test notes. If you need to reconcile UPI payments later, the UTR number guide explains where that reference is normally found.
Troubleshooting WHMCS add funds with UPI
Add Funds is not visible
Confirm the Credit system is enabled. Then check whether Require Active Order is enabled and whether the client has at least one active approved order. Also check that the client is signed in to the correct Client Area account.
The deposit amount is rejected
Compare the requested amount with Minimum Deposit, Maximum Deposit and Maximum Balance. A client may be within the per-transaction limit but still over the total balance limit.
PaymentSetu is not listed on the invoice
Check that the module files are in the correct directories and that PaymentSetu is activated under Setup > Payments > Payment Gateways. Save the module settings again after confirming the API key and callback URL.
The UPI payment is visible, but the invoice is still unpaid
Check the invoice number and UPI transaction reference first. Then confirm that the callback URL copied into PaymentSetu exactly matches the URL shown in the WHMCS module settings. Do not treat a client’s screenshot as payment confirmation; use the merchant account record and the verified module result.
The invoice is paid but credit is not what you expected
Open the client’s credit history and the invoice ledger. Check whether the invoice amount included tax or another line item, whether a partial credit was already used, and whether an administrator made a manual adjustment. For an existing invoice, remember that adding funds does not automatically apply new credit to every unpaid invoice.
FAQ
What is WHMCS Add Funds?
WHMCS Add Funds allows an eligible client to create an invoice for a prepaid account balance. After the invoice is paid, WHMCS records the amount as credit that can be used for future or unpaid invoices.
Can clients add funds by UPI in WHMCS?
Yes. Install and activate the PaymentSetu WHMCS module, connect its API key and callback URL, and make the PaymentSetu payment method available. The client then pays the add-funds invoice by UPI, and the verified result is sent back to WHMCS.
Does WHMCS apply credit automatically to renewals?
It can apply available credit automatically when it generates new recurring invoices if Automatic Credit Use is enabled. Credit added after an invoice already exists may need to be applied to that invoice from the Client Area.
What should I set as the maximum WHMCS deposit?
Choose a maximum that fits your normal hosting, domain and service invoice values. Also configure Maximum Balance separately, because it limits the client’s total stored credit rather than one top-up.
Is the PaymentSetu WHMCS module free?
The WHMCS module is a free download, and it works with a PaymentSetu plan from ₹399 per 30 days. PaymentSetu verifies the UPI payment while the money goes directly to your connected merchant account.