TABLE OF CONTENTS
Setup Blockonomics on Invoice Ninja's Desktop App
- 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. - Click the "Create" button at the top of the page.
- Paste your Blockonomics API key to the "Api Key" field, then click "Save".
- Navigate to the "Settings" tab and make sure that "Crypto" is enabled, then click "Save".
- Done! Now your clients will be able to pay their invoices with using Bitcoin.
Appendix
How to get your Blockonomics' API key
- Go to Dashboard > Stores in Blockonomics.
- Copy the API Key.
How to add a Wallet
- 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.
- Enter "Name" of your wallet. You can enter any name that makes it easy for you to remember which wallet it is.
- Copy xPub from your wallet and paste it "Xpub" field.
- How To Find Your xPub Key With These 6 Popular Bitcoin Wallets ?
- If you don't already have a Bitcoin wallet, we recommend using Electrum wallet.
- 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.
- Click on "Create Wallet" button to store this wallet.
How to add a Store
- Copy the Callback URL and add it to your Blockonomics store.
- Copy the Webhook URL from Settings > Payment Settings > Configure Gateways > Blockonomics > Overview.
- Combine the webhook URL with your secret found at Settings > Payment Settings > Configure Gateways > Blockonomics > Edit.
- 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
- Go to Merchants -> Store Dashboard in Blockonomics and click on Add a new store.
- Add a Store's Name that makes it easy for you to remember which store it is:
- Paste Callback URL copied from the Blockonomics' settings page on Invoice Ninja earlier.
- Enable "Bitcoin" payment method and select a destination wallet from dropdown that you want linked to this store.
- Click on "Add Store" to create store.