Blockonomics

Table Of Contents:

1. Installation

1. Step 1: Create a Blockonomics Account
2. Step 2: Adding a Wallet to Blockonomics
3. Step 3: Install the WHMCS Plugin
4. Step 4: Set Up Store Preferences
5. Step 5: Test Setup

2. FAQs

1. Customizing Text and Appearance of the Checkout Page
2. How can we fix orders that are not marked paid on an invoice?
3. Why are orders getting marked UNPAID?
4. How to fix "Test Setup" is getting stuck or giving error unable to execute?
5. How to search the order for which customer is quoting a bitcoin transaction id/address?

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.

Step 2: Adding a Wallet to Blockonomics

Once your account is set up, the next step is to add a wallet. This is crucial for receiving your Bitcoin payments directly.

1. Go to your Blockonomics dashboard.
2. Click on 'Wallets' and then select 'Add a Wallet' > BTC Wallet'.
3. Enter the xPub of your receiving wallet. [to find the xPub of your wallet, click here]

Step 3: Install the WHMCS Plugin

Download the WHMCS Integration

Head on over to WHMCS marketplace and Click 'Get it Now' to download the zip file.

Upload the Plugin to Your WHMCS Directory

After downloading the plugin, we need to upload it to your WHMCS directory.

1. Open your FTP client, such as FileZilla.
2. Connect to your WHMCS directory using your host, username, password, and port.
3. Locate the Blockonomics plugin folder in your downloads, open it, and find the 'modules' folder.
4. Copy the 'modules' folder to your root WHMCS directory.

Activate the Blockonomics Plugin

Now that the plugin is uploaded, it’s time to activate it in WHMCS.

1. Log into your WHMCS account.
2. Navigate to 'Add-ons' and then go to 'Apps and Integrations'.
3. Click 'Browse' under payments and search for Blockonomics.
4. Once you find it, click on Blockonomics and hit 'Activate'.

Configuring API Settings

With the plugin activated, we now need to configure the API settings.

1. Head back to your Blockonomics dashboard.
2. Click on 'Stores' and copy the API key.
3. Paste this API key into the configuration page in WHMCS.

Step 4: Set Up Store Preferences

Now it’s time to create a store and set your preferences.

1. Name your store.
2. Copy the Callback URL from the WHMCS page and paste it into the store settings on Blockonomics.
3. Toggle the button under 'Payment Method' and choose your destination wallet.
4. Hit 'Add Store'.

Step 5: Test Setup

Everything is set up! Now test the checkout process to ensure everything works smoothly.

1. As a user on your PrestaShop store, add an item to your cart.
2. When you click on the checkout button and you’ll be taken to the payment screen.
3. You will be shown a Bitcoin address and the amount. Copy both these fields and head to your Blockonomics account and go to the Logs/Test Bench section.
4. Enter the details in the respective fields and click Send test payments. 
5. A successful order would have been placed on your store. 

And we're done! Go forth and accept Bitcoin!

FAQs

1. Customizing Text and Appearance of the Checkout Page?

If you wish to alter the page's styling, modify the 'order.css' file. For editing or modifying string translations in different languages, you can access and adjust files located in the 'module lang' folder.

2. How can we fix orders that are not marked paid on an invoice?

Your webhost is blocking incoming callbacks from bots, or you have a DDOS protection in place that is causing this. Blockonomics server does payment callbacks to update transaction status and cannot emulate a browser accessing your website. Please consult this article on how to debug and fix this

3. Why are orders getting marked UNPAID?

Most probably your customers are paying from an exchange. In such a case, say while intending to pay 0.01BTC, the exchange deducts fee and you get only 0.00095BTC. This doesn't happen if a customer is paying from a wallet like blockchain.com or electrum. You can choose to accept the order or ask customer to pay more by clicking Pay from the invoice. There is also a setting a Underpayment Slack in the module that will help in the regard (Setup -> Payment Gateways -> Manage Existing Gateways -> Blockonomics -> Advanced Settings)

4. How to fix "Test Setup" is getting stuck or giving error unable to execute?

Make sure during module installation, the upload file permissions are correctly set to 755. Check if module files are accessible from outside. A simple way is to check if the URL https://yourhostingserver.com/modules/gateways/blockonomics/whmcs.json is accessible from outside.  If it is not, check your WHMCS System URL via Setup > General Settings

5. How to search the order for which customer is quoting a bitcoin transaction id/address?

You can search the txid in Gateway transaction log