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

# Abonnements et facturation

Chaque Workspace client peut avoir un abonnement à un niveau que vous vendez. Votre carte de revendeur règle les factures de chaque Workspace. L'abonnement actuel d'un Workspace figure dans le champ `subscription` de `workspaces.list`, avec `has_payment_issue`.

## Attribuer un forfait

Abonnez un Workspace qui n'a pas encore de forfait. `billing_period` vaut `monthly_period` (valeur par défaut) ou `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" }'
```

Envoyez une `idempotency_key` que vous générez pour chaque attribution ou modification. Si une requête expire, la réessayer avec la même clé ne peut pas abonner ou facturer deux fois le Workspace.

L'attribution ou la modification d'un forfait est refusée tant que `has_payment_issue` vaut `true`. Présentez la facture impayée à votre client, ou réglez-la via son `pay_url`, avant de réessayer.

## Modifier un forfait

`subscriptions.change` accepte le même corps que `assign`.

* Un upgrade s'applique immédiatement.
* Un downgrade ou le passage à un niveau équivalent prend effet à la fin de la période de facturation. D'ici là, l'abonnement affiche le nouveau niveau dans `pending_downgrade_tier` et la date dans `pending_downgrade_at_unix`.

Pour conserver le Workspace sur son niveau actuel, annulez le downgrade programmé avec `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"
```

Lorsqu'un downgrade prend effet, les réceptionnistes et numéros de téléphone qui dépassent les limites du nouveau forfait sont désactivés, et les membres de l'équipe qui dépassent sa taille d'équipe sont suspendus.

## Résilier un forfait

`subscriptions.unassign` met fin à l'abonnement à la fin de la période de facturation en cours. D'ici là, `cancel_at_unix` indique sa date de fin, et `subscriptions.restore` annule la résiliation afin que le forfait se renouvelle normalement.

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

## Factures

Chaque débit sur votre carte règle la facture d'un Workspace. `billing.list_invoices` les renvoie de la plus récente à la plus ancienne, une page à la fois. Le `status` d'une facture est l'un des suivants :

| Statut | Signification                                                                                            |
| ------ | -------------------------------------------------------------------------------------------------------- |
| `paid` | La carte a été débitée.                                                                                  |
| `open` | Les tentatives de débit de la carte sont toujours en cours. `pay_url` renvoie vers une page de paiement. |
| `void` | Les tentatives sont épuisées et le forfait du Workspace a été résilié.                                   |

`billing.get_invoice` ajoute les `lines` de la facture. Une ligne dont `amount_cents` est négatif correspond à un crédit au prorata, et la somme des lignes correspond toujours au débit.

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

## Paiements à venir

`billing.list_upcoming_payments` estime le prochain renouvellement de chaque Workspace, du plus proche au plus éloigné. `plan_usd` correspond au forfait facturé à l'avance lors du renouvellement, soit le prix du niveau après downgrade lorsqu'un downgrade est programmé. `overage_so_far_usd` correspond à l'utilisation de la période en cours qui dépasse jusqu'ici les minutes incluses. Elle est facturée lors du renouvellement et continue d'augmenter jusque-là.

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