TABLE OF CONTENTS

Setup Blockonomics on Invoice Ninja's Desktop App

  1. Go to Settings > Payment Settings > Configure Gateways.
    Note: The path of the settings may vary slightly depending on which client you use. E.g. on the React Web App Blockonomics is added by navigating to Settings > Payment Settings > Add Payment Gateway > Payment Provider.

  2. Click the "Create" button at the top of the page.
  3. Paste your Blockonomics API key to the "Api Key" field, then click "Save".
  4. Navigate to the "Settings" tab and make sure that "Crypto" is enabled, then click "Save".
  5. Done! Now your clients will be able to pay their invoices with using Bitcoin.

Appendix

How to get your Blockonomics' API key

  1. Go to Dashboard > Stores in Blockonomics.
  2. Copy the API Key.

How to add a 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.

How to add a Store

  1. Copy the Callback URL and add it to your Blockonomics store.
    1. Copy the Webhook URL from Settings > Payment Settings > Configure Gateways > Blockonomics > Overview.
    2. Combine the webhook URL with your secret found at Settings > Payment Settings > Configure Gateways > Blockonomics > Edit.
    3. The callback URL follow the formula <webhookUrl>?secret=<yoursecret>: 
      • Invoice Ninja Webhook URL: https://invoicing.co/payment_webhook/D32R80MNQfeUQPbY1xOtlsIOXloFOVsB/LKdwQrRb1Y 
      • Secret: iuXoNJNuXZw2rvTsRzdSHj4HvEHnLZuj
      • Complete callback URL that should be added to Blockonomics: https://invoicing.co/payment_webhook/D32R80MNQfeUQPbY1xOtlsIOXloFOVsB/LKdwQrRb1Y?secret=iuXoNJNuXZw2rvTsRzdSHj4HvEHnLZuj 
  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. Paste Callback URL copied from the Blockonomics' settings page on Invoice Ninja 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.