![WHMCS Logo](/assets/images/plugins/whmcs.png)

# BlockBee for WHMCS
Accept cryptocurrency payments on your WHMCS billing platform

## Requirements

```
PHP >= 7.4 (with curl, json and openssl extensions)
WHMCS >= 8.0
```

## Download

{% button href="https://github.com/blockbee-io/whmcs-blockbee/releases" variant="default" size="default" %}
Download Plugin
{% /button %}

## Description

Accept payments in Bitcoin, Ethereum, Litecoin, Tron and many other cryptocurrencies and tokens, directly to your crypto wallet.

### Let your customers pay their invoices with crypto

The BlockBee module extends WHMCS, allowing your customers to pay their invoices in cryptocurrency through the secure BlockBee hosted [Checkout](https://pay.blockbee.io/payment/demo/) page. Customers click *Pay Now* on an invoice, choose their coin on the Checkout page, and the invoice is marked as paid automatically as soon as the payment is confirmed. Beyond your API key, there are no keys or wallets to manage in WHMCS.

### Accepted cryptocurrencies & tokens include:

* (BTC) Bitcoin
* (ETH) Ethereum
* (BCH) Bitcoin Cash
* (LTC) Litecoin
* (TRX) Tron
* (BNB) Binance Coin
* (USDT) USDT
* (USDC) USDC
* (SHIB) Shiba Inu
* (DOGE) Dogecoin
* (SOL) Solana

BlockBee supports 100+ cryptocurrencies and tokens.

> **INFO**
>View the complete list [here](https://blockbee.io/cryptocurrencies/).


### Value conversion

Invoices are charged in their own WHMCS currency. The BlockBee Checkout page automatically converts the invoice value to the cryptocurrency your customer chooses, using real-time exchange rates.

**Note:** BlockBee will not exchange your crypto for FIAT or other crypto, just convert the value.

### Why choose BlockBee?

BlockBee has no setup fees, no monthly fees and no hidden costs.
Simply create an API key, set it in the module, and you're ready to go. As soon as your customers pay we forward your earnings directly to your own wallet.

BlockBee has a low 1% fee on the transactions processed. No hidden costs.

> **INFO**
>For more info on our fees [click here](https://blockbee.io/fees/).


## Installation

1. Download the latest `whmcs-blockbee-vX.Y.Z.zip` from the [Releases](https://github.com/blockbee-io/whmcs-blockbee/releases) page
2. Extract the archive into your **WHMCS root directory**. It mirrors the WHMCS folder layout, so the files land exactly where they belong:

```
<whmcs>/modules/gateways/blockbee.php
<whmcs>/modules/gateways/callback/blockbee.php
<whmcs>/modules/gateways/blockbee/…
```

3. All done! There is no database migration step, the module sets itself up automatically.

### Updating

Extract the new release over the existing files, overwriting them. As always, ensure you backup your site just in case.

## Configuration

1. Log in to your WHMCS admin area
2. Go to **Configuration → Apps & Integrations**, select the **Payments** category and choose **BlockBee Cryptocurrency Payments** (on older versions: **Setup → Payments → Payment Gateways**)
3. Activate the gateway
4. Insert your **API Key**. You can create one in our [dashboard](https://dash.blockbee.io/)
5. Click "Save Changes"
6. All done!

The behaviour of the Checkout page itself (payment window, appearance, etc.) is configured in your BlockBee dashboard at [Settings → Checkout](https://dash.blockbee.io/settings/checkout/).

## Frequently Asked Questions

### Do I need an API key?

Yes. To use our service you will need to register at our [dashboard](https://dash.blockbee.io/) and create a new API Key.

### How long do payments take before they're confirmed?

This depends on the cryptocurrency your customer uses. Bitcoin usually takes up to 11 minutes, Ethereum usually takes less than a minute.

### How does WHMCS know an invoice was paid?

BlockBee notifies your WHMCS installation through a cryptographically signed webhook. The module verifies the RSA signature against BlockBee's public key, matches the notification to the exact checkout session it created, and only then records the payment. Duplicates and forgeries are rejected automatically.

### Does the module support refunds?

No. Cryptocurrency payments are not reversible, so WHMCS' "Refund through gateway" option stays disabled for BlockBee transactions. Refunds, if you choose to give them, are manual payouts handled outside WHMCS.

### Is there a minimum for a payment?

Yes, the minimums change according to the chosen cryptocurrency and can be checked [here](https://blockbee.io/fees/).

> **INFO**
>**Where can I get support?** The easiest and fastest way is via our live chat on our [website](https://blockbee.io) or via our [contact form](https://blockbee.io/contacts/).


## Changelog

### 1.0.0
* Initial release.