Skip to content

Latest commit

 

History

History
45 lines (36 loc) · 2.9 KB

README.md

File metadata and controls

45 lines (36 loc) · 2.9 KB
Raw

osCommerce 2.3.3 BitPay Module

©2013 BIT-PAY LLC. Permission is hereby granted to any person obtaining a copy of this software and associated documentation for use and/or modification in association with the bitpay.com service.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Bitcoin payment module using the bitpay.com service.

Installation

  1. Copy bitpay_callback.php into your osCommerce catalog directory
  2. Copy the bitpay directory into your osCommerce catalog directory
  3. Copy includes/modules/payment/bitpay.php into catalog/includes/modules/payment/
  4. Copy includes/languages/english/modules/payment/bitpay.php into catalog/includes/languages/english/modules/payment/

Configuration

  1. Create an API key at bitpay.com under My Account > API Access Keys
  2. In your osCommerce admin panel under Modules > Payment, install the "Bitcoin via BitPay" module
  3. Fill out all of the configuration information:
    • Verify that the module is enabled.
    • Copy/Paste the API key you created in step 1 into the API Key field
    • Select a transaction speed. The high speed will send a confirmation as soon as a transaction is received in the bitcoin network (usually a few seconds). A medium speed setting will typically take 10 minutes. The low speed setting usually takes around 1 hour. See the bitpay.com merchant documentation for a full description of the transaction speed settings.
    • Choose a status for unpaid and paid orders (or leave the default values as defined).
    • Verify that the currencies displayed corresponds to what you want and to those accepted by bitpay.com (the defaults are what BitPay accepts as of this writing).
    • Choose a sort order for displaying this payment option to visitors. Lowest is displayed first.

Usage

When a user chooses the "Bitcoin via BitPay" payment method, they will be presented with an order summary as the next step (prices are shown in whatever currency they've selected for shopping). Upon confirming their order, the system takes the user to bitpay.com. Once payment is received, a link is presented to the shopper that will take them back to your website.

In your Admin control panel, you can see the orders made via Bitcoins just as you could see for any other payment mode. The status you selected in the configuration steps above will indicate whether the order has been paid for.

Note: This extension does not provide a means of automatically pulling a current BTC exchange rate for presenting BTC prices to shoppers.