> ## Documentation Index
> Fetch the complete documentation index at: https://shinydapps-bd9fa40b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduzione

> Il modo più semplice per monetizzare la tua API con Bitcoin Lightning. 3 righe di codice.

## Cos'è l402-kit?

**l402-kit** è un middleware open-source che permette a qualsiasi sviluppatore di aggiungere micropagamenti Bitcoin Lightning alla propria API in 3 righe di codice.

Nessuna carta di credito. Nessuna registrazione. Nessun chargeback. Nessuna commissione minima. Solo sats.

```bash theme={null}
npm install l402-kit   # TypeScript / Express
pip install l402kit    # Python / FastAPI / Flask
go get github.com/shinydapps/l402-kit/go@v1.10.0  # Go / net/http
cargo add l402kit       # Rust / axum
```

## Il problema che risolve

Addebitare per ogni chiamata API oggi è impossibile con i metodi tradizionali:

* **Stripe**: minimo €0,25 per transazione — impraticabile per i micropagamenti
* **Abbonamenti**: chi usa poco sovvenziona chi usa molto
* **Agenti IA**: non hanno una carta di credito — non possono pagare le API da soli

**l402-kit** è la terza opzione: pay-per-call tramite Lightning Network, con liquidazione in meno di 1 secondo, a livello globale, senza intermediari.

## Come funziona

```
Client → GET /premium
API    → 402 + invoice Lightning (100 sats)
Client → paga l'invoice (< 1 secondo)
Client → GET /premium + prova di pagamento
API    → 200 + dati ✓
```

## Per chi è?

* **Dev di API** — addebita per chiamata invece di un abbonamento mensile
* **Builder di agenti IA** — gli agenti pagano le API automaticamente
* **Dev senza Stripe** — Italia, Brasile, Nigeria — Bitcoin non ha frontiere
* **Fornitori di dati** — addebita 1 sat per query, impossibile con Stripe

## Avvio rapido TypeScript

```typescript theme={null}
import express from "express";
import { l402 } from "l402-kit";

const app = express();

app.get("/premium", l402({
  priceSats: 100,                           // ~€0,05 per chiamata
  lightning: new AlbyProvider(process.env.ALBY_TOKEN!, process.env.ALBY_HUB_URL!),     // modalità sovrana — 0% commissione
}), (_req, res) => {
  res.json({ data: "Pagamento confermato." });
});

app.listen(3000);
```

## Avvio rapido Python

```python theme={null}
from fastapi import FastAPI, Request
from l402kit import l402_required

app = FastAPI()

@app.get("/premium")
@l402_required(
    price_sats=100,
    lightning=ManagedProvider.from_address("you@blink.sv"),
)
async def premium(request: Request):
    return {"data": "Pagamento confermato."}
```

## Perché non Stripe?

|                    | Stripe     | l402-kit                  |
| ------------------ | ---------- | ------------------------- |
| Commissione minima | €0,25      | **\< 1 sat (\~€0,00003)** |
| Liquidazione       | 2–7 giorni | **\< 1 secondo**          |
| Chargeback         | Sì         | **Impossibile**           |
| Richiede account   | Sì         | **No**                    |
| Supporto agenti IA | No         | **Sì — nativo**           |
| Paesi bloccati     | \~50       | **0 — globale**           |
| Auditabile         | No         | **Sì — open source**      |

## Ottieni un Lightning Address gratuito

Registrati su [dashboard.blink.sv](https://dashboard.blink.sv) — gratuito, nessuna carta di credito.
Il tuo indirizzo sarà: `tuonome@tuodominio.com`

***

⚡ [Documentazione completa](https://l402kit.com/docs) — [npm](https://npmjs.com/package/l402-kit) — [PyPI](https://pypi.org/project/l402kit) — [crates.io](https://crates.io/crates/l402kit)