Table Of Contents:


1. Installation

  1. Step 1: Create a Blockonomics Account
  2. Step 2: Adding a Wallet to Blockonomics
  3. Step 3: Setup Ghost Utility
  4. Step 4: Tier and Duration Settings
  5. Step 5: Setup Integration
  6. Step 6: Test Setup 


2. FAQs

  1. I use Ghost Pro, what URL should I use for the setup
  2. How do I test my Bitcoin payments?
  3. User is not created even though payment is made. What should I do?
  4. I want to change the time to pay from the default 10 minutes.
  5. Orders are getting marked as Failed. What's happening?





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


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 'Wallet' and then select 'BTC Wallet'.
  3. Add any name you wish and the xPub Key of your wallet. [To find the xPub key of your BTC wallet, click here]





Step 3: Setup Ghost Utility


Head on over to Blockonomics Ghost Utility, once there you will be prompted to fill in the following information:

  1. Ghost Content API Key
  2. Ghost Admin API Key
  3. Ghost API URL
  4. Widget UID




Ghost API URL: The URL/site address of your Ghost blog goes here.


Ghost Admin API Key:


To access this key, head on over to your ghost admin panel, and go to Settings -> Integrations (under advanced) -> Add Custom Integration



You can add a Name and Description for this integration to your liking.  


You will see an Admin API Key here, copy this key and paste it into the Ghost Admin API Key section of the Blockonomics utility.



Widget UID:


  1. To get this ID, head on over to Blockonomics Dashboard -> Buttons & Links -> Products.
  2. Enter the details about your product (in this case, it will be your blog membership). You can enter details such as:
    • Product Name
    • Description
    • Price
    • Custom Fields (Any details you wish to collect from paying customers)
    • Order Completion Email: Any redirect URL or post-payment details to access the paid features can be added here.

Once all the fields are filled, click on the 'Generate Widget' button at the bottom.

You will be shown a Widget UID, copy this figure and paste it into the Widget UID section of the Blockonomics utility.



Step 4: Tier and Duration Settings


Once all the 4 fields are successfully added in the step above. Click on 'Submit'.


This will take you to the page to add how long you want a membership to last, and the tier for the membership if you have multiple tiers. You have to have the tiers set up first in Ghost as shown here: https://ghost.org/help/tiers/


Important: You have to create a different payment link for each tier and/or duration you want!




Step 5: Setup Integration


Once everything is successfully added in the steps above, click on Finish and you will be prompted to complete 2 more steps.


1. Payment Page


Copy the code that is shown in Step 1.


Then head on over to your Ghost Admin panel. Click on Pages -> New Page



This is the membership page that your users will see when they make the payment, so feel free to design this page to your liking.


The important thing here is to add an HTML card in the body. In the HTML section, paste the code that you copied earlier.



Upon completion, Publish the page and you will see a dedicated pay button on this page.




2. Order Hook URL


On the Blockonomics Ghost Utility, copy the URL mentioned under step 2.



Then head to Blockonomics Dashboard -> Buttons & Links -> Options in your Blockonomics Account and paste the URL in the Order Hook URL field.


Don't forget to Save changes!




Step 6: Test Setup


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

  1. As a user on your Ghost, select a membership tier. 
  2. When you click on the Pay Now button, you should see Blockonomics pop up automatically.
  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.



Enter the details in the respective fields and click Send test payments.



You should successfully receive a payment confirmation in the email provided.


That it! You have successfully integrated Bitcoin payments into your ghost blog. Happy Blogging! 




FAQs

1. I use Ghost Pro, what URL should I use for the setup?

You should use your Base URL. All Ghost(Pro) blogs have a *.ghost.io domain as their admin domain and require https. If you are self hosting use the URL of your blog.


2. How do I test my Bitcoin payments?

Simply go to your Bitcoin payment page and click on the Buy Subscription with Bitcoin button. Enter in a test email, select a teir and a duration and then click on Pay Now button. You will be shown a Bitcoin address and the amount. Copy both these fields, head over to your Test Bench in Blockonomics. Select proper store, paste in BTC amount and Bitcoin Address, set Payment Status to "Confirmed" and click on "Send Test Payment" button. You would see a confirmation message in Bitcoin payment page on your Ghost Blog that payment is received. You can now see that the membership for test email for said tier is created in Ghost Admin > Members.


3. User is not created even though payment is made. What should I do?

Check out Logs from Merchants > Logs / Test Bench. Verify that at the end of the callback line there is a green 200. If there is anything else than 200 at the end of the line, please consult this article on how debug and fix this.


4. I want to change the time to pay from the default 10 minutes.

To change the timer shown to your customers at the payment screen, go to Merchants > Payment Buttons > Options and under the Time Period set your desired payment time.


5. Orders are getting marked as Failed. What's happening?

Most probably your customers are paying from an exchange. In such a case say while intending to 0.01BTC, the exchange deducts fee and you get only 0.00095 BTC. This doesn't happen if customer is paying from a wallet like blockchain.com or Electrum. You can choose to manually accept the order or ask customer to manually pay more. There is also a setting Underpayment Slack in the extension settings that will allow you to accept payments that are underpaid by a small percentage (Opencart Admin > Extensions > Payments > Blockonomics > Advanced Settings > Underpayment Slack %)