> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Abonnementverwaltung

> Wählen Sie einen Plan, abonnieren Sie über den Checkout, verwalten Sie Add-ons und wickeln Sie die Kündigung über die API oder Konsole ab.

Sie können Ihren gesamten Abrechnungslebenszyklus über die API oder die Konsole verwalten. Dieser Leitfaden behandelt, wie Sie Pläne auflisten, Kosten schätzen, eine Checkout-Sitzung erstellen, Ihr Abonnement überprüfen, Add-ons hinzufügen und bei Bedarf kündigen.

## Voraussetzungen

* Ein Truthlocks-Konto mit einem aktiven Mandanten.
* Ein API-Schlüssel mit Abrechnungsberechtigungen. Siehe [API-Schlüssel](https://docs.truthlocks.com/de/api-reference/api-keys/create.md), um einen zu erstellen.

## Einen Plan auswählen

Truthlocks bietet fünf Planstufen an. Verwenden Sie den Endpunkt 'plans', um den vollständigen Katalog abzurufen – dies ist ein öffentlicher Endpunkt und erfordert keine Authentifizierung.

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/plans
```

```json theme={null}
[
  {
    "key": "plan_developer",
    "name": "Developer",
    "price": 0,
    "currency": "USD",
    "interval": "month",
    "features": ["500 mints/month", "Plan-dependent verifications", "Community support"],
    "highlight": false
  },
  {
    "key": "plan_starter",
    "name": "Starter",
    "price": 29,
    "currency": "USD",
    "interval": "month",
    "features": ["Higher quotas", "3 webhook endpoints", "Priority processing"],
    "highlight": true
  }
]
```

Einen Vergleich aller Pläne finden Sie unter [Abrechnungsübersicht](https://docs.truthlocks.com/de/billing/overview.md#plan-tiers).

## Ihre Kosten schätzen

Vor dem Abonnement verwenden Sie den Schätzungsendpunkt, um eine Planempfehlung basierend auf Ihrer erwarteten Nutzung zu erhalten. Dies ist auch ein öffentlicher Endpunkt.

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/estimate \
  -H "Content-Type: application/json" \
  -d '{
    "country_code": "US",
    "expected_verifications_monthly": 10000,
    "team_seats": 5,
    "webhook_endpoints_needed": 5,
    "storage_gb": 10
  }'
```

Die Antwort enthält einen empfohlenen Plan und eine geschätzte monatliche Gesamtsumme. Für eine detaillierte Kostenaufschlüsselung verwenden Sie stattdessen den Endpunkt [projected invoice](https://docs.truthlocks.com/de/api-reference/billing/projected-invoice.md).

## Aktuelle Tarife prüfen

Die effektiven nutzungsbasierten Tarife Ihres Mandanten hängen von Ihrer Preisliste und Region ab. Rufen Sie sie ab mit:

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/rates \
  -H "X-API-Key: tl_live_..."
```

Die Antwort enthält Basistarife und alle regionalen Preisanpassungen:

```json theme={null}
{
  "rate_card": { "id": "rc_default", "name": "Standard Rates", "currency": "USD" },
  "items": [
    { "metric": "attestations.mint", "unit_price": 25, "volume_min": 0, "volume_max": 0 },
    { "metric": "verifications", "unit_price": 10, "volume_min": 0, "volume_max": 0 }
  ],
  "is_default": true,
  "regional_rates": {
    "region": "TIER_1",
    "multiplier": 1.0,
    "mint_rate_cents": 25,
    "verify_rate_cents": 10
  }
}
```

> [!NOTE]
>
> Wenn Ihre Organisation eine benutzerdefinierte Preisliste von einem Plattformadministrator zugewiesen bekommen hat, erscheinen diese Preise hier anstelle der Standardpreise.

## Einen Plan abonnieren

Erstellen Sie eine Checkout-Sitzung, um Ihr Abonnement zu starten oder zu aktualisieren. Der Abrechnungsdienst wählt automatisch den richtigen Zahlungsanbieter für Ihre Region aus.

**1. Eine Checkout-Sitzung erstellen**

Rufen Sie den Checkout-Endpunkt mit dem gewünschten Plan und den Weiterleitungs-URLs auf:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/checkout \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "plan_key": "STARTER",
    "success_url": "https://yourapp.com/billing?success=true",
    "cancel_url": "https://yourapp.com/billing?canceled=true"
  }'
```

Die Antwort enthält eine `checkout_url`, die vom Zahlungsanbieter gehostet wird.

**2. Zur Kasse weiterleiten**

Senden Sie den Benutzer an die `checkout_url`, um die Zahlung abzuschließen.

```javascript theme={null}
const res = await fetch("https://api.truthlocks.com/v1/billing/checkout", {
  method: "POST",
  headers: {
    "X-API-Key": "tl_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    plan_key: "STARTER",
    success_url: `${window.location.origin}/billing?success=true`,
    cancel_url: `${window.location.origin}/billing?canceled=true`,
  }),
});
const { checkout_url } = await res.json();
window.location.href = checkout_url;
```

**3. Das Abonnement bestätigen**

Überprüfen Sie nach der Zahlung, ob das Abonnement aktiv ist:

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/subscription \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "status": "active",
  "plan_key": "plan_starter",
  "current_period_end": "2026-05-01T00:00:00Z",
  "cancel_at_period_end": false
}
```

> [!TIP]
>
> Sie können optional einen Parameter `provider` (`stripe`, `paystack` oder `flutterwave`) übergeben, um das automatische regionenbasierte Routing zu überschreiben. Details finden Sie unter [Anbieter-Routing](https://docs.truthlocks.com/de/billing/provider-routing.md).

## Add-ons anhängen

Add-ons erweitern Ihren Plan um zusätzliche Funktionen. Fügen Sie sie über die API hinzu:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/addons/attach \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "addon_key": "addon_seat",
    "quantity": 2
  }'
```

Wenn das Add-on einen Preis hat, enthält die Antwort einen `checkout_url` zur Zahlungsabwicklung. Kostenlose Add-ons werden sofort aktiviert.

> [!NOTE]
>
> Die Preise für Add-ons passen sich automatisch an das Abrechnungsland Ihrer Organisation an. Mieter in kostengünstigeren Regionen zahlen einen reduzierten Satz – zum Beispiel kostet das Compliance Pack in Nigeria 149,50 $/Monat (0,5x Multiplikator) anstelle des Basispreises von 299 $. Die vollständige Stufentabelle finden Sie unter [regionale Add-on-Preise](https://docs.truthlocks.com/de/billing/overview.md#regional-add-on-pricing).

Um ein Add-on zu entfernen:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/addons/detach \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"addon_key": "addon_seat"}'
```

Den vollständigen Add-on-Katalog und Details zur Antwort finden Sie unter [Add-ons verwalten](https://docs.truthlocks.com/de/api-reference/billing/addons.md).

## Nutzung überwachen

Verfolgen Sie Ihren aktuellen Abrechnungszyklusverbrauch, um innerhalb Ihrer Planlimits zu bleiben:

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/usage \
  -H "X-API-Key: tl_live_..."
```

Um vor der Durchführung einer Operation zu prüfen, ob diese innerhalb des Kontingents liegt:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/limits/check \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"metric": "attestations.mint", "amount": 1}'
```

## Abrechnungsportal öffnen

Leiten Sie Benutzer zu ihrem Self-Service-Portal des Zahlungsanbieters weiter, um Zahlungsmethoden zu aktualisieren, Rechnungen anzuzeigen oder ihr Abonnement zu verwalten:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/portal \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "return_url": "https://yourapp.com/settings/billing"
  }'
```

