Table Of Contents


1. Installation

  1. Step 1: Install Blockonomics Plugin
  2. Step 2: Adding a Wallet to Blockonomics
  3. Step 3: Install Blockonomics Plugin
  4. Step 4: Setup API Key
  5. Step 5: Add Store
  6. Step 6: Test Setup


2. FAQs

  1. How do I edit text/customize the appearance of the checkout page?
  2. Orders are not getting marked Paid on payment. How do I fix?
  3. My customers use the TOR browser and don't have JavaScript enabled. What to do?




Installation


Step 1: Create a Blockonomics Account


  1. Head over to the Blockonomics website.
  2. You can create an account using your email and a password or opt for the simpler option by signing up with your Google account.


Signing up for Blockonomics




Step 2: Adding a Wallet to Blockonomics


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 save this wallet.






Step 3: 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 4: Setup API Key


Go to Dashboard > Stores in Blockonomics and Copy the API Key:


Now in your WordPress Dashboard, Go to WooCommerce > Settings > Payments > Blockonomics Bitcoin and click "Enable" and then "Manage".



In the Store section, Paste in the copied API Key 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 5: Add Store


Scrolling down on the same page, head to the Advanced section. Copy the Callback URL mentioned here. 



Now, 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:



Paste the 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 the Stores Dashboard. 


(Within a single Blockonomics account, you can create multiple stores if you have multiple WordPress/WooCommerce sites/stores.)





Step 6: Test Setup


To make sure that everything is set up correctly, our last step is to run a test. In your WordPress Dashboard, go to WooCommerce > Settings > Payments > Blockonomics Bitcoin -> Manage.


In the 'Store' section, click on "Test Setup" button.



Once successful "Test Setup" is done, you should see a notification with a Green checkmark next to "BTC" indicating that your Blockonomics plugin is ready to accept Bitcoin payments.



That's all, you are now ready to accept BTC payments in your WooCommerce store! 





FAQs


1. How do I edit text/customize the 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 the 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 the TOR browser and don't have JavaScript enabled. What to do?

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