Skip to content

Invoice Ninja

Invoice Ninja is an open-source invoicing platform that helps freelancers and small businesses create professional invoices, track time, and manage payments. It offers both cloud-hosted and self-hosted options, with features like recurring billing, expense tracking, and integration with popular payment gateways.

Features

  • Authenticate via API Token
  • Retrieve invoice data via API
  • Your customer is redirected to the payment page after clicking the link on the invoice
  • Your customer is redirected to the payment page after clicking the link in the mail send with the invoice.

Note

  • You need to self-host Invoice Ninja or have a 'Pro' plan to use the API and templates. Both are needed for our solution to work.
  • Invoice Ninja doesn't send the currency with their invoice. Therfor it's not possible for us to determine the currency of the invoice. We fall back on the configured default for your company. Be aware that you can't use multiple invoice currencies together with our service. If you do, please contact us.

Setup

In step 2 of the activation procedure you need to enter details from Invoice Ninja. We need an API key with access to the invoices and the company id. You have to retrieve both by yourself. The steps below guide you through the steps.

Create and Retrieve API Key

  1. Logon into Invoice Ninja with your credentials
  2. Select Settings -> Accountmanagement in the menu img.png
  3. Open the tab Integrations and select API Tokens
  4. Press the button New Token
  5. Fill in the name for the token. For example payinbtc.me and press save. API key is now created and saved.
  6. Go again to Account management -> Integrations -> API Tokens
  7. Click on the name of the just created API key. The screen below is shown API Key
  8. Click on the copy symbol to copy the key to your clipboard. Keep the screen open during the payinbtc.me setup.

The next step is to add the bitcoin payment link to the invoice. To set this up, perform the following steps.

  1. Logon into Invoice Ninja with your credentials
  2. Create a new invoice or select an existing one
  3. Go to the for with public notes. Select the tab Terms img.png
  4. You can now add the payment link. Please see account activation email for the details about this link.
  5. Check the box at Save as default terms
  6. Save the invoice.

The last step is to add the bitcoin payment link to the invoice. To set this up, perform the following steps.

  1. Logon into Invoice Ninja with your credentials
  2. Select Settings -> Templates & Reminders in the menu
  3. If needed you can update the different templates that are present
  4. First one selected: Invoice img_1.png
  5. You can now add the payment link. Please see account activation email for the details about this link.
  6. Save the changes.
  7. Repeat the steps above for all itmes you would likes to update.