Tax integration

Kill Bill and Kintsugi

Add sales tax from Kintsugi to every Kill Bill invoice. You connect Kill Bill from the Kintsugi app, and tax is added as separate lines when invoices are generated. The plugin is open source, in the Kill Bill GitHub organization.

Last updated: October 2026

Read the plugin docs
How it works
Short answer

Does Kill Bill work with Kintsugi?

Yes. The Kintsugi plugin sends each invoice's line items and the customer's address to Kintsugi when the invoice is generated, or when you preview it with a dry run. Kintsugi returns the sales tax, and Kill Bill adds it as TAX lines linked to the taxable items. Setup happens in the Kintsugi app, with no secrets to paste by hand.
Plugin
Open source, in the Kill Bill GitHub organization
Calculates
Sales tax, delegated to Kintsugi
On the invoice
TAX lines linked to taxable items
Setup
From the Kintsugi app: Connect Kill Bill, Enable Tax Collection
Security
Every request signed with an HMAC secret
Kill Bill version
0.24
How it works

From Kintsugi Setup to Tax Lines

Invoice or dry run Recurring, usage, one-off Ship-to address Kintsugi plugin Signed requests Estimate or commit TAX invoice items Kintsugi Sales tax Tax estimate line items tax Tax is computed when the invoice is generated and added as its own lines.
  1. 1
    Install the pluginInstall the Kintsugi plugin on Kill Bill, with kpm or by copying the JAR.
  2. 2
    Connect Kill Bill in KintsugiIn the Kintsugi app, connect your Kill Bill instance and click Enable Tax Collection. Kintsugi uploads the plugin configuration and the shared secret.
  3. 3
    Preview or generate an invoiceOn a dry run, the plugin asks Kintsugi for an estimate. On a real invoice, it commits the tax.
  4. 4
    Add tax linesKintsugi returns the tax lines. Kill Bill adds them as TAX items linked to the taxable lines.
Who does what

Kintsugi Calculates, Kill Bill Invoices

Kintsugi holds the tax rules and does the calculation. Kill Bill builds the invoice, asks for the tax and records it.
TaskKintsugiKill Bill
Tax calculationKintsugi·
Connection setup and secretKintsugi app·
Invoices and line items·Kill Bill
Tax estimate on dry runs·Kill Bill
Tax lines on the invoice·Kill Bill
Request signing·Kintsugi plugin
Other tax engines

Choose the Tax Engine That Fits

Kill Bill works with several tax engines. Pick one per tenant.
Avalara
US sales tax by state, county and city, with Avalara tax codes and exemptions.
Vertex
Sales tax through Vertex O Series, with your Vertex company settings.
Aviate Tax
VAT or GST rates you set per product and country, part of Aviate.
Resources

Docs and Code

Kintsugi plugin docsInstall and setup on docs.killbill.io
Source codekillbill/killbill-kintsugi-plugin on GitHub
Kintsugi documentationThe Kintsugi side of the setup
FAQs

Frequently Asked Questions

Does Kill Bill integrate with Kintsugi?
Yes. The open source Kintsugi plugin, in the Kill Bill GitHub organization, sends invoice line items and the customer's address to Kintsugi and adds the returned sales tax as TAX lines on the Kill Bill invoice.
How do I set up the Kintsugi plugin?
Install the plugin on Kill Bill, then connect Kill Bill from the Kintsugi app and click Enable Tax Collection. Kintsugi uploads the plugin configuration and the shared secret, so you do not paste secrets by hand.
How are requests to Kintsugi secured?
Every request is signed with an HMAC-SHA256 signature, using a secret shared between the plugin configuration and the Kintsugi connection.
What happens on a dry run?
The plugin asks Kintsugi for a tax estimate, so the preview shows the tax without committing it. Real invoices commit the tax.
Which Kill Bill version does the plugin support?
Kill Bill 0.24, according to the plugin's compatibility table.
Does the Kintsugi plugin cost anything?
The plugin is open source and free. You need your own Kintsugi account, under Kintsugi's terms.