Shopify：自定义Admin API无法访问订阅合约信息，求解决方案

一、解决订阅合约访问权限问题 #

• 明确订阅API版本对应的权限：Shopify的订阅体系分新旧两套API，相关权限不会默认显示在常规Admin API权限列表中，需要手动添加：
  • 新版Subscriptions API：需在Shopify Partner后台的应用API权限中手动输入read_subscriptions（只读）或write_subscriptions（读写）
  • 旧版Recurring Billing：对应权限为read_recurring_application_charges或write_recurring_application_charges
• 权限添加与生效步骤：进入Shopify Partner后台→找到目标应用→App setup→API credentials→Admin API scopes，输入对应权限字符串后保存，必须重新将应用安装到目标店铺，新权限才能生效
• 确认API端点正确性：避免因调用错误端点触发权限报错，新版订阅端点为/admin/api/{api_version}/subscriptions.json，旧版为/admin/api/{api_version}/recurring_application_charges.json

二、无需订阅权限也能区分订单类型 #

如果暂时无法获取订阅合约权限，可直接从订单自身数据识别：

• 筛选订单标签（tags）：绝大多数订阅工具（含Shopify官方订阅）会给订阅订单添加专属标签，比如Subscription、Recurring Order，通过过滤包含这些关键词的订单即可区分
• 解析商品行项目属性（line_items[].properties）：订阅订单的商品行项目中会携带订阅相关元数据，比如subscription_id、订阅周期等自定义字段，读取这些字段即可判断订单类型
• 检查订单来源（source_name）：订阅订单的source_name字段会显示创建它的应用名称，比如Shopify Subscriptions，通过该字段可直接筛选订阅订单

三、权限生效验证 #

添加权限并重新安装应用后，使用Shopify最近3个稳定版本的API进行调用，同时确认请求使用的X-Shopify-Access-Token为重新安装后生成的有效令牌，避免因旧令牌失效导致权限报错

内容的提问来源于stack exchange，提问作者Mike