![WooCommerce Logo](/assets/images/plugins/woocommerce.png)

# CryptAPI Payment Gateway for WooCommerce
Accept cryptocurrency payments on your WooCommerce website

## Requirements

```
PHP >= 7.2
Wordpress >= 5.8
WooCommerce >= 5.8
```

## Description

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

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

The CryptAPI plugin extends WooCommerce, allowing you to get paid in crypto directly on your store, with a simple setup.

### Accepted cryptocurrencies & tokens include:

CryptAPI supports 100+ cryptocurrencies and tokens.

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


### Auto-value conversion

CryptAPI plugin 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 WooCommerce's currency is none of the above, the exchange rates will default to USD.
If you're using WooCommerce in a different currency not listed here and need support, please [contact us](https://cryptapi.io) via our live chat.

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

### Why choose CryptAPI?

CryptAPI has no setup fees, no monthly fees, no hidden costs, and you don't even need to sign-up!
Simply set your crypto addresses and you're ready to go. As soon as your customers pay we forward your earnings directly to your own wallet.

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

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


## Installation

### Using The WordPress Dashboard

1. Navigate to the 'Add New' in the plugins dashboard
2. Search for 'CryptAPI Payment Gateway for WooCommerce'
3. Click 'Install Now'
4. Activate the plugin on the Plugin dashboard

### Uploading in WordPress Dashboard

