Skip to content
This repository has been archived by the owner on Nov 11, 2019. It is now read-only.

Latest commit

 

History

History
51 lines (39 loc) · 2.45 KB

GUIDE.md

File metadata and controls

51 lines (39 loc) · 2.45 KB
Raw

Using the BitPay plugin for osCommerce

Prerequisites

  • Last Version Tested: 2.3.4

You must have a BitPay merchant account to use this plugin. It's free to sign-up for a BitPay merchant account.

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: https://bitpay.com/downloads/bitpayApi.pdf
    • 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.