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

# Abonnementen en facturering

Elke klantworkspace kan één abonnement hebben op een tier die je verkoopt. Je resellerkaart betaalt de facturen van elke workspace. Het huidige abonnement van een workspace staat in het veld `subscription` van `workspaces.list`, samen met `has_payment_issue`.

## Wijs een abonnement toe

Abonneer een workspace die nog geen abonnement heeft. `billing_period` is `monthly_period` (de standaardwaarde) of `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" }'
```

Stuur bij elke toewijzing of wijziging een zelf gegenereerde `idempotency_key`. Als een request een time-out krijgt, kun je deze met dezelfde sleutel opnieuw proberen zonder dat de workspace twee keer wordt geabonneerd of belast.

Het toewijzen of wijzigen van een abonnement wordt geweigerd zolang `has_payment_issue` `true` is. Toon de onbetaalde factuur aan je klant, of betaal deze via de bijbehorende `pay_url`, voordat je het opnieuw probeert.

## Wijzig een abonnement

`subscriptions.change` gebruikt dezelfde body als `assign`.

* Een upgrade gaat onmiddellijk in.
* Een downgrade of overstap naar een tier op hetzelfde niveau gaat in aan het einde van de factureringsperiode. Tot die tijd toont het abonnement de nieuwe tier in `pending_downgrade_tier` en de datum in `pending_downgrade_at_unix`.

Om de workspace op de huidige tier te houden, verwijder je de geplande downgrade met `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"
```

Wanneer een downgrade ingaat, worden receptionistes en telefoonnummers boven de limieten van het nieuwe abonnement gedeactiveerd, en worden teamleden boven de teamgrootte ervan geschorst.

## Beëindig een abonnement

`subscriptions.unassign` beëindigt het abonnement aan het einde van de huidige factureringsperiode. Tot die tijd toont `cancel_at_unix` wanneer het eindigt, en met `subscriptions.restore` maak je de annulering ongedaan zodat het abonnement normaal wordt verlengd.

```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"
```

## Facturen

Elke afschrijving op je kaart betaalt de factuur van één workspace. `billing.list_invoices` retourneert deze van nieuw naar oud, één pagina tegelijk. De `status` van een factuur is een van de volgende:

| Status | Betekenis                                                                                     |
| ------ | --------------------------------------------------------------------------------------------- |
| `paid` | De kaart is belast.                                                                           |
| `open` | Er worden nog pogingen gedaan om de kaart te belasten. `pay_url` linkt naar een betaalpagina. |
| `void` | De herhaalde pogingen zijn uitgeput en het abonnement van de workspace is beëindigd.          |

`billing.get_invoice` voegt de `lines` van de factuur toe. Een regel met een negatieve `amount_cents` is een verrekeningscredit en de regels tellen altijd op tot de afschrijving.

```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"
```

## Aankomende betalingen

`billing.list_upcoming_payments` schat de volgende verlenging van elke workspace, met de eerstvolgende bovenaan. `plan_usd` is het abonnement dat vooraf bij de verlenging in rekening wordt gebracht: bij een geplande downgrade is dit de prijs van de downgraded tier. `overage_so_far_usd` is het gebruik in deze periode boven de inbegrepen minuten tot nu toe. Dit wordt bij de verlenging in rekening gebracht en blijft tot dan oplopen.

```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"
```