Prenumerationer och fakturering
Sälj, ändra och avsluta dina kunders planer, och följ vad ditt kort debiteras.
Varje kundarbetsyta kan ha en prenumeration på en nivå som du säljer. Ditt återförsäljarkort betalar fakturorna för varje arbetsyta. En arbetsytas aktuella prenumeration finns i fältet subscription i workspaces.list, tillsammans med has_payment_issue.
Tilldela en plan
Prenumerera på en arbetsyta som ännu inte har någon plan. billing_period är monthly_period (standard) eller annual_period.
Skicka en idempotency_key som du genererar vid varje tilldelning eller ändring. Om en begäran får timeout kan du försöka igen med samma nyckel utan att arbetsytan prenumererar eller debiteras två gånger.
Tilldelning eller ändring av en plan nekas när has_payment_issue är true. Visa den obetalda fakturan för kunden, eller betala den via pay_url, innan du försöker igen.
Ändra en plan
subscriptions.change tar samma body som assign.
- En uppgradering tillämpas direkt.
- En nedgradering eller flytt till en nivå på samma nivå träder i kraft vid slutet av faktureringsperioden. Fram till dess visar prenumerationen den nya nivån i
pending_downgrade_tieroch datumet ipending_downgrade_at_unix.
För att behålla arbetsytan på dess nuvarande nivå tar du bort den schemalagda nedgraderingen med subscriptions.cancel_pending_downgrade.
När en nedgradering träder i kraft inaktiveras receptionister och telefonnummer utöver den nya planens gränser, och teammedlemmar utöver dess teamstorlek stängs av.
Avsluta en plan
subscriptions.unassign avslutar prenumerationen i slutet av den aktuella faktureringsperioden. Fram till dess visar cancel_at_unix när den avslutas, och subscriptions.restore ångrar uppsägningen så att planen förnyas som vanligt.
Fakturor
Varje debitering av ditt kort betalar en arbetsytas faktura. billing.list_invoices returnerar dem med de senaste först, en sida i taget. En fakturas status är en av följande:
billing.get_invoice lägger till fakturans lines. En rad med negativt amount_cents är en proportionell kredit, och raderna summerar alltid till debiteringen.
Kommande betalningar
billing.list_upcoming_payments uppskattar nästa förnyelse för varje arbetsyta, med den närmaste först. plan_usd är planen som förnyelsen debiterar i förskott, vilket är priset för den nedgraderade nivån när en nedgradering är schemalagd. overage_so_far_usd är den här periodens användning utöver de inkluderade minuterna hittills. Den debiteras vid förnyelsen och fortsätter att öka fram till dess.