1. Navigate to the 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `woocommerce-cryptapi.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard

### Using FTP

1. Download `woocommerce-cryptapi.zip`
2. Extract the `woocommerce-cryptapi` directory to your computer
3. Upload the `woocommerce-cryptapi` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard

### Updating

Automatic updates should work like a charm; as always though, ensure you backup your site just in case.

## Configuration

1. Go to WooCommerce settings
2. Select the "Payments" tab
3. Activate the payment method (if inactive)
4. Set the name you wish to show your users on Checkout (for example: "Cryptocurrency")
5. Fill the payment method's description (for example: "Pay with cryptocurrency")
6. Select which cryptocurrencies you wish to accept (control + click to select many)
7. Input your addresses to the cryptocurrencies you selected. This is where your funds will be sent to, so make sure the addresses are correct.
8. Click "Save Changes"
9. All done!

## Tutorial

### Installing CryptAPI Plugin in WooCommerce

The CryptAPI plugin extends WooCommerce, allowing you to get paid in crypto directly on your Store, with a simple setup and no sign-ups required.

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

#### Step 1: Access Plugins

1. First you need to have WooCommerce installed. Then you go to "Plugins".

![WooCommerce Step 1](/assets/images/tutorials/woocommerce/woocommerce_screen_1.png)

#### Step 2: Add New Plugin

2. In the Plugins page click the Add New button.

![WooCommerce Step 2](/assets/images/tutorials/woocommerce/woocommerce_screen_2.png)

#### Step 3: Search and Install

3. Type "CryptAPI" in the search input and when our plug-in appear in the search result, click Install Now. Then just wait for WordPress to finish installing it.

![WooCommerce Step 3](/assets/images/tutorials/woocommerce/woocommerce_screen_3.png)

#### Step 4: Activate Plugin

4. When WordPress finish installing CryptAPI plug-in, click Activate.

![WooCommerce Step 4](/assets/images/tutorials/woocommerce/woocommerce_screen_4.png)

#### Step 5: Access WooCommerce Settings

5. Then go to WooCommerce and click the Settings link.

![WooCommerce Step 5](/assets/images/tutorials/woocommerce/woocommerce_screen_5.png)

#### Step 6: Navigate to Payments

6. In the WooCommerce Settings page click in the Payments button.

![WooCommerce Step 6](/assets/images/tutorials/woocommerce/woocommerce_screen_6.png)

#### Step 7: Setup CryptAPI

7. Here you will have to scroll to "CryptAPI Cryptocurrency Payment Gateway" and click Finish set up. This action will take you into the plugin settings where you will finish the configuration.

![WooCommerce Step 7](/assets/images/tutorials/woocommerce/woocommerce_screen_7.png)

#### Step 8: Configure API Key

8. Make sure the checkbox it's selected, to enable CryptAPI plugin and that you get a valid API Key from our dashboard and paste it in the "API Key" field. This is mandatory, failing to do it so will result in the plug-in to error out when trying to make an order.

You can also play around the settings a bit to make our WooCommerce plug-in fit your needs.

![WooCommerce Step 8](/assets/images/tutorials/woocommerce/woocommerce_screen_8.png)

#### Step 9: Select Cryptocurrencies

9. Finally you must select the cryptocurrencies you want to accept in your WooCommerce store. You must make sure your wallet address set in the dashboard, otherwise plug-in will fail to make orders.

**Note:** You can select multiple ones with CTRL + click on Windows, or CMD + click on MAC.

## Frequently Asked Questions

### Do I need an API key?

No. You just need to insert your crypto address of the cryptocurrencies you wish to accept. Whenever a customer pays, the money will be automatically and instantly forwarded to your address.

### 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://cryptapi.io/cryptocurrencies).
If the WooCommerce 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://cryptapi.io) or via our [contact form](https://cryptapi.io/contacts/).


## Changelog

### 1.0
* Initial release.

### 2.0
* New coins
* Updated codebase
* New API URL

### 3.0
* UI Improvements
* Minor Bug Fixes

### 3.0.2
* New setting to show QR Code by default
* UI Improvements
* Minor Bug Fixes

### 3.1
* Add support for WooCommerce Subscriptions plugin
* Add new feature to refresh values based on store owner preferences
* Add new feature to cancel orders if they take more than selected time to pay

### 3.2
* Add support for WooCommerce Subscriptions plugin
* Add new feature to refresh values based on store owner preferences
* Add new feature to cancel orders if they take more than selected time to pay

### 3.2.1
* Add translations for multiple languages

### 4.0
* New settings and color schemes to fit dark mode
* New settings to add CryptAPI's services fees to the checkout
* New settings to add blockchain fees to the checkout
* Upgrade the settings
* UI Improvements
* Minor fixes

### 4.0.1
* Minor fixes

### 4.0.2
* Minor fixes

### 4.0.3
* Minor fixes

### 4.0.4
* Minor fixes

### 4.0.5
* UI Improvements

### 4.0.6
* Disable QR Code with value in certain currencies due to some wallets not supporting it

### 4.0.7
* Minor fixes

### 4.1
* Added a history of transactions to the order payment page
* Better handling of partial payments
* Minor fixes
* UI Improvements

### 4.2
* Improved algorithm
* Minor fixes
* UI Improvements

### 4.2.1
* Minor fixes

### 4.2.2
* Minor fixes

### 4.2.3
* Minor fixes

### 4.2.4
* Minor fixes

### 4.3
* Improve calculations
* Minor fixes

### 4.3.1
* Minor fixes

### 4.3.2
* Minor fixes

### 4.3.3
* Minor fixes

### 4.3.4
* Feature to enable marking virtual products order as completed instead of processing
* Minor fixes

### 4.4
* Support CryptAPI Pro
* Minor fixes

### 4.4.1
* Minor fixes

### 4.4.2
* Minor fixes

### 4.4.3
* Minor fixes

### 4.4.3
* Minor fixes
* Improved algorithm

### 4.5.0
* Minor fixes
* Improved algorithm
* Added cryptocurrencies logos to the checkout

### 4.5.1
* Minor fixes

### 4.5.2
* Minor fixes

### 4.6.0
* New BlockBee API Url
* Minor fixes

### 4.6.1
* Minor fixes

### 4.6.2
* New mechanisms to detect callbacks even if they fail
* Minor fixes
* Added new languages

### 4.6.3
* Minor fixes

### 4.6.4
* Minor fixes

### 4.6.5
* Added option to check for failed callbacks
* Minor fixes

### 4.6.6
* Minor fixes

### 4.6.7
* Minor fixes

### 4.6.8
* Minor fixes

### 4.6.9
* Minor fixes

### 4.7.0
* Minor fixes
* Improvements on the callback processing algorithm

### 4.7.1
* Minor fixes
* Improvements on the callback processing algorithm

### 4.7.2
* Minor fixes

### 4.7.3
* Minor fixes

### 4.7.4
* Minor fixes

### 4.7.5
* Minor fixes

### 4.7.6
* Performance improvements
* Minor fixes

### 4.7.7
* Minor fixes

### 4.7.8
* Minor fixes

### 4.7.9
* Support for WooCommerce HPOS.
* Minor fixes

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

### 4.7.11
* Minor fixes and improvements

### 4.7.12
* Minor fixes and improvements

### 4.8.0
* Support for new languages: German, French, Ukrainian, Russian and Chinese.

### 4.8.1
* Minor fixes and improvements

### 4.8.2
* Minor fixes and improvements

### 4.8.3
* Minor improvements

### 4.8.4
* Minor improvements

### 4.8.5
* Minor improvements

### 4.8.6
* Minor improvements

### 4.8.7
* Minor fixes
* Minor improvements

### 4.8.8
* Minor fixes
* Minor improvements

### 5.0.0
* Now supports WordPress Blocks.
* Bug fixes.

### 5.0.1
* Bug fixes.

### 5.0.2
* Bug fixes.

### 5.1.0
* Callback improvements
* Minor bugfixes

### 5.1.1
* Callback improvements

### 5.1.2
* Minor bugfixes

### 5.1.3
* Minor bugfixes

## Upgrade Notice
### 4.3
* Please be sure to enable the PHP extension BCMath before upgrading to this version.