ILP-Micropayments

AI-Agents koennen thelawin.dev ohne Subscription oder menschlichen Account nutzen. Jeder API-Call wird einzeln per Interledger Protocol (ILP) ueber Chimoney bezahlt.

Voraussetzungen

• ILP-kompatibles Wallet mit Payment Pointer (z.B. via Chimoney, Uphold oder GateHub)
• Kein API-Key noetig — ILP ersetzt die Authentifizierung

Architektur

AI Agent
  │
  ├─ POST /v1/generate
  │    X-Payment: ilp
  │    X-ILP-Pointer: $agent.wallet/pointer
  │    Body: { Rechnungs-JSON }
  │
  ├─ thelawin.dev API
  │    ├─ Validiert Request
  │    ├─ Initiiert ILP-Zahlung via Chimoney (< 2s)
  │    ├─ Generiert PDF bei Erfolg
  │    └─ Gibt Response + Payment-Receipt zurueck
  │
  └─ Agent erhaelt PDF + Receipt

Preise

Aktuelle Preise jederzeit abrufbar:

curl https://api.thelawin.dev/v1/pricing

Endpoint	Preis	Beschreibung
/v1/generate	$0,05	E-Rechnung generieren (PDF/XML)
/v1/retrieve	$0,05	Rechnungsdaten aus PDF/XML extrahieren
/v1/validate	Kostenlos	Rechnungs-JSON validieren

Verwendung

Headers

X-Payment: ilp
X-ILP-Pointer: $your.wallet/pointer

Rechnung generieren (curl)

curl -X POST https://api.thelawin.dev/v1/generate \
  -H "Content-Type: application/json" \
  -H "X-Payment: ilp" \
  -H "X-ILP-Pointer: \$wallet.example/myagent" \
  -d '{
    "template": "minimal",
    "invoice": {
      "number": "ILP-2026-001",
      "date": "2026-04-23",
      "seller": { "name": "Agent Corp", "country": "DE" },
      "buyer": { "name": "Client GmbH", "country": "DE" },
      "items": [{ "description": "Dienstleistung", "quantity": 1, "unit_price": 100, "vat_rate": 19 }]
    }
  }'

Response mit Payment-Receipt

{
  "pdf_base64": "JVBERi0xLjcK...",
  "filename": "rechnung-ILP-2026-001.pdf",
  "format": {
    "format_used": "zugferd",
    "profile": "EN16931",
    "version": "2.4"
  },
  "payment": {
    "payment_method": "ilp",
    "transaction_id": "tx_abc123",
    "amount": "0.0500",
    "currency": "USD",
    "settled_at": "2026-04-23T12:00:00Z",
    "payment_pointer": "$wallet.example/myagent"
  }
}

Fehlerbehandlung

HTTP Status	Error Code	Bedeutung
400	missing_ilp_pointer	X-ILP-Pointer Header fehlt
402	payment_failed	ILP-Settlement fehlgeschlagen
402	ilp_disabled	ILP-Zahlungen nicht aktiviert
429	rate_limited	Zu viele Requests von diesem Payment Pointer

Rate Limits

ILP-Calls haben separate Rate Limits: 60 Requests pro Minute pro Payment Pointer.

ILP vs. Subscription

	ILP (Pay-per-Call)	Subscription
Account noetig	Nein	Ja
Preis	$0,05/Call	Ab $0,025/Call (Pro)
Wasserzeichen	Nein	Nur Sandbox
Ideal fuer	Ad-hoc Agent-Nutzung	Vielnutzer