Abonnements und Abrechnung
Verkaufen, ändern und beenden Sie die Tarife Ihrer Kunden und verfolgen Sie, was Ihrer Karte belastet wird.
Jeder Kunden-Workspace kann ein Abonnement für einen von Ihnen angebotenen Tarif haben. Ihre Reseller-Karte bezahlt die Rechnungen aller Workspaces. Das aktuelle Abonnement eines Workspace steht zusammen mit has_payment_issue im Feld subscription von workspaces.list.
Tarif zuweisen
Abonnieren Sie einen Workspace, der noch keinen Tarif hat. billing_period ist monthly_period (der Standard) oder annual_period.
Senden Sie bei jeder Zuweisung oder Änderung einen von Ihnen generierten idempotency_key. Wenn eine Anfrage eine Zeitüberschreitung verursacht, kann ein erneuter Versuch mit demselben Schlüssel den Workspace nicht doppelt abonnieren oder belasten.
Die Zuweisung oder Änderung eines Tarifs wird abgelehnt, solange has_payment_issue den Wert true hat. Zeigen Sie Ihrem Kunden die unbezahlte Rechnung oder bezahlen Sie sie über ihre pay_url, bevor Sie es erneut versuchen.
Tarif ändern
subscriptions.change verwendet denselben Body wie assign.
- Ein Upgrade wird sofort angewendet.
- Ein Downgrade oder Wechsel zu einem Tarif auf derselben Stufe wird am Ende des Abrechnungszeitraums wirksam. Bis dahin zeigt das Abonnement den neuen Tarif in
pending_downgrade_tierund das Datum inpending_downgrade_at_unix.
Damit der Workspace beim aktuellen Tarif bleibt, entfernen Sie das geplante Downgrade mit subscriptions.cancel_pending_downgrade.
Wenn ein Downgrade wirksam wird, werden Rezeptionen und Telefonnummern über den Limits des neuen Tarifs deaktiviert und Teammitglieder über die Teamgröße des Tarifs hinaus gesperrt.
Tarif beenden
subscriptions.unassign beendet das Abonnement am Ende des aktuellen Abrechnungszeitraums. Bis dahin zeigt cancel_at_unix den Zeitpunkt der Beendigung an. Mit subscriptions.restore können Sie die Kündigung rückgängig machen, sodass der Tarif normal verlängert wird.
Rechnungen
Jede Belastung Ihrer Karte bezahlt die Rechnung eines Workspace. billing.list_invoices gibt sie jeweils seitenweise zurück, die neuesten zuerst. Der status einer Rechnung ist einer der folgenden:
billing.get_invoice ergänzt die lines der Rechnung. Eine Zeile mit einem negativen amount_cents ist eine anteilige Gutschrift. Die Summe aller Zeilen entspricht immer der Belastung.
Anstehende Zahlungen
billing.list_upcoming_payments schätzt die nächste Verlängerung jedes Workspace, die früheste zuerst. plan_usd ist der Tarif, der bei der Verlängerung im Voraus berechnet wird. Bei einem geplanten Downgrade ist dies der Preis des niedrigeren Tarifs. overage_so_far_usd ist die bisherige Nutzung dieses Zeitraums über die enthaltenen Minuten hinaus. Sie wird bei der Verlängerung berechnet und steigt bis dahin weiter an.