Shopify 应用怎么上架 App Store？审核要求、提交前检查清单与常见被拒原因

Shopify 应用有两种分发方式。按官方的应用分发说明，定制分发（custom distribution）的应用只能装在单个店铺或同一 Plus 组织下的店铺，不需要审核，但也不能通过 Shopify 的计费体系向商家收费；想出现在 Shopify App Store 里、让任何商家都能搜到和安装，就必须走公开分发并通过人工审核，依据是一份持续更新的 App Store 要求清单。很多团队第一次提交被退回，并不是功能不够好，而是安装流程、计费方式或提交材料里有硬伤。

一、审核流程大致是什么样

按官方对审核流程的说明，公开应用在合作伙伴后台会经历草稿（Draft）、已提交（Submitted）、已审阅待修改（Reviewed）、已发布（Published）几个状态。如果核心要求没满足、审核员无法开展测试，应用会进入暂停（Paused）状态。沟通都通过邮件进行，审核员会列出需要修改的地方，开发者修改后回复继续。

官方没有承诺审核时长。需要注意的是，官方提交指南提到，连续两轮以上没有解决审核员指出的问题，可能导致应用被临时暂停提交，只能等到横幅上显示的日期后再重新提交。所以与其反复试错，不如第一次就把基础项做扎实。

二、安装与授权流程

安装流程是审核员最先测试、也最容易出问题的环节。现行要求的要点：

• 商家点击安装后，应用必须立即走 OAuth 授权，在授权完成前不能让商家看到任何应用界面；重新安装时也一样，不能因为「以前装过」就跳过；
• 授权完成后要直接跳转到应用界面，不能停在空白页或报错页；
• 安装只能从 Shopify 的渠道发起，不能要求商家手动输入店铺域名；
• 嵌入式应用要使用 session token 认证，不能依赖第三方 Cookie 或本地存储，在浏览器无痕模式下也要能正常使用；
• 嵌入式应用需要在其他脚本之前加载最新版 App Bridge 的 app-bridge.js，并且不能在嵌入与非嵌入两种形态之间来回切换；
• 如果应用会修改商家的主题，需要使用主题应用扩展（theme app extension），而不是直接改主题文件。

三、计费：必须走 Shopify 的计费体系

这是一条没有例外的硬规定：上架 App Store 的应用，所有收费都必须通过 Shopify App Pricing 或 Billing API 完成，使用平台外收费的应用不能通过 App Store 分发。按官方计费文档，Shopify App Pricing 是新公开应用的默认方式，在合作伙伴后台配置套餐、按量计费和免费试用即可；用 Billing API 自行实现的手动定价仍受支持，但已属于旧方式，适合平台定价不支持的收费模式。此外：

• 商家必须能在应用内自助升级或降级套餐，不需要联系客服；
• 收费记录要能在商家后台的应用账单历史里看到；
• 应用列表里写的价格信息（包括免费试用天数、收费方式）必须准确完整，并与实际扣费一致；
• 提交前用测试模式把订阅、升降级、按量计费等路径都跑一遍，官方文档明确建议在开发店铺上测试计费流程。

对于已有独立 SaaS 产品的企业，这一条会影响商业模式：Shopify 渠道内的收费需要单独规划套餐并接入 Billing API，不能把商家引到自己的官网支付。

四、GDPR 强制合规 webhook

按官方的隐私法合规文档，每个通过 App Store 分发的应用都必须订阅三个合规 webhook，即使应用本身不收集个人数据：

• customers/data_request：顾客请求查看其被存储的数据；
• customers/redact：请求删除某位顾客的数据；
• shop/redact：请求删除店铺数据，在店主卸载应用 48 小时后发送。

实现要点：收到请求返回 2xx 状态码；HMAC 签名校验不通过时返回 401；删除或导出要在 30 天内完成，法律要求保留的数据除外。如果要读取顾客姓名、地址、电话、邮箱等字段，还需满足受保护顾客数据（protected customer data）的要求，并在合作伙伴后台单独申请。

五、应用列表：文案与截图规范

应用列表（listing）是商家在 App Store 看到的页面，审核同样严格。容易被忽略的几条：

