> ## 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.

# Introdução

> A forma mais simples de cobrar pela sua API em Bitcoin sats.

<Card title="▶ Demo interativo — veja ao vivo" icon="play" href="https://l402kit.com/#live-demo">
  Animação terminal end-to-end: do `npm install` até a primeira chamada paga. 45 segundos.
</Card>

## O que é o l402-kit?

**l402-kit** é um middleware open-source que permite qualquer desenvolvedor adicionar micropagamentos Bitcoin Lightning à sua API em 3 linhas de código.

Sem cartão de crédito. Sem cadastro. Sem chargeback. Sem taxa mínima. Só 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
```

## O problema que resolve

Cobrar por chamada de API hoje é impossível com os meios tradicionais:

* **Stripe**: mínimo \$0,30 por transação — inviável para micropagamentos
* **Assinaturas**: quem usa pouco subsidia quem usa muito
* **Agentes de IA**: não têm cartão de crédito — não conseguem pagar APIs sozinhos

**l402-kit** é a terceira opção: pay-per-call via Lightning Network, liquidando em menos de 1 segundo, globalmente, sem intermediário.

## Como funciona

```
Cliente → GET /premium
API     → 402 + invoice Lightning (100 sats)
Cliente → paga invoice (< 1 segundo)
Cliente → GET /premium + prova de pagamento
API     → 200 + dados ✓
```

## Para quem é?

* **Devs de API** — cobra por chamada em vez de assinatura mensal
* **Builders de agentes de IA** — agentes pagam APIs automaticamente
* **Devs sem Stripe** — Brasil, Argentina, Nigéria — Bitcoin não tem fronteiras
* **Provedores de dados** — cobra 1 sat por consulta, impossível com Stripe

## Início rápido — TypeScript

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

const app = express();

app.get("/premium", l402({
  priceSats: 100,                             // ~R$0,01 por chamada
  lightning: new AlbyProvider(process.env.ALBY_TOKEN!, process.env.ALBY_HUB_URL!),     // soberano mode — 0% fee
}), (_req, res) => {
  res.json({ data: "Pagamento confirmado." });
});

app.listen(3000);
```

## Início rápido — 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 confirmado."}
```

## Teste agora

```bash theme={null}
curl http://localhost:3000/premium
# → {"error":"Payment Required","priceSats":100,"invoice":"lnbc..."}
```

<Card title="Quickstart completo" icon="bolt" href="https://l402kit.com/docs/quickstart">
  Do zero à API paga em 5 minutos
</Card>