跨境动态

currententrychange 现在在 event.from 中返回客户账户全页扩展的上一个页面

从 API 版本 2027-01 开始，在客户账户全页扩展中，Navigation API 的 currententrychange 事件会将 event.from 设置为客户离开的页面，而不是其导航到的页面。这是一项破坏性变更

UI扩展现已支持更多语言区域

UI扩展的语言区域文件合计大小不再受256 KB限制。自2026年10月30日起，你可以为扩展添加更多语言，而不会在部署时触及合计大小限制。这适用于所有带有UI扩展的应用

Gift Card 的 line_item_id 将在 REST Admin API 2027-01 版本中变为只读

在 REST Admin API 2027-01 及更高版本中，Gift Card 资源上的 line_item_id 属性为只读。Shopify 在创建和更新请求中会忽略该属性。升级前请将其从这些请求中移除。变更内容 在 RES

Payments Apps API 中新增可信保险库来源信号

Payments Apps API 2027-01候选版本在信用卡支付和验证请求中新增了payment_method.data.trusted_vault_origin。支付应用开发者可以使用这个可选布尔值来处理来自保险库的卡片缺少CVV的情况

Shop SDK 潜在客户获取现已支持富授权请求

现在，您可以在 Shop SDK 潜在客户获取过程中请求应用所需的特定个人资料数据，包括未保存在用户 Shop 个人资料中的详细信息。使用富授权请求（RAR）来选择哪些字段为必填项，哪些为可选项

从你的应用启动 Sidekick 对话

嵌入式应用现在可以使用 Sidekick Launch API 以预填提示启动 Sidekick，因此商家无需离开你的应用即可获得情境化帮助。在你的应用内，你可以从 Shopify 管理后台中发起关于 me 的 Sidekick 对话。

版本：2026年秋季

购物车和结账永久链接现已在 /buy 支持 UCP

Shopify 店铺现已支持 UCP dev.ucp.shopping.permalink 能力，从 UCP 2026-08-25 起在新增的 /buy 路由上提供。你可以使用单个 /buy 链接将商品加入购物车、预填结账信息，并将买家引导至结账，

使用 Admin GraphQL API 将销售计划添加到草稿订单行项目

Admin GraphQL API 版本 2027-01 为草稿订单增加了销售计划支持。你现在可以将销售计划应用于草稿订单行项目，并读回已应用的计划。这些字段为新增字段，因此无需采取任何操作即可保持你的应用正常运

客户账户的首次登录现在会设置 Customer.state 并发送 customers/enable webhooks

客户首次登录客户账户时，现在会将 Customer.state 设置为 ENABLED，并发送 customers/enable 和 customers/update webhook。这与旧版客户账户中账户激活的工作方式一致。变更内容 当客户

Shopify Tax 的托管模式

Shopify Tax 托管模式通过直接管理部分商店设置和 API 行为，帮助 Shopify 对美国销售应用正确的税务处理方式。为保持这些设置一致，部分 Admin API 写入操作现在会根据相关要求进行验证，

Shopify Flow：通过 AI Toolkit 管理自动化

你现在可以使用外部代理，通过 AI Toolkit 管理你的 Shopify Flow 工作流。此版本用于通过 AI toolkit 管理你自己商店的工作流；第三方应用被禁止直接使用底层 API。变更内容

App Events：从 Checkout 和 Customer Account UI 扩展发送事件

从 API 版本 2027-01 开始，Checkout 和 Customer Account UI 扩展可以通过 shopify.appEvents.emit() 向 Shopify 发送应用事件。扩展无需网络访问或应用后端即可发送事件。这是一个新的可选 API，

使用 App Events 让您的应用活动可在 Shopify Analytics 中报告

你现在可以让商家在 Shopify Analytics 中查看你的应用活动。商家可以在报告构建器中探索你应用的指标和维度，或使用 ShopifyQL 通过 FROM app_events 查询它们。变更内容 应用现在可以

隆重推出主题应用附加组件：将应用与您的主题一起构建和打包

主题开发者现在可以使用主题应用扩展构建店铺应用，并将其与主题商店中的主题列表捆绑在一起。主题应用附加组件可扩展你的主题，提供高级功能，同时创造新的变现机会

商家电子邮件现已在 Partners API 的 `ThemeSale` 对象上提供

您现在可以在 Partner API 的 ThemeSale 对象上访问购买商家的电子邮件，这使您能够与使用您主题的商家建立联系，以提供支持、分享更新并建立持久的合作关系。提醒一下，un

Shopify App Store：估算的本地货币价格

以美元以外货币计费的商家现在可以看到您的应用以其计费货币估算的价格。您无需采取任何操作，可以继续以美元设置价格。变更内容 Shopify App Store 和

Shopify 应用定价：按套餐功能定向

您现在可以在 Shopify App Pricing 中为公开方案添加商店要求。商店不具备所需功能的商家无法订阅该方案。商店要求为可选项，因此无需采取任何操作。变更内容 该方案

在 Dev Dashboard 中管理付款、账单和设置

您现在可以在 Dev Dashboard 的组织设置中管理您的 Partner 业务详情、付款、账单以及其余的 Partner Dashboard 设置。新 Partner 也会在设置期间在那里完成业务验证。现有 Partner 则

在 Dev Dashboard 中存储商店和应用安装详情

您现在可以在 Dev Dashboard 的一个位置查看您组织已安装的应用、协作者访问权限、收益和应用活动。使用商店页面查看某个商店的应用、用户和收益：来自您组织已安装的应用

安全更新：离线令牌日期、新安全功能

10 月 20 日，我们要求所有应用开发者保护其应用的安全，并告知您我们会在任何安全变更生效之前分享更多信息。以下是新增内容以及您需要执行的操作。离线访问令牌 离线访问令牌的迁移时间表

在2027年1月1日之前迁移到会过期的离线访问令牌

仍在使用不过期离线访问令牌的公开应用必须在2027年1月1日之前迁移到会过期的离线访问令牌，才能继续在Shopify App Store中上架并继续接受新安装。新的客户端凭证访问

通过IP允许列表限制Admin API访问

您现在可以通过 IP 地址限制 Admin API 访问令牌。当您在 Dev Dashboard 中将服务器的 IP 地址添加到 IP 允许列表后，Shopify 会拒绝从任何其他位置使用您应用令牌发起的 GraphQL Admin API 和 REST Admin API 请求

在`shopify.app.toml`中使用网络访问规则保护你的应用

您现在可以在 shopify.app.toml 新增的 [network_access] 部分中声明应用的外部主机和服务器。通常，当客户导航到 Shopify 之外的 URL 时，Shopify 会向客户发出警告；声明您的外部主机即可跳过此警告，