Subskrypcje i rozliczenia
Sprzedawaj, zmieniaj i kończ plany swoich klientów oraz śledź obciążenia swojej karty.
Każdy obszar roboczy klienta może mieć jedną subskrypcję poziomu, który sprzedajesz. Twoja karta partnera handlowego opłaca faktury wszystkich obszarów roboczych. Bieżąca subskrypcja obszaru roboczego znajduje się w polu subscription w workspaces.list, wraz z has_payment_issue.
Przypisz plan
Zasubskrybuj obszar roboczy, który nie ma jeszcze planu. billing_period to monthly_period (domyślnie) lub annual_period.
Przy każdym przypisaniu lub zmianie wyślij wygenerowany przez siebie idempotency_key. Jeśli żądanie przekroczy limit czasu, ponowienie go z tym samym kluczem nie zasubskrybuje ani nie obciąży obszaru roboczego dwa razy.
Przypisanie lub zmiana planu zostanie odrzucona, gdy has_payment_issue ma wartość true. Przed ponowną próbą pokaż klientowi niezapłaconą fakturę lub opłać ją przez pay_url.
Zmień plan
subscriptions.change przyjmuje ten sam body co assign.
- Przejście na wyższy plan działa od razu.
- Przejście na niższy plan lub na poziom o tej samej klasie zaczyna obowiązywać po zakończeniu okresu rozliczeniowego. Do tego czasu subskrypcja pokazuje nowy poziom w
pending_downgrade_tieri datę wpending_downgrade_at_unix.
Aby pozostawić obszar roboczy na obecnym poziomie, anuluj zaplanowane obniżenie za pomocą subscriptions.cancel_pending_downgrade.
Gdy obniżenie planu zacznie obowiązywać, recepcjoniści i numery telefonów ponad limity nowego planu zostaną wyłączeni, a członkowie zespołu ponad jego limit wielkości zespołu — zawieszeni.
Zakończ plan
subscriptions.unassign kończy subskrypcję z końcem bieżącego okresu rozliczeniowego. Do tego czasu cancel_at_unix pokazuje, kiedy się zakończy, a subscriptions.restore cofa anulowanie, aby plan odnowił się normalnie.
Faktury
Każde obciążenie twojej karty opłaca fakturę jednego obszaru roboczego. billing.list_invoices zwraca je od najnowszych, po jednej stronie naraz. status faktury ma jedną z wartości:
billing.get_invoice dodaje lines faktury. Wiersz z ujemnym amount_cents to uznanie proporcjonalne, a suma wierszy zawsze równa się obciążeniu.
Nadchodzące płatności
billing.list_upcoming_payments szacuje kolejne odnowienie każdego obszaru roboczego, od najbliższego. plan_usd to plan, za który odnowienie pobiera opłatę z góry; gdy zaplanowano obniżenie, jest to cena niższego poziomu. overage_so_far_usd to dotychczasowe użycie w tym okresie ponad zawarte w planie minuty. Zostanie naliczone przy odnowieniu i będzie rosło do tego czasu.