Description
Cryptocurrency Payment Automation
BTCPay Integration for WHMCS
BTCPay Integration for WHMCS connects your billing platform with BTCPay Server, allowing customers to pay WHMCS invoices using Bitcoin and other payment methods enabled in your BTCPay store.
The module creates a secure hosted payment invoice, redirects the customer to BTCPay Server, and automatically updates the corresponding WHMCS invoice after a verified payment notification is received.
Control Your Crypto Checkout
Process payments through a self-hosted or compatible hosted BTCPay Server instead of depending on a traditional custodial cryptocurrency processor. This gives your business greater control over payment infrastructure, wallet configuration, privacy, and settlement.
Core Features
- Hosted BTCPay Checkout: Creates a BTCPay invoice and securely redirects customers to its payment page.
- Automatic WHMCS Updates: Applies successful payments to the correct WHMCS invoice after confirmation.
- Verified Callbacks: Validates payment notifications and retrieves invoice details from BTCPay Server before processing them.
- Configurable Transaction Speed: Choose low, medium, or high transaction-speed settings according to your confirmation requirements.
- Currency Conversion: Supports WHMCS gateway currency conversion when a conversion currency is configured.
- Tor Server Support: Configure a separate BTCPay Server onion URL for WHMCS installations accessed through Tor.
- Customer Details Transfer: Passes relevant invoice and billing details to BTCPay Server for a consistent checkout flow.
- Secure API Communication: Uses authenticated server requests with SSL certificate and hostname verification.
Reliable Payment Status Handling
The integration recognizes BTCPay payment states and processes an invoice only after the required confirmation stage has been reached. Paid, confirmed, complete, expired, and invalid events are recorded through WHMCS gateway logs for easier monitoring.
Duplicate transaction validation helps prevent the same BTCPay transaction from being applied more than once.
Customer Payment Experience
- Select BTCPay from the available WHMCS payment methods.
- Continue to a dedicated BTCPay Server invoice.
- Pay using the cryptocurrency or payment network enabled by the merchant.
- Return to the configured website page after completing checkout.
Why Choose This Module?
- Greater Payment Control: Connect WHMCS to your own BTCPay Server and wallet setup.
- Reduced Processor Dependence: Accept peer-to-peer crypto payments without a traditional payment intermediary.
- Automated Reconciliation: Update WHMCS invoices automatically after verified payment confirmation.
- Flexible Payment Options: Available currencies and Lightning support depend on your BTCPay store configuration.
- Transparent Costs: BTCPay Server does not impose a payment-processing fee, although blockchain network and infrastructure costs may apply.
Ideal For
- Web hosting and cloud service providers
- SaaS and digital subscription businesses
- International service providers
- Privacy-focused businesses
- Merchants already operating a BTCPay Server
Integration Requirements
A working BTCPay Server store and Legacy API key are required. This integration communicates with BTCPay Server’s Legacy API invoice endpoint, so Legacy API compatibility must be available on the connected server.
Bring Independent Crypto Payments to WHMCS
BTCPay Integration for WHMCS provides a practical way to accept cryptocurrency through your chosen BTCPay infrastructure while keeping invoice creation, payment confirmation, and transaction logging connected to your WHMCS billing workflow.




