WHMCS

Add Bitcoin (BTC) and Bitcoin Cash (BCH) as payment gateways in WHMCS.

Prerequisites

• WHMCS installed and running
• A Blockonomics account
• A Bitcoin wallet with an xPub key (wallet guide)

---

BTC setup

1. Download the Blockonomics WHMCS module

   Download the latest release from the Blockonomics GitHub and unzip it.

2. Upload to your WHMCS server

   Copy the blockonomics folder into your WHMCS modules/gateways/ directory.

3. Activate the gateway in WHMCS

   1. Log into your WHMCS admin panel
   2. Go to Setup → Payment Gateways
   3. Click All Payment Gateways and find Blockonomics Bitcoin
   4. Click Activate
4. Configure your API key

   1. Go to Dashboard → Stores in Blockonomics and copy your API key
   2. Back in WHMCS, paste it into the API Key field
   3. Click Save Changes
5. Add your wallet and create a store

   Follow the wallet setup and store setup steps if you haven’t already. Use the WHMCS Callback URL shown in the gateway settings as your store’s callback URL.

6. Test the setup

   Place a test order in WHMCS and select Bitcoin as the payment method to verify everything is working end-to-end.

---

BCH setup

1. Install the BCH module

   Download the BCH module from the Blockonomics GitHub and copy the blockonomicsbch folder into modules/gateways/.

2. Activate in WHMCS

   Go to Setup → Payment Gateways → All Payment Gateways, find Blockonomics Bitcoin Cash, and activate it.

3. Configure your BCH wallet

   Add a BCH wallet in Dashboard → Wallets using your BCH wallet address (not xPub).

4. Link wallet to your WHMCS store

   In your Blockonomics store, enable Bitcoin Cash and select your BCH wallet.

---

FAQ

How do I set mBTC as my currency?

In your WHMCS Blockonomics gateway settings, find the Currency field and select mBTC from the dropdown. This displays prices in millibitcoin (1 mBTC = 0.001 BTC), which can feel more familiar for smaller amounts.

Invoices are not being marked paid — how do I fix this?

Check that your WHMCS server is publicly accessible and that the callback URL in your Blockonomics store matches exactly what’s shown in your gateway settings. See Callbacks failing → for a full debugging guide.

Can I run BTC and BCH gateways at the same time?

Yes — they are separate gateway modules and can both be active simultaneously in WHMCS.