How it works

Four moving parts: the dashboard where you register devices, the Lightning gateway that creates invoices, your Home Assistant instance that controls hardware, and the customer's phone wallet that pays.

1. Register the asset

In the dashboard, add a device: name, price in sats, duration, the Home Assistant entity_id and service to call (e.g. switch.coffee_machine + switch.turn_on).

2. Get a unique QR

We generate a permanent LNURL-pay endpoint per asset. Print the QR on a sticker and put it on the machine. Each scan produces a fresh, single-use invoice.

3. Customer scans & pays

Any Lightning wallet works. The invoice is created by your LNBits/BTCPay node and settles in under a second on the Lightning Network.

4. Gateway signs the webhook

On payment_received, our gateway sends a signed Ed25519 webhook to your HA bridge add-on with the asset_id and duration.

5. Home Assistant activates the device

The bridge verifies the signature and calls the configured service. Coffee gets brewed, charger turns on, ride starts running — your rules.