Payment integration
Kill Bill and Adyen
Run subscriptions and invoices in Kill Bill, and collect payments through Adyen Checkout. Customers pay in the Adyen Drop-in, Adyen confirms each payment with a notification, and stored tokens pay the next invoices. The plugin is open source and maintained by the Kill Bill team.
Last updated: October 2026
Short answer
Does Kill Bill work with Adyen?
Yes. The Adyen plugin connects Kill Bill to Adyen Checkout. The customer pays in the Adyen Web Drop-in, the payment stays pending in Kill Bill until Adyen confirms it with a notification, and Adyen stores a token that Kill Bill uses for recurring charges. Failed payments follow Kill Bill's retry and overdue rules.
- Plugin
- Open source, Apache 2.0
- Maintained by
- The Kill Bill team
- Adyen product
- Adyen Checkout with Web Drop-in
- Recurring
- Adyen token stored for later invoices
- Operations
- Authorize, capture, purchase, void, refund
- Notifications
- Adyen webhooks, verified with an HMAC key
How it works
From Drop-in to Recurring Charges
- 1Configure the pluginUpload the API key, merchant account, HMAC key and notification credentials for the tenant, and set the notification URL in Adyen.
- 2Create the payment methodCreate the Kill Bill payment method with recurring enabled, so Adyen keeps a token for the next invoices.
- 3Start a Checkout sessionThe plugin creates an Adyen session and a first payment, pending in Kill Bill.
- 4Pay in the Drop-inThe customer enters payment details in the Adyen Web Drop-in.
- 5Confirm and recurAdyen sends a notification and the payment turns successful. Later invoices are charged with the stored token, and failed payments follow your retry schedule.
Who does what
Adyen Processes, Kill Bill Bills
Adyen collects payment details, processes payments and confirms them. Kill Bill decides what to charge and when, and keeps the billing records.
| Task | Adyen | Kill Bill |
|---|---|---|
| Payment details capture | Adyen Drop-in | · |
| Payment processing | Adyen | · |
| Payment confirmation | Adyen webhooks | · |
| Recurring token storage | Adyen | · |
| Plans, subscriptions, proration | · | Kill Bill |
| Invoices, credits, tax lines | · | Kill Bill |
| When to charge, retries, overdue | · | Kill Bill |
| Refunds from an admin UI | · | Kaui |
Configuration
Plugin Settings at a Glance
Each tenant has its own Adyen settings, uploaded through the Kill Bill API or Kaui.
| Setting | What it does |
|---|---|
| API key | Authenticates Kill Bill with Adyen |
| Merchant account | The Adyen merchant account to charge |
| HMAC key | Verifies that notifications come from Adyen |
| Username and password | Basic authentication on the notification endpoint |
| Return URL | Where Adyen sends notifications |
| Capture delay | Hours between authorization and capture, from 0 to 168 |
| Environment | TEST or LIVE |
FAQs
Frequently Asked Questions
Does Kill Bill integrate with Adyen?
Yes. The open source Adyen plugin, maintained by the Kill Bill team under the Apache 2.0 license, connects Kill Bill to Adyen Checkout. Kill Bill runs subscriptions and invoices, and charges them through Adyen.
Which Adyen integration does the plugin use?
Adyen Checkout with the Web Drop-in, through Adyen sessions. Older plugin versions used the Adyen classic integration.
How are recurring payments handled?
When the payment method is created with recurring enabled, the plugin stores the token Adyen returns. Kill Bill uses it to charge the next invoices without asking the customer again.
Why is the first payment pending?
Adyen confirms payments with a webhook notification. The payment stays pending in Kill Bill until the notification arrives, then turns successful. The notification endpoint must be reachable from the internet.
Which payment operations are supported?
Authorize, capture, purchase, void and refund. A capture delay of 0 to 168 hours after authorization can be set.
Who built the Adyen plugin?
The code was originally developed by Wovenware, a Kill Bill partner. The plugin is now maintained by the Kill Bill team.
Does the Adyen plugin cost anything?
The plugin is open source and free. You need your own Adyen account, and Adyen's processing fees apply as agreed with Adyen.