Abonnements et facturation
Vendez, modifiez et résiliez les forfaits de vos clients, et suivez les montants facturés sur votre carte.
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.
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_tieret la date danspending_downgrade_at_unix.
Pour conserver le Workspace sur son niveau actuel, annulez le downgrade programmé avec subscriptions.cancel_pending_downgrade.
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.
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 :
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.
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à.