Bitcoin for WP e-Commerce shopping cart for WordPress

27 November 2010 by Mike Gogulski
Posted in software | 15 Comments »

Bitcoin for WP e-Commerce

We accept BitcoinA Bitcoin payment method for the WP e-Commerce shopping cart for WordPress.

Version: 0.9.0

Download forum topic
Github repository


  • Generates a new bitcoin address for every order
  • Provides payment address to customer on site at checkout, plus in a subsequent email
  • Configurable timeout after which unpaid transactions will be canceled automatically
  • Configurable number of Bitcoin network confirmations after which an order is considered paid
  • HTTP or HTTPS access to bitcoind


Base requirements

  • WP e-Commerce 3.7.7 or greater
  • WordPress 3.0 or greater (may work on 2.8+, untested)

PHP requirements:

  • PHP5
  • cURL support
  • SSL support (if you’re using HTTPS to talk to bitcoind)


  • It is assumed that Bitcoin is the only currency accepted.
  • All prices are assumed to be in Bitcoins, and no currency conversions are performed.
  • Checks for payment receipt are performed via WordPress cron, at least until bitcoind allows attaching a JSON-RPC callback to an address.
  • No notification is sent to the customer or shop administrator if a transaction expires without payment.
  • Expired transactions are marked with a status code of “5” in the database, which doesn’t correspond to a human-readable status code provided by WP e-Commerce.
  • No localization support.


  • Install WordPress
  • Log into your WordPress installation as an administrator.
  • Install WP e-Commerce via Plugins->Add New in the WordPress dashboard.
  • Transfer the contents of the distribution archive to the wp-content/plugins/wp-e-commerce directory of your WordPress installation.


  • Navigate to Store->Settings->Payment Options.
  • Under “General Settings”, check “Bitcoin” and uncheck everything else.
  • Click “Update”
  • At right, Select the Bitcoin payment gateway.
  • Configure your bitcoind server information.
  • If you are using HTTPS to talk to bitcoind and would like to validate the connection using bitcoind’s own SSL certificate, enter the absolute path to the certificate file (server.cert) you’ve uploaded to the server.
  • Configure your payment timeout and number of transaction confirmations required.
  • Adjust the checkout message template as required.
  • Click “Update”.
  • Click “General” at the top and set the currency type to “Bitcoin”.
  • Set the remaining parameters as you wish and click “Update”.




Bitcoin for WP e-Commerce incorporates code from:


Bitcoin for WP e-Commerce is free and unencumbered public domain software. For more information, see or the accompanying UNLICENSE file.

  1. 15 Responses to “Bitcoin for WP e-Commerce shopping cart for WordPress”

  2. By Tim on 5 May 2011

    “Configure your bitcoind server information”

    I’m a newb. How do I ascertain this?


  3. By Mike Gogulski on 5 May 2011

    You’ll need to create a bitcoin.conf file the necessary details, then copy those into the corresponding settings in the plugin.

    bitcoin.conf documentation is here:

  4. By Tim on 5 May 2011

    Cool. Thank Mike.

  5. By bearbones on 21 May 2011

    I do believe you’ve neglected a step in these instructions. I followed your installation instructions through, and was blocked on step one of configuration. Bitcoin is not installed as a currency.

    I see that the form_bitcoin() function installs bitcoin currency support. I have not investigated closely enough, yet, to tell whether this function should have been called at some point in the installation process, but it is apparent that in my case it has not. If anyone else has this problem, it can be remedied by manually adding bitcoin to the currency list. In my installation, the SQL command for this was:

    INSERT INTO wp_wpsc_currency_list VALUES (NULL, 'Bitcoin', 'BC', 'Bitcoin', '', '', 'BTC', '0', '0', 'antarctica', '1');

  6. By Mike Gogulski on 1 June 2011

    @bearbones: That’s odd. The code is:

    00262 // Create the Bitcoin currency if it doesn't already exist
    00263 $sql = "SELECT currency FROM " . WPSC_TABLE_CURRENCY_LIST . " WHERE currency='Bitcoin'";
    00264 if (!$wpdb->get_row($sql)) {
    00265 $sql = "INSERT INTO " . WPSC_TABLE_CURRENCY_LIST . " VALUES (NULL, 'Bitcoin', 'BC', 'Bitcoin', '', '', 'BTC', '0', '0', 'antarctica', '1')";
    00266 $wpdb->query($sql);
    00267 }

    I don’t see an SQL error there. What versions of WP, WP-e-commerce and PHP are you using?

  7. By Dave on 14 June 2011

    Urm… I have wp-e-commerce 3.8.4 and the insert made things good(-ish). I still don’t have an option to enable the bitcoin checkout.

    Should we be trying to get a copy of 3.7.7? I don’t see an easy way to fetch that.

  8. By Matt on 19 June 2011

    It doesn’t work with the latest versions of Word Press. I also had to use wp e-commerce 3.8.7 to get the features to load and that barely worked. It needs a BTC bounty for a refresh of the code, otherwise someone has to take it upon themself to rewrite it.

  9. By Dave on 22 June 2011

    I’ll throw a bounty of 10 BTC on this… ie: working with the latest version of wp-e-commerce and the latest version of wordpress.

  10. By Sage on 25 June 2011

    I’m getting error, “INVALID HEADER INFORMATION” when trying to install this plugin.

    I’m using the latest version of wordpress if that matters.

    Anyone solved this problem?

  11. By edd on 30 July 2011

    Sage, that error usually means a blank line at the beginning or end of the php file. Remove it and you should be fine.

  12. By Robbie on 16 May 2012

    Is there a latter version of Bitcoin for WP e-Commerce or does anyone have a WordPress plugin that just retrieve the next unused bitcoin address from the database and displays it to the customer. If not I am willing to pay for development of such.

  13. By ganesh on 24 May 2012

    Should we be trying to get a copy of 3.7.7? I don’t see an easy way to fetch that.

  14. By Alistair on 26 March 2013

    It would be great to make this plugin work as a payment option. Is that part of the plan?

  1. 2 Trackback(s)

  2. 27 April 2013: Bitcoins Beat the Bankers – Webs First Peer-to-Peer Bitcoin Crypto Currency Empowers Users, May Replace Banks | wine making
  3. 22 June 2013: Bitcoin for WP e-Commerce for WordPress | Volcano blog'as

    comments rss Comments RSS

Sorry, comments for this entry are closed at this time.

  • Categories

  • Archives

  • Core Dogma