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. 🇨🇳 用 3 行代码，通过比特币闪电网络收费。 🇮🇳 अपने API को Bitcoin Lightning से 3 लाइनों में मोनेटाइज़ करें। 🇸🇦 اكسب من API الخاص بك عبر Bitcoin Lightning. 3 أسطر فقط. 🇫🇷 Monétisez votre API en Bitcoin Lightning. 3 lignes de code. 🇩🇪 Monetarisiere deine API mit Bitcoin Lightning. 3 Zeilen Code. 🇷🇺 Монетизируй свой API через Bitcoin Lightning. 3 строки кода. 🇯🇵 Bitcoin Lightningで APIを3行で収益化。 🇮🇹 Monetizza la tua API con Bitcoin Lightning. 3 righe di codice.

pip install l402kit

📖 Docs / Documentação / Documentation:

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

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 (Managed — 0.3% fee, no node needed)

from fastapi import FastAPI, Request
from l402kit import l402_required, ManagedProvider

app = FastAPI()
lightning = ManagedProvider.from_address("you@yourdomain.com")

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

# Costs 100 sats (~$0.10) per call — 99.7% goes directly to your Lightning address
@app.get("/premium")
@l402_required(price_sats=100, lightning=lightning)
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, ManagedProvider

app = Flask(__name__)
lightning = ManagedProvider.from_address("you@yourdomain.com")

@app.get("/premium")
@l402_required(price_sats=100, lightning=lightning)
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?

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, ManagedProvider

app = FastAPI()
lightning = ManagedProvider.from_address("você@seudominio.com")

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

Flask — início rápido

from flask import Flask, jsonify
from l402kit import l402_required, ManagedProvider

app = Flask(__name__)
lightning = ManagedProvider.from_address("você@seudominio.com")

@app.get("/premium")
@l402_required(price_sats=100, lightning=lightning)
def premium():
    return jsonify({"data": "Pagamento confirmado."})

Por que não Pix / Stripe?

Español

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

from fastapi import FastAPI, Request
from l402kit import l402_required, ManagedProvider

app = FastAPI()
lightning = ManagedProvider.from_address("tu@tudominio.com")

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

Italiano

Aggiungi pagamenti pay-per-call in Bitcoin Lightning a qualsiasi API Python. Funziona con FastAPI e Flask.

FastAPI — avvio rapido

from fastapi import FastAPI, Request
from l402kit import l402_required, ManagedProvider

app = FastAPI()
lightning = ManagedProvider.from_address("tu@tudominio.com")

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

Flask — avvio rapido

from flask import Flask, jsonify
from l402kit import l402_required, ManagedProvider

app = Flask(__name__)
lightning = ManagedProvider.from_address("tu@tudominio.com")

@app.get("/premium")
@l402_required(price_sats=100, lightning=lightning)
def premium():
    return jsonify({"data": "Pagamento confermato."})

Perché non Stripe?

Sovereign mode — bring your own Lightning wallet (0% fee)

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 started in seconds

Managed mode — just pass your Lightning address. l402kit.com handles invoices and routes 99.7% to you. 0.3% flat fee.

Sovereign mode (0% fee) — sign up at dashboard.blink.sv (free, no credit card) and use BlinkProvider with your API key.

Links

License

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

Built with ⚡ by ShinyDapps