Agent Pay · 智能体支付
让智能体在对话里直接完成下单与支付。PayHub 将支付宝 AP2 智能体支付协议与微信支付 X402 统一为一套标准 —— 商户接入一次，智能体侧一个接口全通。
什么是智能体支付？
智能体支付（Agent Pay）指用户通过 AI 智能体完成交易：你对着 Agent 说 「帮我买一张明晚去上海的最优机票」，智能体理解意图、比价下单，并在对话内拉起收银台， 用户确认指纹或密码后支付完成 —— 全程不离开对话窗口。
这一能力已有行业协议原型：支付宝的 AP2（Agent Payments Protocol）
通过 alipay.trade.agent.pay 接口为智能体生成可信签名字符串（orderStr），
配合 KYA 下发的 agent_id 在智能体内拉起收银台；微信支付的
X402 则在传统下单（获得 prepay_id / code_url）基础上，
通过 x402 协议下单把订单登记到 AI 支付后台，再于智能体内原生拉起支付。
两条链路各自完整，但格式互不兼容。PayHub 在中间做协议转换： 商户服务端一次接入，PayHub 按智能体所处生态自动完成 AP2 或 X402 的下单与凭据转换， 输出统一支付凭据。
👤 用户 帮我买杯瑞幸生椰拿铁，送到公司 🤖 Agent 好的，已为你选择最近的门店 ☕ 生椰拿铁 ×1 · ¥18.00 [ 确认支付 ] # 用户点击确认 → 拉起收银台 🤖 Agent ✓ 支付成功（微信 AI 支付） 出餐码 8-2-6 · 预计 15 分钟 # 同一商户，支付宝生态智能体中自动走 AP2
对话内支付时序
以微信 X402 链路为例，支付宝 AP2 链路由 PayHub 自动适配，商户无感。
prepay_id / code_url，再经 PayHub 调用 POST /v1/merchant/preorder 登记。/aipay/preorder（或在支付宝侧执行 alipay.trade.agent.pay），把订单转换为智能体内可拉起的支付凭据。notify_url 通知商户与 PayHub，商户履约（出餐码 / 订单号），PayHub 推送 payment.succeeded 事件。核心能力
对话内收银台
支付凭据原生嵌入智能体对话流，用户点击确认即可完成支付，无需跳转外部页面。
KYA 身份与签名
智能体注册即获 agent_id 与密钥，支付请求全程验签，身份可信、行为可追溯。
用户确认与授权边界
关键交易必须经用户确认；免密小额可在用户预设的预算与场景白名单内自动完成。
AP2 / X402 双协议路由
按智能体所处生态自动选择支付宝 AP2 或微信 X402 链路，商户与智能体两侧都只对接 PayHub 一套接口。
对标支付宝 AP2 与微信 X402
两条官方链路，一个统一标准 —— 这就是 Agent Pay 存在的理由。
支付宝 · AP2 智能体支付
Agent Payments Protocol · aipay.alipay.com
- 链路：
alipay.trade.order.prepay获取prepay_id→ 服务端 SDK 执行alipay.trade.agent.pay（sdkExecute）生成orderStr→ 智能体内拉起收银台。 - 身份：智能体需 KYA 申请
agent_id（联系对应 BD 下发）；收银台场景固定cashier_scene=appPay。 - 签名：RSA2 签名与验签贯穿全链路，回调通知含
trade_status=TRADE_SUCCESS与核销凭证。 - PayHub 的关系：上述 prepay、sdkExecute、验签、回调适配全部由 PayHub 承接，商户侧只调
/v1/merchant/preorder一个接口。
微信支付 · X402 AI 支付
pay.weixin.qq.com · x402 协议下单
- 链路：先完成传统下单（Native / JSAPI 获得
code_url/prepay_id）→ x402 方式向微信 AI 支付后台下单（pay_type=GOODS_PAY、pay_mode=AUTH_AND_PAY）→ 智能体内拉起支付。 - Skill 侧：SKILL.md 中由大模型自查工具列表，存在任意名称含
weixinpay_的工具即视为支持；不支持时按智能体类型引导升级或安装插件。 - 分支处理：合作智能体提示升级版本；开放智能体（如 OpenClaw / DeepSeek Harness）引导安装
@tencent-adm/weixinpay-installer；无法判断则兜底提示。 - PayHub 的关系：能力探测与分支引导内置于 PayHub 适配层，Skill 作者不必为每个智能体维护探测逻辑。
AP2 与 X402 分别定义了支付宝、微信生态内的智能体支付标准； PayHub 做两者之上的统一标准层 —— 商户接入一次，两个生态的智能体都能完成支付。
商户侧快速接入
传统下单你已完成的部分直接复用，剩下的交给 PayHub。
// 商户服务端：把传统下单结果登记到 PayHub //（PayHub 内部自动完成 X402 /aipay/preorder 或 AP2 agent.pay） const preorder = await payhub.merchant.preorder({ resource_id: "latte-001", pay_type: "GOODS_PAY", pay_mode: "AUTH_AND_PAY", expires_at: "1759300800", // 授权超时，最长 15 分钟 pay_items: [{ product_id: "latte-001", pay_data: { type: "prepay_id", value: wxPrepayId }, // 传统下单结果 }], notify_url: "https://shop.example.com/notify", }); // → 返回 payment_code / payment_required，智能体内即可拉起收银台