TABLE OF CONTENTS


Installation

Follow these Instructions to start accepting Bitcoin with Blockonomics on your WordPress/WooCommerce store

  1. Install Blockonomics Plugin

    1. In your WordPress dashboard, go to Plugins and click on Add New Plugin
    2. Search for "WordPress Bitcoin Payments - Blockonomics". In Search Results, Next to our plugin click on "Install Now".
    3. Once Installed click on "Activate" to activate our plugin.

  2. Automatic Store Setup

    1. Once activated, you will be redirected to Plugins page. In Plugins page, you will see this notification banner. Click on "Account Setup page" to complete the setup.
    2. Follow the instruction in the Account setup page to get the API Key from Blockonomics Stores dashboard and paste it in. Then click on "Continue"
    3. Enter a Store name that's easy for you to remember. Then click on "Continue".
    4. A store will be created in your Blockonomics account linking your WordPress/WooCommerce store. You can see the store created in stores page in your dashboard. Now, you can click on "Done".
    5. Once you click "Done" you will be redirected to WooCommerce > Settings >Payments > Blockonomics. Here in "Store" section click on "Test Setup".
    6. Once successful "Test Setup" is done, you should see a notification with Green checkmark next to "BTC" indicating that your Blockonomics plugin is ready to accept Bitcoin payments.

  3. Manual Setup

    1. If you have already added store and done "Test Setup" in previous step, you can skip Manual Setup.
    2. Configure API Key:
      1. Go to Dashboard > Stores in Blockonomics.
      2. Copy the API Key:
      3. Now In you WordPress Dashboard, Go to WooCommerce > Settings > Settings > Payments > Blockonomics Bitcoin and paste in the copied API Key in this field and click on "Save changes" button at the bottom of page. Please make sure that these change are saved and API Key is updated.
    3. Add Wallet:
      1. Go to Blockonomics Dashboard > Wallets. Here you can start adding information for linking a new wallet. If you already have a wallet added and plan on using that wallet, you can skip this step. If you already have a wallet added but want to add a new wallet, click on "Add a wallet" button.
      2. Enter "Name" of your wallet. You can enter any name that makes it easy for you to remember which wallet it is.
      3. Copy xPub from your wallet and paste it "Xpub" field.
      4. From same wallet, copy a receiving address and paste it in "Sample Receiving Address" field below. This makes sure that both xPub and receiving address belong to same wallet.
      5. Click on "Create Wallet" button to store this wallet.
    4. Add Store:
      1. Copy the Callback URL from WordPress Dashboard > Settings > Blockonomics > Settings.
      2. Go to Merchants -> Store Dashboard in Blockonomics and click on Add a new store.
      3. Add a Store's Name that makes it easy for you to remember which store it is:
      4. Past Callback URL copied from WordPress Blockonomics plugin settings earlier.
      5. Enable "Bitcoin" payment method and select a Destination Wallet from dropdown that you want linked to this store.
      6. Click on "Add Store" to create store. Once your store is created, you can this store in this Stores Dashboard. With in a single Blockonomics account you can create multiple stores if you have multiple WordPress/WooCommerce sties/stores.
    5. Test Setup:
      1. To make sure that everything is setup correctly, our last step is to run a test by by clicking on "Test Setup" button in "Store" section in WordPress Dashboard > WooCommerce > Settings > Payments > Blockonomics Bitcoin.
      2. Once successful "Test Setup" is done, you should see a notification with Green checkmark next to "BTC" indicating that your Blockonomics plugin is ready to accept Bitcoin payments.


FAQ

How do I edit text/customize appearance of the checkout page?

Please consult this article to find out how to customize the checkout page as desired.


Orders are not getting marked Paid on payment. How do I fix?

Blockonomics server sends payment callbacks to your system to update transaction status. If these payment callbacks are successful, your orders get marked as Paid. But if for some reason these callbacks fails, it means that our server couldn't tell your system that orders were paid. Most common reason for callbacks failing is your webhost blocking incoming callbacks thinking they are from bots, or are part of a DDoS attack and you have a DDoS protection in place. Please consult this article on how debug and fix this.


My customers use TOR browser and don't have JavaScript enabled. What to do ?

You can run our plugin in No JavaScript mode by checking No JavaScript checkout page option in WordPress Admin Dashboard > WooCommerce > Settings > Payments > Blockonomics Bitcoin > Advanced.