Suscripciones y facturación
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.
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_tiery la fecha enpending_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.
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.
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:
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.
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.