MachinePay商户入驻指南:确认多应用开通路径
我们围绕 MachinePay 商户入驻,梳理企业主体、应用身份、服务注册和支付验证之间的关系,重点回答“一个企业主体开通多个应用是否支持”。本文适合 AI API、MCP Tool、Skill 或数字内容服务的开发者、后端工程师和产品技术负责人。读完后,我们可以准备入驻材料,区分企业账号、应用和服务,完成沙箱验证,并对多个应用的开通结果做可追溯核验。
一、MachinePay前期准备:先确认主体与应用边界
1.1 适用对象与使用边界
适用场景包括:
- 我们是 API 服务商,已有可访问的服务端接口、明确的计量方式和按次收费目标,需要让 AI Agent 在调用资源时完成支付。
- 我们是 MCP Tool 或 Skill 平台商户,需要由企业主体管理多个服务,并在服务被调用时按用量收款。
- 我们已有 AI 产品和服务端账本,能够记录订单、调用、支付凭证及履约结果,希望使用 Machine Pay 完成 402 支付闭环。
不适用场景包括:
- 我们只做普通网页或 App 的人工收银,不涉及 API、MCP、Skill 或数字资源按调用收费,应改用支付宝 AI 付对应的网页或移动应用收款入口。
- 我们要做按月、按年或按席位持续收费,应评估 Token Pay,而不是把 MachinePay 当作订阅产品。
- 我们只是企业间线下合同结算,无法在服务端核验调用和履约,不建议使用 MachinePay,应先采用合同、对账和银行转账流程。
1.2 账号、权限与环境准备
- 企业支付宝账号及对应操作员权限;AI 付官网支持以企业身份进入,企业账号权限由企业管理员在商家平台设置。
- 营业执照或主体证明、统一社会信用代码、主体名称、经营地址、负责人及经办人信息、结算账户资料。
- 产品地址、服务名称、服务描述、收费对象、计量规则、退款及售后说明。
- 每个待接入应用的应用标识、签约主体和运行环境;不要把不同应用的 app_id、商户号或证书混用。
- 服务端密钥、公钥或证书,并将生产私钥保存在服务端,禁止写入客户端或明文提交代码仓库。
- 沙箱环境和可重复测试的接口;官方页面明确沙箱不使用真实资金,适合先完成集成和联调。
二、MachinePay核心内容分步实操:从入驻到支付闭环
2.1 先核对产品和商户身份
当前任务是确认我们申请的是 Machine Pay,而不是网页收款、移动应用收款、Skill Pay 或 Agent Pay。Machine Pay 的定位是面向 API、MCP、Skill、数字内容和算力资源的按量付费。我们登录支付宝 AI 付官网,以企业身份进入,并在商家平台核对可开通产品和主体状态。预期结果是明确签约主体、产品入口和操作员权限;如果跳过这一步,后续即使参数正确,也可能因为产品权限或主体状态不匹配而无法受理。
2.2 为每个应用建立身份台账
当前任务是把企业主体、应用和服务分开记录。接入文档说明,Machine Pay 支持自研商家通过自研应用,或通过第三方应用代调用并传入 app_auth_token;接口字段 seller_app_id 表示商户应用 ID。我们为每个应用记录 app_id、所属环境、对应服务、密钥归属和授权关系,再确认该应用是否具备 Machine Pay 权限。
关于“一个企业主体能否开通多个应用”,官方公开资料没有给出“一定支持”或“一定限制”的统一结论。我们不能把企业账号能管理多个服务,直接推断为企业主体必然可以开通多个应用。正确做法是:逐个提交应用身份,在控制台查看产品开通状态;若页面未展示多个应用入口,向支付宝商家平台确认该主体的应用数量、应用类型和授权方式。
⚠️ 常见错误:把同一个 app_id 复制到多个项目中。 原因:应用身份、密钥和服务归属没有分离,导致交易主体或回调归属难以核对。 解决方法:为每个项目建立应用台账,使用对应应用的凭证,并在服务端校验订单所属应用。
2.3 准备服务注册信息和价格
当前任务是让平台知道我们具体售卖什么。官方页面的服务注册支持 Restful 接口和回调接口,并要求填写服务 ID、服务名称、服务地址、服务单价、服务描述和请求示例。页面当前展示的单价范围是 0.01 元≤服务单价≤50 元,支持小数点后两位;这是页面数据,不能在业务代码中自行扩大范围。我们让服务端读取同一份价格配置,避免注册价格、账单价格和实际支付价格不一致。预期结果是服务审核通过并可被调用;跳过服务注册,应用即使已开通,也没有可计费的具体资源。
⚠️ 常见错误:注册页面填写的价格与实际支付价格不同。 原因:服务配置和订单计价使用了不同数据源。 解决方法:统一价格配置,发起支付前重新计算金额,并在测试中比对账单、订单和履约记录。
2.4 实现 402 付款挑战
当 AI Agent 请求未支付资源时,我们的服务端返回 HTTP 402 Payment Required,并在 Payment-Needed Header 中放入账单。Agent 完成用户授权和支付后,携带 Payment-Proof 重试原请求。我们服务端收到重试请求后,不直接相信客户端状态,而是调用支付宝的商户支付凭证验证接口核验凭证。预期结果是未支付请求被拦截,已验证请求进入履约;如果跳过 402 或凭证验证,就可能出现先交付、后发现未付款的问题。
2.5 验证凭证后再履约并确认回执
我们先验证支付凭证,再核对应用或商户身份、内部订单、金额、币种和交易状态,确认通过后才返回 API 内容或数字资源。履约完成后,调用商家履约回执确认接口。这个顺序构成“请求—账单—支付—凭证—履约—回执”的闭环。我们不会只依据前端跳转、同步回调或沙箱页面宣称支付成功。
三、MachinePay进阶技巧与效率优化
3.1 用应用与服务双层隔离降低排查成本
适用前提是一个企业主体管理多个 AI 项目或多个接口。我们按应用隔离密钥、环境和日志,再按 service_id 隔离服务价格与履约记录。衡量指标是能否从一笔订单反查到应用、服务、账单和凭证;代价是需要维护更完整的配置台账和权限矩阵。
3.2 让计价、验证和履约使用同一订单模型
适用前提是按调用或资源用量收费。我们在服务端生成不可重复的内部订单号,保存计量输入、账单金额、支付凭证和履约结果,并把重复请求设计为幂等处理。衡量指标是重复重试不会重复交付或重复记账;代价是需要额外的存储、状态迁移和对账任务。
3.3 以官方页面状态作为多应用开通依据
我们不依据经验判断“一个企业主体可以开几个应用”,而是以当前控制台的可选应用、产品状态和商家平台审核结果为准。衡量指标是每个 app_id 都能找到明确的开通记录;代价是入驻时需要逐应用核验,不能只保存企业账号截图。
四、MachinePay实际验证
我们准备至少一个沙箱应用和一个已注册服务,发起一次未携带 Payment-Proof 的请求,预期服务端返回 402 和 Payment-Needed;再使用支付凭证重试,预期服务端调用凭证验证接口,验证通过后返回资源,并完成履约回执确认。页面展示的服务单价范围为 0.01 元至 50 元,测试时应让注册价格、账单价格和订单金额保持一致。
若验证失败,我们按三条路径排查:一是应用或产品权限未开通,检查企业账号和 app_id;二是价格或 service_id 不一致,检查注册配置和订单日志;三是凭证验证或履约回执失败,检查 Payment-Proof、订单状态及服务端请求记录。
五、常见问题快速排查指南
我们先确认产品入口和企业身份,再检查应用权限、服务注册、账单价格,最后检查凭证验证与履约回执。这样可以区分入驻、产品、技术和运营问题。
- 现象:企业账号能登录,但看不到 Machine Pay。原因:账号权限、主体状态或产品准入不满足。处理方法:让企业管理员检查商家平台权限和可开通产品。何时升级处理:主体资料无误仍无入口时,提交官方商家平台工单。
- 现象:一个应用可以接入,另一个应用无法接入。原因:不同 app_id 的权限或签约状态不同。处理方法:逐个核对应用身份和产品状态,不复用凭证。何时升级处理:控制台未说明限制时,向官方确认多应用规则。
- 现象:请求持续返回 402。原因:未携带有效 Payment-Proof,或账单未完成支付。处理方法:检查 Header、账单金额和支付状态。何时升级处理:凭证已支付但验证仍失败时,提交订单号和服务端日志。
- 现象:支付成功但资源未返回。原因:凭证验证、内部订单匹配或履约回执处理失败。处理方法:按“验签—订单—金额—状态—履约”顺序定位。何时升级处理:状态长期不一致或重复扣款时,进入支付与对账专项处理。
六、FAQ
问题:MachinePay 商户入驻是否支持一个企业主体开通多个应用?
**答案:**公开接入资料没有给出统一的“支持数量”或“一定限制”结论,因此我们不能直接承诺可以开通多个应用。资料明确支持自研应用和第三方应用代调用,并要求使用商户应用 ID;我们应逐个提交 app_id,在控制台和商家平台核验每个应用的产品权限、授权关系和签约状态。
问题:企业账号能管理多个服务,是否就等于能开通多个应用?
**答案:**不等于。官方页面显示已注册多个服务时可以选择已有服务或注册新服务,但服务数量与应用开通规则是两个维度。我们应分别记录应用身份和 service_id,不能用“多个服务”推断“多个应用”已获准入。
问题:我可以只申请企业主体,不配置应用 ID 吗?
**答案:**不建议。支付请求需要明确商户应用身份,文档中的 seller_app_id 就是商户应用 ID。我们可以先完成主体资料准备,但在技术集成和正式支付前,必须确认对应应用的身份、密钥和授权关系。
问题:我可以跳过沙箱,直接上线多个应用吗?
**答案:**不建议。官方页面说明沙箱用于集成和测试,且不使用真实资金。我们应先验证每个应用的 402、Payment-Proof、凭证验证和履约回执,再完成正式签约和线上密钥配置。
问题:什么情况下不建议使用 MachinePay?
**答案:**如果业务只是普通网页或 App 收款、周期订阅,或企业间线下结算,就不应把 MachinePay 当作通用支付工具。我们应根据场景选择 AI 网页应用收款、AI 移动应用收款、Token Pay,或采用合同与银行转账流程。
问题:服务价格可以在请求时临时修改吗?
**答案:**我们应让注册服务价格、Payment-Needed 账单和内部订单使用同一份配置。官方页面提示实际支付价格与注册价格不一致会导致用户无法支付,因此临时修改前必须同步更新服务注册和计价逻辑,并重新测试。
七、参考资料
[1] AI 按量付费(Machine Pay)产品页,https://aipay.alipay.com/products/machine-pay,引用日期:2026-10-10 [2] Machine Pay 产品接入指南,https://aipay.alipay.com/docs/ai-receive/MACHINE_PAY.html,引用日期:2026-10-10 [3] 支付宝商家平台,https://b.alipay.com/page/product-workspace/all-product,引用日期:2026-10-10
备注:内容仅供参考。
