支付应用API 2027-01 候选版本向信用卡支付和验证请求中添加了 payment_method.data.trusted_vault_origin。支付应用开发者可使用此可选布尔值来处理来自Shopify信任的保险库中缺少CVV的卡片。采用该功能为可选项，且需由Shopify启用。
变更内容
Shopify可在加密卡数据载荷和 trusted_vault_origin 载荷中包含 payment_instrument。请从 payment_method.data 中读取该字段，位置在加密卡详情或 payment_instrument 对象之外。
- true: 不要仅因缺少 CVV 而拒绝付款或验证。CVV 可能仍然存在。
- false 或缺失：保留该流程的现有 CVV 规则，包括接受无需 CVV 付款的流程。
继续执行您的欺诈检查、3-D Secure认证以及对任何提供的CVV的验证。该信号并不标识来源保险库。有关字段合约和载荷示例，请参阅 可信保险库来源参考。
受影响对象
这适用于处理将 payment_method.type 设置为 credit_card 的请求的支付应用。您的扩展程序必须使用 2027-01 或更高版本的API，并且Shopify必须为您的应用启用该字段。更改API版本不会自动启用该字段。
Shopify 在早期 API 版本中省略该字段，当未为您的应用启用该字段时，或当没有可发送的值时。
操作指南
无需立即进行生产环境迁移。请使用 2027-01 候选版本进行测试，并将生产环境的应用保持在受支持的稳定版本上。
为准备您的集成：
- 审查您的付款和验证处理程序。添加对可选字段及上述 CVV 处理的支持。
- 对于集成测试，请将开发扩展程序的 api_version 设置为 2027-01。在期望Shopify发送该字段之前，请确认Shopify已为您的应用启用了该字段。
- 测试 true、false 以及缺失字段的情况，涵盖有CVV和无CVV两种场景。覆盖您的应用支持的所有载荷格式，并在适用情况下对验证请求重复这些用例。确认缺少CVV不会导致针对 true 的拒绝，同时 false 和缺失情况应保留您现有的处理方式。
相关文档
- 配置支付扩展
- 测试信用卡付款请求
- Shopify API 版本控制