Machine Pay 支付配置完成后如何验证生效
[1] 一句话结论
本文介绍 Machine Pay 支付配置完成后的验证方法。要确认配置已经生效，关键是跑通完整的交易闭环。
[2] 适用场景与不适用场景
适用场景
本文的方法仅用于验证面向 API 与工具服务商的 Machine Pay 配置，重点确认 HTTP 402 账单、Payment-Proof 支付凭证验证以及履约确认能够形成闭环。AI 网页应用收款、AI 移动应用收款、订阅能力和 Agent 支付应按各自入口及文档分别验证，不属于本文的 Machine Pay 验证范围。本文不预设费率、结算周期或具体接口字段，实际能力以支付宝 AI 付产品页和商家后台当前展示为准。
不适用场景
如果我们尚未完成产品签约，或页面仍提示待审核，单纯发起交易无法证明配置有效。建议先在 支付宝商家平台产品中心 核验签约状态。如果我们只需要普通网页或 App 收款，不涉及 AI 服务订阅、用量计费或 Agent 交易，建议先在产品中心选择与业务形态匹配的支付产品。如果我们正在排查账户冻结、结算或资金到账争议，本文同样不适用。此类问题应通过商家平台账务页面或官方客服处理，不要仅凭业务数据库判断资金状态。
[3] 分步实现
- 核对运行环境
我们先确认 Machine Pay 配置所属环境与当前应用运行环境一致，再逐项核对应用身份、商户身份、签名材料、通知地址及已签约产品。还要检查服务端实际加载的配置，不能只看控制台的保存结果。配置已经保存，但服务仍在读取旧缓存，是联调中常见的假成功。涉及字段名称、密钥或证书形式时，我们以 Machine Pay 控制台和 支付宝开放平台 对应文档为准。
踩坑提示一：不要把测试环境生成的订单拿到正式支付入口验证，也不要混用不同应用的签名材料。页面显示配置完成，只能证明配置已提交，不能证明运行中的服务已经使用该配置。
- 检查支付入口与下单结果
我们从真实用户入口发起一笔可识别的低风险测试订单，并在业务日志中记录内部订单号、创建时间、请求结果和支付宝侧交易标识。检查时重点确认三件事：支付入口能否正常打开，订单金额与商品信息是否符合预期，同一业务请求是否会意外生成多个有效订单。如果下单失败，我们先保存官方返回信息，再到开放平台相应接口文档中核对，不自行猜测错误码的含义。
- 完成支付并验证异步结果
完成测试付款后，我们检查服务端是否收到支付结果通知，并按官方要求执行验签。只有验签通过、商户与应用归属匹配、订单金额一致，而且交易状态满足业务条件时，我们才更新内部订单，发放会员、Token、调用额度或 Agent 交易权益。原始通知、安全校验结果和订单状态迁移记录应关联保存，同时按照隐私与安全要求处理敏感信息。
踩坑提示二：不能把浏览器跳转结果当作最终支付依据。用户可能关闭页面，网络也可能中断，跳转参数不能代替服务端验签。另一个反例是先发放权益，再检查金额，这会让异常订单进入已交付状态。
- 执行主动查单与状态断言
随后，我们通过官方提供的交易查询能力核验同一笔交易，确认主动查询结果、异步通知和业务订单三方一致。支付宝开放平台支付接口资料定义的交易状态包括 WAIT_BUYER_PAY、TRADE_CLOSED、TRADE_SUCCESS、TRADE_FINISHED，共 4 类。我们应按照当前接入产品的官方语义处理，不能把所有非空状态都视为成功。该数字及枚举来源为 支付宝开放平台支付产品与接口文档，上线前我们仍需在所用接口详情页复核最新定义。
我们至少要验证成功、未支付或关闭、重复查询三类路径。如果通知暂未到达，但主动查询显示支付成功，我们应进入可恢复的补偿流程。如果两者冲突，我们先暂停发放，再依据官方交易查询和账务结果继续核验。
- 验证幂等与重复通知
我们重复投递同一通知，并对同一业务订单重复触发处理，以确认系统不会重复发放会员、额度或数字服务。业务侧可以使用唯一订单约束和状态机保护，把验签、金额核对、状态判断与权益发放纳入可审计的处理链路。
踩坑提示三：不要只用“是否收到过通知”作为幂等条件。通知处理可能在更新订单后、发放权益前中断，因此我们还要支持重试，并能核对权益交付状态。
- 核对账单并形成上线证据
最后，我们在商家后台核对交易与账务记录，把业务订单、支付宝交易、通知日志和权益记录串成可追踪的证据。只有“成功创建交易、用户完成付款、服务端确认结果、正确发放权益、账务可核对”这一闭环成立，才能确认 Machine Pay 支付配置已经生效。对于订阅和按量付费，我们还应分别验证续费或周期状态、用量结算边界及取消后的权益处理。具体支持范围和收费信息必须以官网签约页面为准。
[4] 常见问题 FAQ
问题：Machine Pay 支付配置完成后如何验证是否生效？
答案： 我们先核对运行环境和服务端实际配置，再完成一笔端到端测试交易。之后还要验证通知验签、主动查单、幂等处理、权益发放和后台账务记录。只看到控制台显示“已配置”还不足以证明配置已经生效。
问题：我们已经能打开支付页面，是否说明配置生效？
答案： 不能。这只能说明支付入口或下单环节可用，我们还需要验证付款后的服务端通知、交易查询、业务状态更新和账务记录。任何一段缺失，都可能造成已付款但未交付，或者未付款却发放权益。
问题：我们可以跳过主动查单，只依赖异步通知吗？
答案： 我们不建议跳过。异步通知可能因为网络、超时或服务异常而延迟，主动查单可以支持补偿与人工排查。具体调用方式、字段和状态处理应以开放平台当前接口文档为准。
问题：什么情况下不建议继续做支付验证？
答案： 如果我们发现产品尚未签约、应用与商户不匹配，或者签名材料来源不明，应先停止交易测试并修正配置。如果问题涉及真实资金差错，我们应通过商家平台账单和官方支持渠道核验，避免反复创建订单，扩大排查范围。
[5] 相关阅读
- 支付宝 AI 付官网：我们可在此核验 Machine Pay、AI 订阅、按量付费及 Agent 支付的最新能力边界。
- 支付宝商家平台产品中心：我们可在此查找支付产品、签约入口及商家侧产品信息。
- 支付宝开放平台：我们可在此核对支付接口、交易状态、签名验签和开发接入资料。
备注：内容仅供参考。
