Table Of Contents
1. Installation
- Step 1: Install Blockonomics Plugin
- Step 2 (a): Automatic Store Setup
- Step 2 (b): Manual Setup
- Step 3: Add a Wallet
- Step 4: Add a Store
- Step 5: Test Setup
2. FAQs
- How do I edit text/customize appearance of the checkout page?
- Orders are not getting marked Paid on payment. How do I fix?
- My customers use TOR browser and don't have JavaScript enabled. What to do?
Installation
Follow these Instructions to start accepting Bitcoin with Blockonomics on your WordPress/WooCommerce store
Step 1: Install Blockonomics Plugin
In your WordPress dashboard, go to Plugins and click on Add New Plugin
Search for "WordPress Bitcoin Payments - Blockonomics". In Search Results, Next to our plugin click on "Install Now".
Once Installed click on "Activate" to activate our plugin.
Step 2 (a): Automatic Store Setup
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.
Follow the instructions in the Account setup page to get the API Key from Blockonomics Stores dashboard and paste it in. Then click on "Continue"
Enter a Store name that's easy for you to remember. Then click on "Continue".
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".
Once you click "Done" you will be redirected to WooCommerce > Settings >Payments > Blockonomics.
Here in "Store" section click on "Test Setup".
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.
Note: If you have already added a store and done "Test Setup" in this step, you can skip ALL the steps below:
Step 2 (b): Manual Setup
Configure API Key:
- Go to Dashboard > Stores in Blockonomics.
- Copy the API Key:
- Now in your WordPress Dashboard, Go to WooCommerce > Settings > Payments > Blockonomics Bitcoin > Store and paste in the copied API Key in this field and click on the "Save changes" button at the bottom of the page. Please make sure that these changes are saved and API Key is updated.
Step 3: Add Wallet: (If you already have a wallet added and plan on using that wallet, you can skip this step.)
Go to your Blockonomics dashboard > Wallets. Click on 'Wallets' and then select 'Add a Wallet' > BTC Wallet'.
(If you don't already have a Bitcoin wallet, we recommend using Electrum wallet.)
Enter "Name" of your wallet. You can enter any name that makes it easy for you to remember which wallet it is.
Enter the xPub of your receiving wallet. [to find the xPub of your wallet, click here]
Click on "Create Wallet" button to store this wallet.
Step 4: Add Store
Copy the Callback URL from WordPress Dashboard > Settings > Blockonomics > Settings. Copy the Callback URL in the advanced section.
Go to Merchants -> Stores in your Blockonomics dashboard and click on Add a store.
Add a Store's Name that makes it easy for you to remember which store it is:
Past Callback URL copied from WordPress Blockonomics plugin settings earlier.
Enable "Bitcoin" payment method and select a Destination Wallet from the dropdown that you want linked to this store. (this is the wallet you added earlier)
Click on "Add Store" to create the store. Once your store is created, you can access this store in this Stores Dashboard.
(Within a single Blockonomics account you can create multiple stores if you have multiple WordPress/WooCommerce sites/stores.)
Step 5: Test Setup
To make sure that everything is set up correctly, our last step is to run a test by clicking on "Test Setup" button in "Store" section in WordPress Dashboard > WooCommerce > Settings > Payments > Blockonomics Bitcoin.
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.
FAQs
1. 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.
2. 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 fail, 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 to debug and fix this.
3. 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.