Die Antwort enthält eine `portal_url`. Leiten Sie den Benutzer zu dieser URL weiter. Portal-Sitzungen laufen schnell ab, generieren Sie daher jedes Mal eine neue URL.

## Abonnement kündigen

Um zu kündigen, rufen Sie den Kündigungs-Endpunkt auf. Die Kündigung wird am Ende des aktuellen Abrechnungszeitraums wirksam – bis dahin behalten Sie vollen Zugriff.

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/cancel \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "status": "active",
  "plan_key": "plan_starter",
  "current_period_end": "2026-05-01T00:00:00Z",
  "cancel_at_period_end": true
}
```

Nach Ablauf des Zeitraums wird Ihr Konto auf den Developer (kostenlos)-Plan herabgestuft. Um sich erneut anzumelden, erstellen Sie eine neue [Checkout-Sitzung](https://docs.truthlocks.com/de/api-reference/billing/checkout.md).

> [!WARNING]
>
> Sie können eine Stornierung nicht über die API rückgängig machen. Um Ihr Abonnement fortzusetzen, müssen Sie den Bestellvorgang erneut durchlaufen.

## Verwandt

> [card] [Billing-Übersicht](https://docs.truthlocks.com/billing/overview.md)
>
> Planen Sie Tarifstufen, Tarife, Berechtigungen und Add-ons.

> [card] [Anbieter-Routing](https://docs.truthlocks.com/billing/provider-routing.md)
>
> Wie Zahlungen nach Region weitergeleitet werden.

> [card] [Billing API-Referenz](https://docs.truthlocks.com/api-reference/billing/config.md)
>
> Vollständige Referenz des Billing-API-Endpunkts.

> [card] [Berechtigungen](https://docs.truthlocks.com/api-reference/billing/entitlements.md)
>
> Überprüfen Sie Ihre aktiven Funktionen und Kontingente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.