l402kit 0.3.2

Add Bitcoin Lightning pay-per-call to any API in 3 lines. L402 protocol for FastAPI and Flask. 0.3% fee, zero config.

l402kit

Charge for your API in Bitcoin Lightning. 3 lines of code. Monetize sua API com Bitcoin Lightning. 3 linhas de código. Monetiza tu API con Bitcoin Lightning. 3 líneas de código.

pip install l402kit

📖 Docs / Documentação: 🇺🇸 English · 🇧🇷 Português · 🇪🇸 Español · 🇨🇳 中文 · 🇮🇳 हिंदी · 🇸🇦 العربية · 🇫🇷 Français · 🇩🇪 Deutsch · 🇷🇺 Русский · 🇯🇵 日本語

---

English

Add pay-per-call Bitcoin Lightning payments to any Python API. Works with FastAPI and Flask. No account. No bank. No chargebacks.

How it works

Client calls your API
  → Returns 402 + Lightning invoice
  → Client pays (< 1 second)
  → Client sends cryptographic proof
  → SHA256(preimage) == paymentHash ✓
  → API responds 200 + data

Money flow (managed mode):
  Payment → ShinyDapps → 99.7% to your Lightning Address
                       → 0.3% fee to ShinyDapps

FastAPI quickstart

from fastapi import FastAPI, Request
from l402kit import l402_required

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Try GET /premium"}

# Costs 100 sats (~$0.10) per call
@app.get("/premium")
@l402_required(
    price_sats=100,
    owner_lightning_address="[e-mail]",  # your Lightning Address — receives 99.7%
)
async def premium(request: Request):
    return {"data": "Payment confirmed. Here is your data."}

Flask quickstart

from flask import Flask, jsonify
from l402kit import l402_required

app = Flask(__name__)

@app.get("/premium")
@l402_required(price_sats=100, owner_lightning_address="[e-mail]")
def premium():
    return jsonify({"data": "Payment confirmed."})

Test it

uvicorn main:app --reload

# First call — payment challenge
curl http://localhost:8000/premium
# → { "error": "Payment Required", "invoice": "lnbc1u...", "macaroon": "eyJ..." }

# Pay invoice with any Lightning wallet, then:
curl http://localhost:8000/premium \
  -H "Authorization: L402 <macaroon>:<preimage>"
# → { "data": "Payment confirmed." }

Why not Stripe?

	Stripe	l402kit
Minimum fee	$0.30	< 1 sat (~$0.001)
Settlement	2–7 days	< 1 second
Chargebacks	Yes	Impossible
Requires account	Yes	No
AI agent support	No	Yes — native
Countries blocked	~50	0 — global

---

Português

Adicione pagamentos por chamada via Bitcoin Lightning em qualquer API Python. Funciona com FastAPI e Flask. Sem conta. Sem banco. Sem chargeback.

FastAPI — início rápido

from fastapi import FastAPI, Request
from l402kit import l402_required

app = FastAPI()

@app.get("/premium")
@l402_required(
    price_sats=100,
    owner_lightning_address="você@blink.sv",  # recebe 99.7% de cada pagamento
)
async def premium(request: Request):
    return {"data": "Pagamento confirmado."}

Flask — início rápido

from flask import Flask, jsonify
from l402kit import l402_required

app = Flask(__name__)

@app.get("/premium")
@l402_required(price_sats=100, owner_lightning_address="você@blink.sv")
def premium():
    return jsonify({"data": "Pagamento confirmado."})

Por que não Pix / Stripe?

	Stripe	Pix	l402kit
Taxa mínima	R$1,50	R$0,01	< 1 sat
Liquidação	2–7 dias	Instante	< 1 segundo
Chargeback	Sim	Não	Impossível
Funciona pra IA	Não	Não	Sim
Global	Não	Só Brasil	Sim — 0 fronteiras

---

Español

Agrega pagos por llamada en Bitcoin Lightning a cualquier API Python.

from fastapi import FastAPI, Request
from l402kit import l402_required

app = FastAPI()

@app.get("/premium")
@l402_required(price_sats=100, owner_lightning_address="[e-mail]")
async def premium(request: Request):
    return {"data": "Pago confirmado."}

---

Advanced mode — bring your own Lightning wallet

import os
from fastapi import FastAPI, Request
from l402kit import l402_required, BlinkProvider

app = FastAPI()

lightning = BlinkProvider(
    api_key=os.environ["BLINK_API_KEY"],
    wallet_id=os.environ["BLINK_WALLET_ID"],
)

@app.get("/premium")
@l402_required(price_sats=100, lightning=lightning)
async def premium(request: Request):
    return {"data": "Payment confirmed."}

---

Security

Every payment is cryptographically verified — impossible to fake:

SHA256(preimage) == paymentHash

• Anti-replay: each preimage works exactly once
• Expiry: tokens expire after 1 hour
• Open source: github.com/ShinyDapps/l402-kit

---

Get a free Lightning Address

Sign up at dashboard.blink.sv — free, no credit card. Your address: [e-mail]

---

Links

Docs (10 languages)	shinydapps.mintlify.app
PyPI	pypi.org/project/l402kit
npm (TypeScript)	npmjs.com/package/l402-kit
GitHub	github.com/ShinyDapps/l402-kit
Creator	github.com/ThiagoDataEngineer
Lightning	[e-mail]

---

License

MIT — use freely, build freely. Bitcoin has no borders.

Built with ⚡ by ShinyDapps