Saltar a la navegación

Suscripciones y facturación

Vende, cambia y cancela los planes de tus clientes, y consulta los cargos en tu tarjeta.

Cada espacio de trabajo de cliente puede tener una suscripción a un nivel que vendas. La tarjeta de tu cuenta de distribuidor paga las facturas de todos los espacios de trabajo. La suscripción actual de un espacio de trabajo está en el campo subscription de workspaces.list, junto con has_payment_issue.

Asigna un plan

Suscribe un espacio de trabajo que aún no tenga plan. billing_period puede ser monthly_period (el valor predeterminado) o 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",
)

Envía un idempotency_key que generes en cada asignación o cambio. Si se agota el tiempo de espera de una solicitud, volver a intentarlo con la misma clave evita suscribir o cobrar dos veces al espacio de trabajo.

La asignación o el cambio de plan se rechazan mientras has_payment_issue sea true. Muestra la factura impagada a tu cliente o págala mediante su pay_url antes de volver a intentarlo.

Cambia un plan

subscriptions.change acepta el mismo cuerpo que assign.

  • Una mejora de plan se aplica de inmediato.
  • Una reducción de plan o un cambio a un nivel del mismo rango entra en vigor al final del periodo de facturación. Hasta entonces, la suscripción muestra el nuevo nivel en pending_downgrade_tier y la fecha en pending_downgrade_at_unix.

Para mantener el espacio de trabajo en su nivel actual, elimina la reducción de plan programada con subscriptions.cancel_pending_downgrade.

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

Cuando entra en vigor una reducción de plan, se desactivan los recepcionistas y números de teléfono que excedan los límites del nuevo plan, y se suspenden los miembros del equipo que excedan su tamaño máximo.

Cancela un plan

subscriptions.unassign finaliza la suscripción al término del periodo de facturación actual. Hasta entonces, cancel_at_unix indica cuándo finaliza, y subscriptions.restore deshace la cancelación para que el plan se renueve normalmente.

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

Facturas

Cada cargo en tu tarjeta paga la factura de un espacio de trabajo. billing.list_invoices las devuelve de la más reciente a la más antigua, una página cada vez. El status de una factura puede ser:

EstadoSignificado
paidSe ha realizado el cargo en la tarjeta.
openSe sigue intentando realizar el cargo en la tarjeta. pay_url enlaza a una página de pago.
voidSe agotaron los reintentos y se canceló el plan del espacio de trabajo.

billing.get_invoice añade las lines de la factura. Una línea con un amount_cents negativo es un crédito por prorrateo, y las líneas siempre suman el cargo total.

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 pagos

billing.list_upcoming_payments calcula la próxima renovación de cada espacio de trabajo, empezando por la más próxima. plan_usd es el plan que se cobra por adelantado en la renovación, que corresponde al precio del nivel reducido cuando hay una reducción de plan programada. overage_so_far_usd es el uso de este periodo que hasta ahora excede los minutos incluidos. Se cobra en la renovación y sigue aumentando hasta entonces.

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