WHMCS Cryptomus Payment Gateway Setup Guide 2026

Accepting cryptocurrency payments is no longer optional for IPTV resellers in 2026. A large segment of the IPTV customer base actively prefers crypto — for privacy, for cross-border convenience, and because traditional card processors increasingly flag IPTV transactions as high-risk. Cryptomus is one of the most reliable crypto payment processors available today, and when integrated with WHMCS via the dedicated H2H gateway module, it provides fully automated invoice matching and payment confirmation without any manual intervention.

This guide covers everything you need to set up the WHMCS Cryptomus H2H payment gateway for your IPTV business — from creating your Cryptomus account to processing your first live transaction.

What Is Cryptomus?

Cryptomus is a cryptocurrency payment processor that allows businesses to accept payments in Bitcoin (BTC), Tether (USDT), Ethereum (ETH), Litecoin (LTC), and a range of other cryptocurrencies. Unlike many crypto payment processors that require you to hold funds on a third-party platform before withdrawing, Cryptomus supports host-to-host (H2H) settlement — meaning payments can be configured to settle directly to your own wallet address.

For IPTV businesses, Cryptomus offers several key advantages:

• No traditional banking dependency — no risk of bank account termination due to IPTV business type
• Global reach — accept payments from customers in any country where crypto is accessible
• Low transaction fees compared to card processors
• No chargebacks — cryptocurrency transactions are irreversible, eliminating chargeback risk entirely
• Instant settlement — funds clear significantly faster than bank transfers or card settlements

What Is the WHMCS Cryptomus H2H Gateway Module?

The WHMCS IPTV Cryptomus H2H Payment Gateway is a dedicated integration module that connects your WHMCS billing system directly to the Cryptomus API.

When a client chooses to pay with cryptocurrency at checkout, the module:

1. Generates a unique payment address for that invoice via the Cryptomus API
2. Displays the payment address and amount to the client in the WHMCS checkout
3. Monitors the Cryptomus API for payment confirmation
4. Automatically marks the WHMCS invoice as paid on confirmation
5. Triggers WHMCS automation — provisioning the IPTV service, sending the welcome email, activating the account

The entire flow is automated. No manual invoice checking, no manual account activation, no manual payment reconciliation.

Key module specifications:

• H2H architecture — payments settle to your configured wallet
• Supports BTC, USDT (TRC20, ERC20), ETH, LTC, and more
• Handles partial payments and overpayments
• Automatic invoice expiry and regeneration on timeout
• Full transaction log inside WHMCS admin
• One-time license, lifetime updates
• Per domain license

Requirements Before You Start

Before setting up the WHMCS Cryptomus H2H gateway, ensure you have the following in place:

• An active WHMCS installation (version 8.x or above recommended)
• A Cryptomus merchant account (free to create at cryptomus.com)
• The WHMCS Cryptomus H2H module purchased from whmcsmodules.net
• WHMCS running on a server with a valid SSL certificate (HTTPS required for payment callbacks)
• PHP 8.1 or above on your WHMCS server

Step 1 — Create Your Cryptomus Merchant Account

Go to cryptomus.com and register a merchant account. The registration process requires:

• A valid email address
• Business name and description
• Verification of your identity (KYC) — required for withdrawal above certain thresholds

Once your account is created and verified, log in to the Cryptomus merchant dashboard.

Step 2 — Generate Your Cryptomus API Credentials

In the Cryptomus merchant dashboard:

1. Navigate to Settings → API
2. Generate a new Payment API key — this is the key your WHMCS module will use to create payment requests
3. Copy and securely store your Merchant UUID — this is your unique merchant identifier
4. Set your webhook URL — this is the callback endpoint WHMCS will expose for payment notifications (covered in Step 5)

You will need both the Payment API key and the Merchant UUID when configuring the WHMCS module.

Important: Never share your API key publicly or commit it to version control. Treat it with the same security as a password.

Step 3 — Configure Wallet Settlement (H2H)

