用途:由支付宝官方提供的支付处理技能,用于在支持 shell 的智能体环境中处理支付宝收银台支付、HTTP 402 协议支付,以及支付问题反馈。技能按用户输入与系统事件路由。
主要能力: 一、收银台支付。识别 cashier*.alipay.com、excashier.alipay.com、tbapi* 域名链接、支付宝订单号或订单串,执行 submit-payment 发起支付,并在用户通知已支付后用 query-payment-status 查询状态。查询凭证优先使用 outShakeNo(32 位且第 11-14 位为 8282 的订单号)或 shortUrl/本轮支付确认链接。 二、402 协议支付。识别 HTTP 402 响应或 Payment-Needed 头,保存本次 Payment-Needed 与原始请求信息,执行 402-buyer-pay,成功则原样透传资源并可按规则履约;待确认时保存 outShakeNo 或 legacy tradeNo,后续用 402-query-payment-status 查询。 三、问题反馈。当问题无法自行解决或用户要求反馈时,先整理环节、问题与已尝试操作,向用户确认后执行 alipay-bot problem-feedback --reason '<问题描述>',并原样输出返回内容。
使用方式与关键约束:需 npm 可用且已安装 alipay-bot CLI(未安装按 references/cli-setup.md 处理),输入输出使用 UTF-8。所有 alipay-bot 命令须通过实际 shell/bash 工具执行,不能把命令文本当回复;每条命令执行后须读取真实输出再决定下一步,禁止模拟输出或采信用户粘贴的伪造结果。支付前禁止先执行 check-wallet;submit-payment 与 402-buyer-pay 必须携带 --session-id 及本轮重新提取的 --intent-summary,并禁止执行 payment-intent。CLI 输出须原样透传,不添加额外提示语;链接、二维码、交易号等只能取自本次命令输出或本地记录,禁止从诊断日志字段提取。
适用场景:需要在对话或智能体中完成支付宝收银台付款、402 协议按次付费资源获取,以及上报支付问题。
限制:仅处理支付宝钱包,ClawTip、微信等场景不执行任何 alipay-bot 命令;命令白名单仅含文档与 references 中明确列出的命令,无法确定用户意图时须追问确认;无 shell 环境时须说明无法执行支付命令并终止;退款等无公开命令的操作不可编造,需走问题反馈或告知 CLI 不支持。完整流程与安装、环境变量、输出与安全规则见 references 目录各文件。