应用订阅升级后补差金额为什么不是差价

现象#

商家从 10 美元套餐升到 30 美元，当天账单只补了十几美元，财务按差价 20 美元对账，怎么也对不上。

原因#

• 升级时 Shopify 按当前周期的剩余天数折算差价，不是补全额
• 旧订阅未用完的部分按比例退回，账单上是一条退款加一条新收费
• replacementBehavior 不同会导致先退后收或直接叠加
• 在试用期内升级时，剩余的试用天数也不会参与比例折算

处理步骤#

1. 先查旧订阅的 currentPeriodEnd，算出剩余天数占比
2. 调用订阅接口时显式设置 replacementBehavior
3. 在确认页向商家说明按天折算规则，避免按差价预期扯皮
4. 用返回的 lineItems 核对新旧价格与计费周期
5. 对账以后台 Billing 的 App charges 两条记录为准

验收标准#

退款金额与新订阅首期金额相加，等于按剩余天数折算出的差价。