![PrestaShop Logo](/assets/images/plugins/prestashop.png)

# BlockBee for PrestaShop
Accept cryptocurrency payments on your PrestaShop website

## Requirements

```
PHP >= 7.4  (or whatever your PrestaShop version requires — PS 9 needs PHP 8.1+)
PrestaShop >= 1.7  (tested on 8.x and 9.x)
```

## Download

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

## Description

Accept payments in Bitcoin, Bitcoin Cash, Litecoin, Ethereum, USDT and Polygon directly to your crypto wallet.

### Allow users to pay with crypto directly on your store

The BlockBee module enables your PrestaShop store to receive payments in cryptocurrency, with a simple setup.

Since version 2.0.0 the module is built on top of BlockBee Checkout Payments: customers are redirected to the secure BlockBee hosted [Checkout](https://pay.blockbee.io/payment/demo/) page to choose their coin and pay, and the order is updated automatically once BlockBee confirms the payment through a signature-verified webhook.

### Accepted cryptocurrencies & tokens include:

BlockBee supports 100+ cryptocurrencies and tokens.

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


### Auto-value conversion

BlockBee module will attempt to automatically convert the value you set on your store to the cryptocurrency your customer chose.
Exchange rates are fetched every 5 minutes.

### Supported currencies for automatic exchange rates are:

* (USD) US Dollar
* (EUR) Euro
* (GBP) GB Pound
* (CAD) Canadian Dollar
* (CHF) Swiss Franc
* (JPY) Japanese Yen
* (AED) UAE Dollar
* (DKK) Danish Krone
* (BRL) Brazilian Real
* (CNY) Chinese Yuan
* (HKD) Hong Kong Dollar
* (INR) Indian Rupee
* (MXN) Mexican Peso
* (UGX) Uganda Shillings
* (PLN) Poland Zloti
* (PHP) Philippine Peso
* (CZK) Czech Koruna
* (HUF) Hungarian Forint
* (BGN) Bulgarian Lev
* (RON) Romanian Leu
* (ZAR) South African Rand
* (LKR) Sri Lankan Rupee
* (TRY) Turkish Lira
* (THB) Thai Baht
* (RUB) Russian Ruble
* (IDR) Indonesian Rupiah
* (MYR) Malaysian Ringgit
* (SGD) Singapore Dollar
* (TWD) New Taiwan Dollar
* (AUD) Australian Dollar
* (NGN) Nigerian Naira
* (SEK) Swedish Krona
* (NOK) Norwegian Krone
* (UAH) Ukrainian Hryvnia
* (VND) Vietnamese Dong

If your PrestaShop's currency is none of the above, the exchange rates will default to USD.
If you're using PrestaShop in a different currency not listed here and need support, [contact us](https://blockbee.io/contacts/) via our live chat.

**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

### Uploading in Prestashop Dashboard

1. Navigate to the 'Module Manager' in the PrestaShop dashboard
2. Click the 'Upload a Module' button
3. Select `prestashop-blockbee.zip` from your computer

### Using FTP

1. Download `prestashop-blockbee.zip`
2. Extract the `prestashop-blockbee` directory to your computer
3. Upload the `prestashop-blockbee` directory to the `/your-store/modules/` directory
4. Activate the module in the `Module Catalog` dashboard and then configure it.

## Configuration

1. Go to Prestashop dashboard
2. Select the "Modules" tab and click "Module Manager"
3. Search for "BlockBee" and click "configure" in our module
4. Set **Enabled** to yes to activate the payment method
5. Set the **Checkout title** you wish to show your users on Checkout (for example: "Cryptocurrency")
6. Paste your **API key** in the API key field. You can create one in our [dashboard](https://dash.blockbee.io/)
7. Click "Save"
8. All done!

Which cryptocurrencies your customers can pay with, and the behaviour of the Checkout page itself, are configured in your BlockBee dashboard at [Settings → Checkout](https://dash.blockbee.io/settings/checkout/).

> **INFO**
>**No cronjob needed.** Versions 1.x required a cronjob for value conversion and order cancellation. Since 2.0.0 these are handled by BlockBee Checkout, so you can remove any cronjob entry you previously set up.


## Tutorial

### Installing BlockBee Module in PrestaShop

Our PrestaShop Module allows you to get paid in all our supported cryptocurrencies in your PrestaShop Store, with a simple set-up. First you need to create an account.

In this page we will guide you throughout the configuration and installation of our official PrestaShop Module.

#### Step 1: Download and Access Admin Area

1. Download our PrestaShop Module and access your PrestaShop store's admin area. Click in Modules to open a dropdown menu.

![PrestaShop Step 1](/assets/images/tutorials/prestashop/prestashop_screen_1.png)

#### Step 2: Access Module Manager

2. In the dropdown menu click Module Manager.

![PrestaShop Step 2](/assets/images/tutorials/prestashop/prestashop_screen_2.png)

#### Step 3: Upload Module

3. After clicking Module Manager you will enter a new screen where you must click Upload a module.

![PrestaShop Step 3](/assets/images/tutorials/prestashop/prestashop_screen_3.png)

#### Step 4: Select File

4. You can either drop the zip file in the modal's red area or click "select file" to pick from your file system.

![PrestaShop Step 4](/assets/images/tutorials/prestashop/prestashop_screen_4.png)

#### Step 5: Complete Installation

5. Once the installation is completed, click Configure.

![PrestaShop Step 5](/assets/images/tutorials/prestashop/prestashop_screen_5.png)

#### Step 6: Activate Module

6. First, you need to activate the Module. You can configure the rest of the settings to fit your needs.

![PrestaShop Step 6](/assets/images/tutorials/prestashop/prestashop_screen_6.png)

#### Step 7: Configure your API Key

7. Set the **Checkout title** your customers will see, then paste the **API key** you obtained from your BlockBee Dashboard.

Your customers choose which cryptocurrency to pay with on the BlockBee Checkout page, so there is nothing to select here. Configure the coins you accept in your BlockBee dashboard under [Settings → Checkout](https://dash.blockbee.io/settings/checkout/).

#### Step 8: Save Configuration

8. Finally check again your settings and make sure you hit Save before closing the page.

## 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 you're using. Bitcoin usually takes up to 11 minutes, Ethereum usually takes less than a minute.

### Is there a minimum for a payment?

Yes, the minimums change according to the chosen cryptocurrency and can be checked [here](https://blockbee.io/cryptocurrencies/).
If the PrestaShop order total is below the chosen cryptocurrency's minimum, an error is raised to the user.

> **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.

### 1.1.0
* Support for Prestashop 8
* Minor bugfixes

### 1.1.1
* Minor bugfixes

### 1.1.2
* Minor bugfixes

### 1.1.3
* Add new choices for order cancellation.

### 2.0.0
* Rewrite on top of BlockBee Checkout Payments — customers are now redirected to `pay.blockbee.io` to pay
* Webhook signature verification added
* PrestaShop 8 and 9 compatibility
* Cronjob no longer needed

### 2.1.1
* Bugfixes and security hardening

### Upgrade Notice
* 2.0.0 contains breaking changes (architecture rewrite). Cancel pending 1.x orders and remove any cronjob entry before upgrading.