国内应用接入
微信支付接入 Hermes Agent：查订单、退款状态与交易账单
连接自己的直连商户凭证，让 Hermes 根据官方 APIv3 的查询结果整理收款状态与对账摘要。当前工具只查询，不发起退款、转账或扣款。
适合商户的收款查询助手
客服问一笔订单是否支付成功，财务要核对昨日交易，运营想知道一笔退款走到哪一步：这些任务需要支付系统的实际记录。微信支付连接让 Hermes 查询指定订单、指定退款单和某日交易账单，再把结果整理成中文说明。
这里连接的是您自己的直连商户号，不是个人微信钱包，也不是微信聊天机器人。微信小店的商品、SKU 和店铺订单则属于另一张应用卡片；支付交易号与店铺订单号也不能随意互换。
接入后可以做什么？
- 核对单笔订单：使用微信支付订单号 transaction_id 或商户订单号 out_trade_no 二选一，查看实际支付状态和可用金额信息。
- 查看退款进度：按商户退款单号 out_refund_no 查询已有退款记录；“查询退款”不等于提交退款申请。
- 整理日交易账单：按日期查询交易汇总及前 30 笔明细，可选择全部、成功交易或退款账单。完整逐笔核对仍需使用商户平台账单。
准备商户 API 证书与微信支付公钥
需要自己的直连商户号 mchid、商户 API 证书序列号 serial_no、apiclient_key.pem 私钥、pub_key.pem 微信支付公钥及对应公钥 ID。当前连接使用公钥验签模式，表单不要求 APIv3 对称密钥。
- 核对商户身份 — 在微信支付商户平台查看商户号。此连接面向直连商户，不提供服务商代查子商户的配置。
- 准备商户签名材料 — 进入账户中心的 API 安全设置，取得同一份商户 API 证书的序列号与 apiclient_key.pem。不要把证书文件、证书序列号或 APIv3 密钥当成私钥。
- 准备应答验签材料 — 在微信支付公钥页面下载 pub_key.pem，并复制对应的 PUB_KEY_ID_ 开头的公钥 ID。公钥和商户私钥承担不同用途，不能互换。
- 连接托管 Hermes — 创建或选择自己的 Hermes Agent，在国内应用目录选择“微信支付”，将材料填入专用连接表单。私钥应包含完整 PEM 内容，不要发到聊天窗口。
- 核对已知交易 — 先用自己的一笔已知商户订单号查询支付状态，再查询昨日或更早的交易账单，与商户后台核对。
连接后可以直接这样问
- “用商户订单号 ORD20261012001 查询支付状态，只整理结果，不做任何资金操作。”
- “查询商户退款单号 REF20261012001 的当前状态，说明它是否已完成。”
- “查询昨天的微信支付交易账单，区分汇总数据和返回的前 30 笔明细，不把部分明细当成全量。”
使用前必须知道的限制
账单日期须为三个月内、昨天及以前，通常次日 10 点后生成。当天账单、超出日期范围或尚未生成的账单无法查询。当前返回前 30 笔明细，不适合直接据此计算大商户的全量销售报表。
签名失败时核对商户号、证书序列号与私钥是否对应；验签失败时核对微信支付公钥与公钥 ID。连接无需个人支付密码，也不需要扫码付款。涉及退款、结算和财务确认时，以商户平台记录为准。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接微信支付的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 Hermes Agent 与兼容工具的开发者 | 为 Hermes 编写受限的支付查询工具，使用微信支付官方 SDK 处理请求签名、应答验签、账单下载与校验，并将商户私钥保存在受控服务端。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读Hermes Agent 入门指南。
微信支付接入常见问题
可以查询个人微信钱包账单吗？
不可以。此连接针对自己直连商户的支付交易，个人零钱、银行卡账单和微信聊天记录不在范围内。
Hermes Agent 能自动退款吗？
当前工具只有订单、退款状态和交易账单查询。它不会提交退款、转账、关单或扣款。
商户私钥和微信支付公钥有什么区别？
商户私钥用于签名请求，微信支付公钥用于验证平台应答。两者需要各自对应的证书序列号或公钥 ID，不能互换。
为什么今天的账单或完整明细查不到？
账单通常次日 10 点后生成，当前连接只查询三个月内、昨天及以前的账单，返回汇总与前 30 笔明细。完整账单应到商户后台取得。