> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Abonnements und Abrechnung

Jeder Kunden-Workspace kann ein Abonnement für einen von Ihnen angebotenen Tarif haben. Ihre Reseller-Karte bezahlt die Rechnungen aller Workspaces. Das aktuelle Abonnement eines Workspace steht zusammen mit `has_payment_issue` im Feld `subscription` von `workspaces.list`.

## Tarif zuweisen

Abonnieren Sie einen Workspace, der noch keinen Tarif hat. `billing_period` ist `monthly_period` (der Standard) oder `annual_period`.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.reception.subscriptions.assign(
    "8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7",
    tier_id="smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
    billing_period="annual_period",
    idempotency_key="assign-8f1c2a7e-2026-11-03",
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.reception.subscriptions.assign("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7", {
  tierId: "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
  billingPeriod: "annual_period",
  idempotencyKey: "assign-8f1c2a7e-2026-11-03",
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tier_id": "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0", "billing_period": "annual_period", "idempotency_key": "assign-8f1c2a7e-2026-11-03" }'
```

Senden Sie bei jeder Zuweisung oder Änderung einen von Ihnen generierten `idempotency_key`. Wenn eine Anfrage eine Zeitüberschreitung verursacht, kann ein erneuter Versuch mit demselben Schlüssel den Workspace nicht doppelt abonnieren oder belasten.

Die Zuweisung oder Änderung eines Tarifs wird abgelehnt, solange `has_payment_issue` den Wert `true` hat. Zeigen Sie Ihrem Kunden die unbezahlte Rechnung oder bezahlen Sie sie über ihre `pay_url`, bevor Sie es erneut versuchen.

## Tarif ändern

`subscriptions.change` verwendet denselben Body wie `assign`.

* Ein Upgrade wird sofort angewendet.
* Ein Downgrade oder Wechsel zu einem Tarif auf derselben Stufe wird am Ende des Abrechnungszeitraums wirksam. Bis dahin zeigt das Abonnement den neuen Tarif in `pending_downgrade_tier` und das Datum in `pending_downgrade_at_unix`.

Damit der Workspace beim aktuellen Tarif bleibt, entfernen Sie das geplante Downgrade mit `subscriptions.cancel_pending_downgrade`.

```python
elevenlabs.reception.subscriptions.change(
    "8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7",
    tier_id="smbtier_4401k8r2d3pfw8ys6bq2n9ja7kc5",
)

elevenlabs.reception.subscriptions.cancel_pending_downgrade("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")
```

```typescript
await elevenlabs.reception.subscriptions.change("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7", {
  tierId: "smbtier_4401k8r2d3pfw8ys6bq2n9ja7kc5",
});

await elevenlabs.reception.subscriptions.cancelPendingDowngrade("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7");
```

```bash
curl -X PATCH "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tier_id": "smbtier_4401k8r2d3pfw8ys6bq2n9ja7kc5" }'

curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription/cancel-downgrade" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

Wenn ein Downgrade wirksam wird, werden Rezeptionen und Telefonnummern über den Limits des neuen Tarifs deaktiviert und Teammitglieder über die Teamgröße des Tarifs hinaus gesperrt.

## Tarif beenden

`subscriptions.unassign` beendet das Abonnement am Ende des aktuellen Abrechnungszeitraums. Bis dahin zeigt `cancel_at_unix` den Zeitpunkt der Beendigung an. Mit `subscriptions.restore` können Sie die Kündigung rückgängig machen, sodass der Tarif normal verlängert wird.

```python
elevenlabs.reception.subscriptions.unassign("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")

elevenlabs.reception.subscriptions.restore("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")
```

```typescript
await elevenlabs.reception.subscriptions.unassign("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7");

await elevenlabs.reception.subscriptions.restore("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7");
```

```bash
curl -X DELETE "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription/restore" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

## Rechnungen

Jede Belastung Ihrer Karte bezahlt die Rechnung eines Workspace. `billing.list_invoices` gibt sie jeweils seitenweise zurück, die neuesten zuerst. Der `status` einer Rechnung ist einer der folgenden:

| Status | Bedeutung                                                                                   |
| ------ | ------------------------------------------------------------------------------------------- |
| `paid` | Die Karte wurde belastet.                                                                   |
| `open` | Die Belastung der Karte wird weiterhin versucht. `pay_url` verweist auf eine Zahlungsseite. |
| `void` | Die Wiederholungsversuche sind ausgeschöpft und der Tarif des Workspace wurde beendet.      |

`billing.get_invoice` ergänzt die `lines` der Rechnung. Eine Zeile mit einem negativen `amount_cents` ist eine anteilige Gutschrift. Die Summe aller Zeilen entspricht immer der Belastung.

```python
page = elevenlabs.reception.billing.list_invoices(page_size=25)
for invoice in page.invoices:
    print(invoice.workspace_name, invoice.status, invoice.amount_cents / 100, invoice.currency)

detail = elevenlabs.reception.billing.get_invoice(page.invoices[0].invoice_id)
for line in detail.lines:
    print(line.kind, line.description, line.amount_cents)
```

```typescript
const page = await elevenlabs.reception.billing.listInvoices({ pageSize: 25 });
for (const invoice of page.invoices) {
  console.log(invoice.workspaceName, invoice.status, invoice.amountCents / 100, invoice.currency);
}

const detail = await elevenlabs.reception.billing.getInvoice(page.invoices[0].invoiceId);
for (const line of detail.lines) {
  console.log(line.kind, line.description, line.amountCents);
}
```

```bash
curl "https://api.elevenlabs.io/v1/reception/reseller/billing/invoices?page_size=25" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

## Anstehende Zahlungen

`billing.list_upcoming_payments` schätzt die nächste Verlängerung jedes Workspace, die früheste zuerst. `plan_usd` ist der Tarif, der bei der Verlängerung im Voraus berechnet wird. Bei einem geplanten Downgrade ist dies der Preis des niedrigeren Tarifs. `overage_so_far_usd` ist die bisherige Nutzung dieses Zeitraums über die enthaltenen Minuten hinaus. Sie wird bei der Verlängerung berechnet und steigt bis dahin weiter an.

```python
upcoming = elevenlabs.reception.billing.list_upcoming_payments()
for payment in upcoming.payments:
    print(
        payment.workspace_name,
        payment.subscription.billing_period_end_unix,
        payment.plan_usd + payment.overage_so_far_usd,
    )
```

```typescript
const upcoming = await elevenlabs.reception.billing.listUpcomingPayments();
for (const payment of upcoming.payments) {
  console.log(
    payment.workspaceName,
    payment.subscription.billingPeriodEndUnix,
    payment.planUsd + payment.overageSoFarUsd
  );
}
```

```bash
curl "https://api.elevenlabs.io/v1/reception/reseller/billing/upcoming" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```