Abbonamenti e fatturazione
Ogni workspace del cliente può avere un abbonamento a un livello che vendi. La carta del tuo account rivenditore paga le fatture di tutti i workspace. L’abbonamento attuale di un workspace è nel campo subscription di workspaces.list, insieme a has_payment_issue.
Assegna un piano
Abbonati a un workspace che non ha ancora un piano. billing_period può essere monthly_period (il valore predefinito) o annual_period.
Invia un idempotency_key generato da te per ogni assegnazione o modifica. Se una richiesta va in timeout, riprovarla con la stessa chiave non può abbonare o addebitare il workspace due volte.
L’assegnazione o la modifica di un piano viene rifiutata se has_payment_issue è true. Mostra la fattura non pagata al cliente oppure pagala tramite il relativo pay_url prima di riprovare.
Modifica un piano
subscriptions.change accetta lo stesso body di assign.
- Un upgrade viene applicato immediatamente.
- Un downgrade o il passaggio a un livello dello stesso livello entra in vigore alla fine del periodo di fatturazione. Fino ad allora, l’abbonamento mostra il nuovo livello in
pending_downgrade_tiere la data inpending_downgrade_at_unix.
Per mantenere il workspace sul livello attuale, annulla il downgrade programmato con subscriptions.cancel_pending_downgrade.
Quando un downgrade entra in vigore, le receptionist e i numeri di telefono oltre i limiti del nuovo piano vengono disattivati, mentre i membri del team oltre la dimensione prevista vengono sospesi.
Termina un piano
subscriptions.unassign termina l’abbonamento alla fine del periodo di fatturazione corrente. Fino ad allora, cancel_at_unix indica quando termina, mentre subscriptions.restore annulla la cancellazione affinché il piano si rinnovi normalmente.
Fatture
Ogni addebito sulla tua carta paga la fattura di un workspace. billing.list_invoices le restituisce dalla più recente, una pagina alla volta. Lo status di una fattura può essere:
billing.get_invoice aggiunge le lines della fattura. Una riga con amount_cents negativo è un credito di ripartizione proporzionale e la somma delle righe corrisponde sempre all’addebito.
Pagamenti imminenti
billing.list_upcoming_payments stima il prossimo rinnovo di ogni workspace, a partire da quello più vicino. plan_usd è il piano addebitato in anticipo al rinnovo, ovvero il prezzo del livello con downgrade quando è programmato un downgrade. overage_so_far_usd è l’utilizzo di questo periodo che finora supera i minuti inclusi. Viene addebitato al rinnovo e continua a crescere fino ad allora.