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

# Assinaturas e cobrança

Cada espaço de trabalho de cliente pode ter uma assinatura de um nível que você vende. O cartão do seu revendedor paga as faturas de todos os espaços de trabalho. A assinatura atual de um espaço de trabalho fica no campo `subscription` de `workspaces.list`, junto com `has_payment_issue`.

## Atribua um plano

Assine um plano para um espaço de trabalho que ainda não tem um. `billing_period` é `monthly_period` (o padrão) 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" }'
```

Envie uma `idempotency_key` gerada por você em cada atribuição ou alteração. Se uma solicitação expirar, repeti-la com a mesma chave impede que o espaço de trabalho seja assinado ou cobrado duas vezes.

A atribuição ou alteração de um plano é recusada enquanto `has_payment_issue` for `true`. Mostre a fatura não paga ao seu cliente ou pague-a pelo `pay_url` antes de tentar novamente.

## Altere um plano

`subscriptions.change` recebe o mesmo corpo de `assign`.

* Um upgrade é aplicado imediatamente.
* Um downgrade ou uma mudança para um nível equivalente entra em vigor no fim do período de cobrança. Até lá, a assinatura mostra o novo nível em `pending_downgrade_tier` e a data em `pending_downgrade_at_unix`.

Para manter o espaço de trabalho no nível atual, cancele o downgrade agendado com `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"
```

Quando um downgrade entra em vigor, as recepcionistas e os números de telefone que excedem os limites do novo plano são desativados, e os membros da equipe que excedem o tamanho permitido são suspensos.

## Encerre um plano

`subscriptions.unassign` encerra a assinatura no fim do período de cobrança atual. Até lá, `cancel_at_unix` mostra quando ela termina, e `subscriptions.restore` desfaz o cancelamento para que o plano seja renovado normalmente.

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

## Faturas

Cada cobrança no seu cartão paga a fatura de um espaço de trabalho. `billing.list_invoices` as retorna da mais recente à mais antiga, uma página por vez. O `status` de uma fatura é um destes:

| Status | Significado                                                                            |
| ------ | -------------------------------------------------------------------------------------- |
| `paid` | O cartão foi cobrado.                                                                  |
| `open` | O cartão ainda está sendo cobrado novamente. `pay_url` leva a uma página de pagamento. |
| `void` | As tentativas se esgotaram e o plano do espaço de trabalho foi encerrado.              |

`billing.get_invoice` adiciona as `lines` da fatura. Uma linha com `amount_cents` negativo é um crédito proporcional, e as linhas sempre somam o valor da cobrança.

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

## Próximos pagamentos

`billing.list_upcoming_payments` estima a próxima renovação de cada espaço de trabalho, da mais próxima à mais distante. `plan_usd` é o plano cobrado antecipadamente na renovação, que corresponde ao preço do nível com downgrade quando há um downgrade agendado. `overage_so_far_usd` é o uso deste período que excede os minutos incluídos até agora. Ele é cobrado na renovação e continua aumentando até 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"
```