For H2H settlement — where payments go directly to your own wallet rather than sitting in a Cryptomus balance — configure your payout wallet addresses in the Cryptomus dashboard:

1. Go to Wallets → Add Wallet
2. Add your wallet address for each currency you want to accept (BTC, USDT TRC20, USDT ERC20, ETH, etc.)
3. Set the auto-payout threshold if desired — Cryptomus can automatically send funds to your wallet once a minimum balance is reached

If you prefer to hold funds in your Cryptomus balance and withdraw manually, this step is optional. H2H is recommended for IPTV businesses that want full control over their funds.

Step 4 — Install the WHMCS Cryptomus H2H Module

After purchasing the module from whmcsmodules.net, you will receive a ZIP file. Extract it and locate the gateway module file — typically named cryptomush2h.php or similar as specified in the included documentation.

Upload the module file:

Upload to: /your-whmcs-root/modules/gateways/

The file should sit directly inside the gateways directory, not in a subdirectory.

If a callback file is included (for IPN/webhook handling), upload it to:

Upload to: /your-whmcs-root/modules/gateways/callback/

After uploading, verify the file permissions are set correctly — 644 for files is standard.

Step 5 — Activate and Configure the Module in WHMCS

Log in to your WHMCS admin panel and navigate to:

System Settings → Payment Gateways → All Payment Gateways

Locate the Cryptomus H2H gateway in the list and click Activate.

Once activated, click Configure and enter the following:

Webhook / Callback URL:

Your callback URL will be in the format:

https://yourdomain.com/modules/gateways/callback/cryptomush2h.php

Copy this URL and paste it into the Webhook URL field in your Cryptomus merchant dashboard (Settings → API → Webhook URL). This is the endpoint Cryptomus will POST payment notifications to, which WHMCS uses to automatically confirm invoices.

Click Save Changes.

Step 6 — Test the Integration

Before going live, test the complete payment flow using Cryptomus test mode:

1. Ensure Test Mode is enabled in the WHMCS gateway configuration
2. Create a test client account in WHMCS
3. Create a test invoice for a small amount
4. Go through the checkout process and select Cryptomus as the payment method
5. Verify that a payment address is generated correctly
6. Use the Cryptomus test payment tool in the merchant dashboard to simulate a payment
7. Verify that the WHMCS invoice is automatically marked as paid
8. Verify that the WHMCS automation triggers correctly — service provisioning, welcome email, etc.

If the invoice is not marked as paid automatically, check:

• The webhook URL is correctly set in Cryptomus dashboard
• Your WHMCS server is accessible from the public internet (not on localhost)
• SSL is valid on your WHMCS domain — Cryptomus requires HTTPS for webhook delivery
• PHP error logs for any module errors

Once the test flow completes successfully, disable Test Mode and the gateway is live.

Step 7 — Configure the Checkout Display

In WHMCS, go to System Settings → Payment Gateways → Manage Existing Gateways and ensure the Cryptomus gateway is:

• Set as Active
• Assigned a clear display name that your customers will recognise at checkout (e.g., "Pay with Crypto – BTC, USDT, ETH")
• Positioned appropriately in the payment method list — if crypto is your primary payment method for IPTV customers, consider placing it first

Handling Common Issues

Invoice Not Marked as Paid Automatically

The most common cause is a misconfigured webhook URL. Verify:

1. The webhook URL in Cryptomus matches exactly the callback file path on your server
2. Your server firewall is not blocking incoming POST requests from Cryptomus IP addresses
3. The callback PHP file is present in /modules/gateways/callback/ with correct permissions

Customer Pays Wrong Amount

The Cryptomus H2H module handles underpayments and overpayments according to your configuration:

• Underpayment — by default, the invoice remains unpaid. You can configure a tolerance threshold (e.g., accept payments within 1% of the invoice amount) in the module settings
• Overpayment — the invoice is marked as paid and the overpaid amount remains in your Cryptomus balance or is sent to your wallet depending on your payout configuration

Payment Address Expired

