试用(Trials)为客户提供对某套餐的临时免费访问。它既可以在扣费(billing)调用时传入,也可以随套餐配置本身附带(该配置可被覆盖)。
用途:在 attach 时通过 free_trial 设置试用,字段包括 duration_length、duration_type(day|month|year)、card_required、on_end,且必须始终传入 duration_type。默认在无付费套餐时 card_required 为否;存在付费套餐时 on_end 默认为 revert。
主要能力与场景: 一、客户不在付费套餐(免费套餐或完全无套餐)时有两种做法。1)免卡试用(默认):attach 时设置 free_trial 且 card_required 为 false,订阅无卡开始,若未添加卡则在试用结束时终止;试用期间客户无法升级或附加其他套餐,除非通过 Stripe 计费门户添加卡。2)需卡试用:attach 时设置 free_trial、card_required 为 true 并使用 long_lived_checkout;若客户无支付方式,attach 会返回一个 checkout URL 用于收集卡信息,试用结束时扣费,此操作应配合长期有效的 checkout URL 参数进行。 二、客户已有活跃的 Stripe 订阅(常见于销售主导的试用)。1)on_end 为 revert(默认):以 on_end: "revert" attach 新套餐,在 Autumn 中授予该套餐而不改动 Stripe 订阅;试用结束时 Autumn 将客户移回原套餐,保留既有计费周期。2)on_end 为 bill:附加带试用的套餐(或更新订阅以添加试用)会重置 Stripe 的计费锚点/周期,这可能不符合预期,用户如此要求时应提醒。若已有活跃订阅,card_required 参数会被忽略。
更新或结束试用:对处于试用中的套餐调用 update_subscription 并传入新的 free_trial;时长从当前时间起算,而非原始开始时间,例如 14 天试用的第 10 天再延长 14 天,是再给 14 天而非 4 天。传入 free_trial: null 可立即结束试用。
限制:card required 参数在已有活跃订阅时被忽略;on_end: bill 会重置 Stripe 计费周期,需谨慎并提前告知。其他未在资料中说明的细节暂未提供。