FAQ – Frequently Asked Questions

CryptoWoo enables merchants to accept Bitcoin, Litecoin and Dogecoin payments in their WooCommerce store. It gives merchants more control over the checkout process, their customer data, and their private keys.

The CryptoWoo HD Wallet add-on not only enables a way to receive the store payments directly to your own HD wallet, it also adds support for accepting additional cryptocurrencies via add-ons.

We are offering custom add-on development to integrate cryptocurrencies into CryptoWoo. Click here to request a personalized quote

The yearly cost for the plugin license is all we charge to provide updates and support.

Some premium features offered by the supported services such as exchange rate providers may require a paid account.

Please contact us if you want to find out if a specific feature is supported by CryptoWoo and refer to the websites of the respective provider to learn about any charges that may apply.

Of course, if you expect large sales volume there is also the option to connect CryptoWoo to your own Esplora or Insight API instance to process the payments.

CryptoWoo does not offer currency conversions. The benefits of this approach are that there is no percentage cut taken from your revenue and that you have more control over the checkout process as well as your own and your customers’ data. This caters especially to merchants that don’t need instant currency conversion to their national currency and/or want to keep and accumulate digital currencies. Use the Block.io forwarding address feature to instantly forward your sales revenue to addresses of your choice.

The main plugin supports manually adding addresses to a list or using the Block.io API & wallet service. Read more about security at Block.io.

Our HD wallet add-on enables you to derive virtually unlimited addresses directly from your own HD wallet without any middlemen between you and your customers.

If you want to reduce the influence of third parties even further you can connect CryptoWoo to your self-hosted Esplora or Insight API instance to process the payments instead of using the supported public block explorer APIs.

You can choose between different API providers or run your own block explorer such as Esplora or Insight API

Our HD Wallet Add-on is not a full wallet itself, you can think of it as a kind of “watch-only wallet”. It enables the CryptoWoo main plugin to use HD wallets as source of Bitcoin addresses. To know which addresses to derive, the HD Wallet Add-on needs an input (the extended public key “xpub”) from your actual Bitcoin wallet (Electrum, Trezor, Ledger, etc.). The CryptoWoo main plugin then assigns every new WooCommerce order a unique address that is derived from your wallet.

One major benefit of not having a full wallet on your webserver is that the coins are safe even if the server gets hacked. Since the server does not have access to the private keys, the hacker can not send any transactions.

Your webshop is only displaying a Bitcoin address like it would display the routing details for a bank account when accepting bank transfers. The payments from the customer go directly from their wallet into the wallet on your PC (Electrum) or hardware wallet (Trezor, Ledger).

The HD Wallet Add-on works with public keys created with all BIP 32/39/44 compliant wallets.

Non-exhaustive list of compatible wallets:

  • Electrum
  • Electrum-LTC
  • Electrum-DASH (Dash add-on required)
  • Coinomi
  • Mycelium
  • Trezor
  • Ledger Wallet

In order to use CryptoWoo, you need to have the e-commerce plugin WooCommerce installed on your WordPress blog.

The plugin also requires at least PHP version 5.6 with the extensions GMP and cURL. Use our Requirements Check plugin to find out if your server is ready to use CryptoWoo.

You should also be able to set up external cronjobs via cPanel or the commandline program crontab. More info: https://www.lucasrolff.com/wordpress/why-wp-cron-sucks/

If you’re worried about hosting compatability then we have teamed up with our sister company to provide hosting that is fully compatible at https://www.gomach5.com/cryptowoo/

Most shared hosting providers usually meet the minimum requirements for CryptoWoo to run but you should always check with the hosting providers support. If you are looking for a hosting provider that works out the box with CryptoWoo then our sister company, Go Mach 5, will be happy to provide a solution. You can read about their CryptoWoo optimised hosting here: https://www.gomach5.com/cryptowoo/

We get this question a lot so we created a guide in conjunction with our sister company, Go Mach 5. You can read about how to correctly replace and setup real cron jobs here

CryptoWoo supports all versions above WooCommerce 3.0 and WordPress 4.3. Our scheduled updates ensure support for future WordPress and WooCommerce versions.

Users with WooCommerce versions below 2.7 can download a compatible version of CryptoWoo from their account dashboard.

  1. Install and activate the plugin via the WordPress installation routine.
  2. Enter wallet addresses or extended public keys for the currencies you want to accept in your store.
  3. Follow the instructions in the plugin settings area to set up the required cronjobs.
  4. Set the “Enable WooCommerce Checkout Gateway” switch to “On”.