• 应用名称要独特、可辨识，不能与其他应用、开发者、品牌或 Shopify 自家产品相同或容易混淆；后台配置的名称与提交表单里的名称要一致或相近；
• 列表文案里不能使用统计数字或数据，不能引用评价和客户证言，也要避免「第一」「最好」「唯一」这类说法；
• 价格只能写在专门的定价区域，截图、宣传图和图标里都不能出现价格；
• 截图要展示真实的应用界面和功能，不带电脑桌面背景或浏览器窗口，每张图不能重复，也不能只放一个 logo；
• 应用图标需要上传 1200×1200 像素的版本；应用使用的 URL 里不能包含「Shopify」字样。

国内团队还要特别准备测试材料：能访问全部功能的有效测试账号；演示安装引导和主要功能的录屏，语言为英文或带英文字幕；合作伙伴后台的紧急技术联系人邮箱和电话。官方提醒，材料不完整会拖慢审核，甚至导致无法通过。

六、性能要求与 Built for Shopify 的区别

上架审核是进入 App Store 的门槛；Built for Shopify 是 Shopify 给应用的最高级别认可，要在已上架的基础上满足更高标准，达到前置条件后再单独申请。

按现行的 Built for Shopify 要求，前置条件包括：来自付费套餐活跃店铺的净安装量至少 50 个、至少 5 条评价，并达到近期评分门槛。性能上，嵌入后台的界面以 28 天内至少 100 次采样的第 75 百分位计，LCP 不超过 2.5 秒、CLS 不超过 0.1、INP 不超过 200 毫秒，这几个指标就是 Core Web Vitals；影响店面的应用不能让店面的 Lighthouse 性能分下降超过 10 分；结账相关的扩展也有响应时间和失败率要求。设计上还要求遵循 Polaris 组件与后台一致的视觉。

达标的回报是：应用卡片显示 Built for Shopify 徽章，在 App Store 搜索中排序更靠前，有机会进入首页和分类页推荐，后续提交也进入优先审核队列。每项标准有三次申请机会，三次不通过会被暂停申请三个月，此后每年复审一次。

七、常见被拒原因

官方在通过审核的指南里归纳了几类最常见的问题，结合上文可以整理为：

1. 计费：价格信息不准确、商家无法自助升降级、没有使用 Shopify 的计费体系；
2. 安装：没有立即跳转到 OAuth 授权页、安装后出现致命错误、卸载后重新安装失败；
3. 嵌入：应用在嵌入和非嵌入版本之间切换；
4. 界面：安装后界面损坏无法使用，或出现 404、500 等错误页；
5. 测试材料：没有提供测试说明和账号，或提交的是不稳定的测试版；
6. 店面类应用：没有使用主题应用扩展，或插件在店面上显示异常。

八、提交前检查清单

• 在全新开发店铺上完整走一遍安装、授权、首次使用、卸载、重新安装；
• 用无痕窗口测试嵌入式应用，确认不依赖第三方 Cookie；
• 用测试模式跑通所有套餐的订阅、升级、降级与取消；
• 三个合规 webhook 已订阅，HMAC 校验失败返回 401，并有 30 天内完成删除或导出的处理流程；
• 列表文案无统计数字、无评价引用、无绝对化用语，截图与图标不含价格；
• 测试账号可用、英文演示录像已准备、紧急联系人已填写；
• 在提交页面运行自动检查并全部通过，也可用官方 AI 工具包的自检命令先扫描代码。

上架后也要考虑退出路径。按官方的应用下线说明，停止运营时要先联系 Shopify Support 并把列表设为有限可见，至少提前 30 天通知在用商家，再用 appSubscriptionCancel 取消订阅、用 appUninstall 卸载剩余安装。这些操作依赖 API 权限，要在关停服务器前完成。

如果你还在比较 Shopify 与其他建站方案，可以先看外贸独立站选型：Shopify、WooCommerce 与自研对比。大乐网络承接 Shopify 公开应用与定制应用的开发，也提供上架前的合规自查，属于我们平台与系统开发服务的一部分。