用途:当 HTTP 请求返回 402 Payment Required(无论是自己发起的请求还是用户提供的响应)时,使用本技能处理 A402 协议买方支付流程;其他格式的付款要求不在范畴内。
主要能力:解析 402 响应中的 Payment-Needed 账单,调用 alipay-bot CLI 检查钱包状态、发起支付、查询支付状态并发送履约回执,最终把交易号与购得资源原样透传给用户。
使用方式:本技能由支付宝官方提供,CLI 包为 @alipay/agent-payment,版本锁定 @1.0.0。安装前须取得用户明确同意并做完整性校验:npm view @alipay/agent-payment@1.0.0 dist.integrity,预期值 sha512-/Ss+hS75CLYcwC8/jOj2kXzqIoJb7oKGrsiwnqly0EWVTxzD7QY5HxmFuj4anQfHVjnoh77qc2vUYiEAj0zfCA==,校验失败则禁止安装。安装命令:npm install @alipay/agent-payment@1.0.0 && npx @alipay/agent-payment@1.0.0 install-cli。若 which alipay-bot 已存在可跳过安装。
核心流程:Step 0 执行 alipay-bot check-wallet 检查钱包状态(code=200 且 access_url 为空进入支付;access_url 非空则调用 alipay-authenticate-wallet 技能;code=500 终止);Step 1 用 UTF-8 保存 Payment-Needed 到 txt 文件,文件名仅限 [a-zA-Z0-9._-],不加路径分隔符或特殊字符;Step 2 执行 alipay-bot 402-buyer-pay -f '<402_needed_file.txt>',并把 CLI 输出逐字符完整透传(含 MEDIA 行,不包裹代码块、不截断 URL),等待用户支付完成通知;Step 4 用户确认已支付后执行 alipay-bot 402-query-payment-status -t '<tradeNo>' -r '<resource-url>' [-m '<method>'] [-d '<data>'] [-H 'key:value'];Step 5 透传交易号与资源;Step 6 发送履约回执 alipay-bot 402-buyer-fulfillment-ack -t '<trade_no>',tradeNo 仅允许 32 位数字。
适用场景:仅限 HTTP 402 Payment Required 触发的 A402 协议支付,包括 AI 调用付费资源、API 按次计费等。
限制与安全:每次收到新的 402 响应都需重新执行流程,不得复用历史支付记录;Step 2 输出后必须等待用户确认,不得自动连续执行;支付链接约 5 分钟有效,不得写入持久化日志或通过非用户指定渠道发送;不得展示签名、密钥、凭证等敏感信息,不得伪造支付状态或跳过流程。
其他信息:CLI 官方 npm 页面为 https://www.npmjs.com/package/@alipay/agent-payment;问题反馈命令为 alipay-bot problem-feedback --reason '<问题描述>'。