Skip to content

fld/oscommerce-bitcoin

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

osCommerce Bitcoin Payment Module v0.6

This module enables your osCommerce webstore to accept Bitcoin. 

IMPORTANT: This module is currently under development and works with BTC as the default currency only.


Features:

* Creates a unique payment address for each order
* Automatically updates BTCUSD exchange rate
* Updates order to Processing when payment is received (# of Bitcoin network confirmations is configurable)
* Forwards excess bitcoins to your off-server forwarding address
* Python script restarts bitcoind if it becomes unresponsive
* Bitcoind and monitor.py can be run on a server other than the osCommerce hosting server


Requirements:

osCommerce (tested so far only with v2.3.1)
Python with modules: MySQLdb and simplejson
bitcoind


Installation:

1. Copy all files into your osCommerce installation (the checkout_success.php replaces 
the existing one so if you or any addons have modified that page, you'll want to merge 
our changes).

2. Enable Bitcoin Payment module

3. Fill in bitcoind RPC host:port, user, password, and create a random notification key

4. Create BTC currency in osCommerce administration -> Localization -> Currencies with 
the following settings. For Value enter # of BTC a USD would buy you.

Title: Bitcoin
Code: BTC
Symbol Left:
Symbol Right: BTC
Decimal Point: .
Thousands Point: ,
Decimal Places: 3

5. Recommended: Install the Display Totals in Default Currency addon from 
http://www.oscommerce.com/community/contributions,3333 and make the modifications 
listed in this post: https://bitcointalk.org/index.php?topic=67166.msg791064#msg791064

6. Move ./script folder to your preferred location for Python scripts (preferably 
outside the web root)

6. Copy ./script/default_settings.py to ./script/settings.py and configure at least 
BASE_PATH and OSC_URL

7. Make sure bitcoind is running, is in the path, and has an rpcuser and rpcpassword set 
in .bitcoin/bitcoin.conf

8. Start monitor.py:

    monitor.py &

You can 'tail -f ./scripts/monitor.log' to follow what the monitor script is doing.

Todo:

* Include a watchdog script to make sure monitor.py is running via cronjob.

Inspired by http://addons.oscommerce.com/info/8170 by phoenix.x742 / 2 Oct 2011
bpn.php modified from an osCommerce Paypal IPN script

About

Payment module for osCommerce catalog and shopping cart software

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 61.2%
  • Python 38.8%