Click here for a more detailed installation tutorial

Don’t hesitate to contact us if you are experiencing any issues. We will be glad to help.

Yes. CryptoWoo caters especially to merchants that want to keep and accumulate digital currencies. For the best choice in preferred exchanges, price your products in their US Dollar value and disable all other payment methods under WooCommerce > Settings > Checkout. CryptoWoo will keep track of the exchange rate from your preferred exchange and charge your customers accordingly.

Yes. You are free to choose which currencies you want to accept in your store. Just remove the extended public key (or wallet service API key) from the settings to disable a currency.

Bitcoin, Dogecoin and Litecoin are natively supported by the CryptoWoo main plugin. For direct acceptance of DASH, Bitcoin Cash or any of the other supported currencies you need our HD wallet add-on. Of course, the HD wallet add-on can also be used to receive Bitcoin, Dogecoin, or Litecoin payments without any intermediary steps. If you want to accept payments in more cryptocurrencies you need the respective add-on for that currency.

See the list of the other cryptocurrency add-ons here: CryptoWoo Add-ons

We currently support all WooCommerce currencies except Lao Kip as base currency. However, due to the limitations of the available exchange rate APIs we recommend using US Dollar as store currency for a wider selection of preferred exchanges to choose from.

If the exchange rates are not updated in the interval you have set in the checkout options, there could be a problem with the default WordPress cron service. Check if you are able to update the exchange rates manually on the database actions page (yourwebsite.com/wp-admin/admin.php?page=cryptowoo_database_maintenance). Read more about troubleshooting WordPress cron issues.

Read more about PHP version issues related to the cron job.

The testnet is an alternative Bitcoin block chain, to be used for testing. Testnet coins are separate and distinct from actual bitcoins, and are never supposed to have any value. This allows application developers or bitcoin testers to experiment, without having to use real bitcoins or worrying about breaking the main bitcoin chain.
You can get some testnet coins at the following faucets:

Block explorers

Source: https://en.bitcoin.it/wiki/Testnet

This error message means that there is an issue with your PHP version. Please make sure to use at least PHP7.0 or higher. You can verify the PHP version of your WooCommerce installation under WooCommerce > Status > System Status > Server environment.

Please note: In some cases this error is triggered during the execution of the cron job. The PHP version used in a server cron job can be different from the PHP version used by your webserver. Please make sure your server cron job uses at least PHP7.0 or higher or use the alternative cron job command that starts with “wget” instead of the default command.

If your token is not listed on CoinGecko, you will need to supply merchants with the exchange rate. This is done by a JSON-encoded file placed somewhere on your server.

The required format is:

{"symbol":"TOKEN","price_usd":"3.50","last_updated":1588095629}

symbol The official symbol of your token.
price_usd The price of your token in US Dollar.
last_updated The Unix timestamp when your exchange rate for that token was last updated.

If you have several custom tokens you can put them in a new file.

If you want to use a fixed rate please enter “fixed” as Exchange rate URL and add the Token/USD exchange rate in the “Additional comments” field.

To receive all ETH and ERC-20 payments to the same ETH address, enter the address in the Wallet Settings > Other > Ethereum and Token Fallback Address section and leave the Wallet Settings > Address List section empty.

Note that if the fallback address is used for an order, the customer needs to send the exact amount of ETH or tokens so the plugin can identify which payment is meant for which order.

Yes, please contact us if you are interested in any custom development. We may even be able to help you if you are using something other than WooCommerce.

Edit files in an upgrade-safe way using overrides. Copy the file cryptowoo/includes/payment.php into a directory within your theme named /cryptowoo.

Original file: wp-content/plugins/cryptowoo/includes/payment.php

Custom file: wp-content/themes/$YOURTHEME/cryptowoo/payment.php

The copied file will now override the default payment page template file.

Warning: Do not edit the file within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost.

Receiving payments is supported but since cryptocurrencies use a “push” mechanism instead of “pull” like for example with credit cards, the customer must go through the checkout and make a new payment to renew the subscription.

Read more about manual renewals here: https://docs.woocommerce.com/document/subscriptions/renewal-process/#section-4

To enable the CryptoWoo gateway for subscription products you need to accept manual renewals:

1. Go to: WooCommerce > Settings > Subscriptions.
2. Select the Accept Manual Renewals option (see screenshot below).

See also: https://docs.woocommerce.com/document/subscriptions/store-manager-guide/#renewal-settings

Add the following CSS rule to change the icon color and the button background:

[id^="cwhd-connect-trezor-"] {
 background-color: black;
 color: white !important;
}