对象上已设置的元数据通常不会被同时创建的关联对象“继承”或复制到该关联对象。例如,余额交易不会继承创建余额交易的收款上先前已设置的元数据。
存在以下一些重要的例外情况。PaymentIntent 确认后,Stripe 会将其元数据连同一些其他字段一起复制到 PaymentIntent 创建的“收款”。但是,这是一次性事件,后续对 PaymentIntent 元数据的更新不会更新“收款”元数据,后者必须单独更新。
此外,对于类型为“订阅”的账单行项目,账单行项目元数据将从账单所属订阅的元数据中复制。
此外,还提供以下一些具有用于设置关联对象元数据的专用参数的 Stripe 对象。示例包括:
通过设置 subscription_data.metadata,可以在订阅模式下设置为 Checkout Session 创建的订阅元数据。将来对订阅元数据的任何更新都应直接在订阅对象上完成,或通过修改订阅计划的各个阶段来完成。
订阅计划可用于通过设置 phases.metadata 来更新基础订阅元数据。[0]当计划过渡到每个阶段时,Stripe 会根据 phases.metadata 的内容更新订阅元数据。有关此工作机制的更多信息,请参阅我们文档中的指南。