uc_bitcoin

A Bitcoin payment method for the Ubercart shopping cart for Drupal.

Version: @@uc_bitcoin-version@@

Features

• 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

Requirements

Base requirements

• Ubercart 2.x
• Drupal 6.x

PHP requirements:

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

Limitations

• 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 Drupal cron, at least until bitcoind allows attaching a JSON-RPC callback to an address.
• Orders for downloadables are not tagged as "shipped" once paid.
• No localization support.

Installation

• Install Drupal 6 http://drupal.org/documentation/install.
• Install Ubercart 2 http://www.ubercart.org/docs/user/8075/installing_ubercart.
• Transfer the contents of the distribution archives to the modules/ directory of your Drupal installation.

Configuration

• Log into your Drupal installation as an administrator.
• Navigate to Administer->Site building->Modules and enable the Bitcoin module
• Navigate to Administer->Store administration->Configuration->Payment settings
• Click "Edit" at top, then "Payment methods"
• Enable the Bitcoin payment method and disable all others
• Expand the "Bitcoin settings" dropdown and proceed as follows:
  • 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.
  • Save configuration.
• Navigate to Administer->Store administration->Configuration->Store settings
• Clik "Edit", then "Format settings"
• Expand the "Currency format" dropdown
• Set "Default currency" and "Currency sign" to "BTC"
• Save configuration

Donate

• Bitcoin payments: 1DDuMEPaQzdH3vLTiQwQvACgnv7tR25SpE
• Gifts via other methods: http://www.nostate.com/support-nostatecom/

Authors

• Mike Gogulski - http://www.nostate.com/ http://www.gogulski.com/

Credits

uc_bitcoin incorporates code from:

• XML-RPC for PHP by Edd Dumbill (for JSON-RPC support)
• bitcoin-php by Mike Gogulski (Bitcoin support library)

License

uc_bitcoin is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.