Cryptocurrency payment addresses generated by Cryptomus expire after the invoice expiry period you configured (recommended 30–60 minutes). If a customer's payment address expires before they pay, they should return to the WHMCS invoice and click Pay Again — a new address will be generated.

Exchange Rate Fluctuation

Cryptomus locks the exchange rate at the time the payment address is generated. The customer pays the exact crypto amount shown at checkout, regardless of subsequent rate movement during the payment window. This protects both you and the customer from rate fluctuation during the payment process.

Security Best Practices

When running a live crypto payment gateway, observe these security practices:

• Rotate your API keys periodically — regenerate your Cryptomus API key every 6–12 months and update the WHMCS configuration immediately
• Restrict WHMCS admin access by IP — limit access to your WHMCS admin panel to known IP addresses where possible
• Monitor transaction logs — review the WHMCS payment transaction log weekly for any anomalies
• Keep WHMCS updated — always run the latest stable WHMCS version to ensure security patches are applied
• Keep the module updated — lifetime updates are included with your whmcsmodules.net license; apply updates promptly

Why Cryptomus Over Other Crypto Gateways for IPTV

Several crypto payment processors offer WHMCS integrations. Here is why Cryptomus is particularly well-suited for IPTV businesses:

The H2H settlement model is the key differentiator. Funds going directly to your own wallet means no dependence on a third-party platform holding your revenue — a significant operational risk reduction for any business.

Combining Cryptomus with Other Payment Gateways

For maximum conversion, IPTV resellers should offer multiple payment methods. The recommended gateway combination for WHMCS IPTV businesses is:

• Stripe — for customers who prefer card payments (WHMCS IPTV Stripe Gateway)
• PayPal — for customers who prefer PayPal (WHMCS IPTV PayPal Payment Gateway)
• Cryptomus H2H — for customers who prefer cryptocurrency

Offering all three covers the full spectrum of your customer base and eliminates payment method as a reason for cart abandonment. All three gateways can run simultaneously in WHMCS — customers choose their preferred method at checkout.

Frequently Asked Questions

Is Cryptomus free to use?
Cryptomus charges a transaction fee on each payment processed — there is no monthly subscription fee. The current fee structure is available on the Cryptomus website. The WHMCS module itself is a one-time license purchase from whmcsmodules.net.

Which cryptocurrencies does Cryptomus support?
Cryptomus supports Bitcoin (BTC), USDT on TRC20 and ERC20, Ethereum (ETH), Litecoin (LTC), Tron (TRX), and several other cryptocurrencies. The full list is available in the Cryptomus merchant dashboard.

Do customers need a Cryptomus account to pay?
No. Customers simply send the specified amount to the generated wallet address from any compatible wallet. They do not need a Cryptomus account.

Can I accept USDT TRC20 specifically?
Yes. The module supports individual currency configuration. You can enable USDT TRC20 specifically and disable other currencies if preferred — many IPTV customers use USDT TRC20 due to its low transaction fees.

What happens if a customer overpays?
Overpayments are received and the invoice is marked as paid. The excess amount remains in your Cryptomus balance and can be withdrawn or applied to future transactions depending on your configuration.

Is the module compatible with WHMCS 9.x?
Yes. The module is maintained and updated for compatibility with new WHMCS versions. Lifetime updates are included with your license.

Conclusion

The WHMCS Cryptomus H2H payment gateway is one of the most practical additions an IPTV reseller can make to their billing setup in 2026. It eliminates chargeback risk entirely, opens your business to a global customer base that prefers crypto, and automates the complete payment-to-provisioning flow without manual intervention.

Combined with the WHMCS IPTV Stripe Gateway for card payments and the XUI Reseller Panel module for automated provisioning, Cryptomus completes a fully automated IPTV billing stack that runs 24 hours a day without requiring your attention for routine transactions.

Purchase the WHMCS Cryptomus H2H Payment Gateway and explore the full range of WHMCS modules for IPTV resellers at whmcsmodules.net.