用途:处理支付宝收银台链接的付款环节,包括解析订单信息、提交支付请求和查询支付结果。当上下文出现 cashier*.alipay.com 或 excashier.alipay.com 链接且用户有支付意愿,或其他工具返回使用支付宝支付的指令,或用户明确要求支付时使用。
主要能力:通过 alipay-bot CLI 完成检查钱包状态(check-wallet)、提交支付(submit-payment)、查询支付状态(query-payment-status)、初始化支付会话与暂存订单摘要(payment-intent),以及问题反馈(problem-feedback)。CLI 仅与支付宝官方服务端通信,不涉及商户端身份认证,用户使用自己的支付宝账号支付。
必要用法:环境需 npm 可用;alipay-bot 未安装时,先向用户说明并取得同意,再校验完整性(npm view @alipay/agent-payment@1.0.0 dist.integrity),通过后执行 npm install @alipay/agent-payment@1.0.0 && npx @alipay/agent-payment@1.0.0 install-cli,随后用 which alipay-bot && alipay-bot --version 验证。须使用固定版本 1.0.0,勿用 @latest。典型流程:先 payment-intent 展示订单,再 check-wallet;返回 code=200 且 access_url 为空则 submit-payment,若 access_url 非空则调用 alipay-authenticate-wallet;提交后需将完整输出展示给用户并停止,用户表示已支付时用 shortUrl 执行 query-payment-status -p "<shortUrl>"。
限制与注意:CLI 输出的 URL 含签名,必须逐字符原样输出,不可截断或改写,链接约 5 分钟内有效且一次性、与用户账号绑定,不写入日志或经非指定渠道发送。查询须用 shortUrl(https://u.alipay.cn/...),不能传收银台链接。环境变量 AIPAY_* 均为可选,未提供时用默认值。sessionId 不可编造,无法获取时跳过订单初始化步骤。部分细节(如具体错误码全集)资料未展开。