SuperAPI AI 工具集

alipay-pay-for-402-service

通用与其它

查看项目

更新于 10-15 16:47

技能介绍

用途:当 HTTP 请求返回状态码 402 Payment Required(无论由你发起还是用户提供)时,使用本技能处理 A402 协议买方支付流程。其他格式的付款要求不在适用范围内。

主要能力:通过命令行工具 exec 调用 alipay-bot 客户端完成付款,包括检查钱包状态、提交支付、查询支付状态、发送履约回执,以及问题反馈。

使用方式:先执行 alipay-bot -- check-wallet 检查钱包状态;保存 402 响应头中的 Payment-Needed 到文件(文件名仅允许字母、数字、连字符、下划线、点号,推荐 402_needed_<timestamp>.txt);执行 alipay-bot -- 402-buyer-pay -f '<402_needed_file.txt>' 发起支付,并将 CLI 输出(含 MEDIA 行)原样透传给用户;用户确认支付完成后执行 alipay-bot 402-query-payment-status -t '<tradeNo>' -r '<resource-url>' [-m '<method>'] [-d '<data>'] [-H 'key:value'];成功后透传 tradeNo 与 resourceResponse.body,并执行 alipay-bot -- 402-buyer-fulfillment-ack -t '<trade_no>' 发送履约回执。

环境依赖:需 npm 可用;优先 which alipay-bot 检测,未安装时须经用户同意并校验完整性后执行 npm install @alipay/agent-payment@1.0.0 && npx @alipay/agent-payment@1.0.0 install-cli,禁止使用 @latest。

限制与注意:每次收到新的 402 响应都需重新执行流程,不得复用历史支付记录;Step 2 输出后须等待用户支付完成通知,不得自动连续执行;不得伪造支付状态、凭证或交易号;不得修改命令参数与资源内容;支付链接约 5 分钟有效,不应写入持久化日志或通过非用户指定渠道发送;执行前应向用户说明操作,错误如实报告。