订阅和账单
销售、更改和终止客户套餐,并跟踪信用卡扣款情况。
每个客户工作区可订阅一个你销售的套餐层级。推广伙伴信用卡支付每个工作区的账单。工作区当前订阅位于 workspaces.list 的 subscription 字段中,同时还包含 has_payment_issue。
分配套餐
为尚未订阅套餐的工作区订阅。billing_period 可为 monthly_period(默认)或 annual_period。
每次分配或更改套餐时,都要发送自行生成的 idempotency_key。如果请求超时,使用相同密钥重试不会导致工作区被重复订阅或重复扣款。
当 has_payment_issue 为 true 时,无法分配或更改套餐。请向客户展示未支付的账单,或通过其 pay_url 完成支付后再重试。
更改套餐
subscriptions.change 的请求体与 assign 相同。
- 升级立即生效。
- 降级或变更至同级套餐会在计费周期结束时生效。在此之前,订阅会在
pending_downgrade_tier中显示新套餐层级,并在pending_downgrade_at_unix中显示生效日期。
若要让工作区保留当前套餐层级,可使用 subscriptions.cancel_pending_downgrade 取消已安排的降级。
降级生效后,超出新套餐限制的接待员和电话号码会被停用,超出团队规模限制的成员会被暂停。
终止套餐
subscriptions.unassign 会在当前计费周期结束时终止订阅。在此之前,cancel_at_unix 会显示终止时间;subscriptions.restore 可撤销取消操作,让套餐正常续订。
账单
信用卡的每笔扣款对应支付一个工作区的账单。billing.list_invoices 按从新到旧的顺序逐页返回账单。账单的 status 可为以下值之一:
billing.get_invoice 会额外返回账单的 lines。amount_cents 为负值的条目是按比例计算的抵扣金额,所有条目之和始终等于扣款金额。
即将到期的付款
billing.list_upcoming_payments 会按时间从近到远预估每个工作区的下次续订。plan_usd 是续订时预先收取的套餐费用;若已安排降级,则为降级后套餐层级的价格。overage_so_far_usd 是当前计费周期内截至目前超出包含分钟数的用量。该费用会在续订时收取,并会持续增长至续订时。