Ir para a navegação

Assinaturas e cobrança

Venda, altere e encerre os planos dos seus clientes e acompanhe as cobranças no seu cartão.

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.

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",
)

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.

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

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.

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

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:

StatusSignificado
paidO cartão foi cobrado.
openO cartão ainda está sendo cobrado novamente. pay_url leva a uma página de pagamento.
voidAs 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.

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)

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á.

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,
)