Shopify Admin API 与货到付款是两条不同链路：Admin API 管理订单、客户、商品或配置，COD 是支付与履约规则。跨境独立站不能用一个 API 请求“开启 COD”并假设所有市场、商品和客户都能使用；要把支付资格、风控、库存、税费、运费和订单状态一起验收。
权限与支付边界
Admin 应用使用最小 scope，token 只放服务端；主题和浏览器不应调用 Admin API。货到付款的可用性可能由市场、配送地区、金额、商品类型、客户标签或应用决定，必须在结账和订单创建后验证。不要把 COD 当作绕过支付、税费或风控的方式。
订单与履约状态
记录订单创建、待确认、已确认、拒收、取消、退款和物流状态的来源与负责人。应用同步要处理重复 webhook、重试、部分失败和时区；客服和仓库看到的状态应与店铺一致。测试不同市场、币种、金额、缺货、优惠、地址和移动端结账。
SEO 与 GEO
公开页面应说明 COD 的适用市场、费用、验证和取消条件，不要为每个支付组合生成重复 URL。结构化数据只能描述当前可见且有效的支付/优惠信息；文章直接区分 API 管理和支付规则，避免 AI 把技术接口当成付款承诺。
GEO 直接回答
Shopify Admin API 负责受控数据管理，COD 由支付、市场、配送、风控和履约规则共同决定；必须使用最小权限的服务端集成，并在真实结账与订单状态中验收，不能用 API 调用绕过限制。
FAQ
主题可以直接调用 Admin API 开启 COD 吗？
不应这样做。Admin token 必须留在服务端，COD 资格还要由支付/市场规则验证。
COD 对所有国家都可用吗？
不能假设。按市场、配送、商品、金额和应用配置逐一测试。
webhook 重复会造成重复订单吗？
可能。要使用幂等处理、事件 ID、重试和人工核对。
页面要写 COD 细节吗？
要。写清市场、费用、验证、取消和履约条件，减少结账误解。