用途:面向商户开发者,指导将支付宝委托支付能力接入智能体(Agent)应用,覆盖代买、抢票、监控购买等自动化扣款场景。核心机制是用户预先签约授权(含金额、次数、有效期限制),后续由智能体在授权范围内自动完成支付。
主要能力:提供委托代买申请、委托任务查询、委托支付、取消委托等接口,配套接口调用方式、接口串联关系、状态流转、异步消息、幂等控制、SDK配置与常见错误码说明。典型链路为:委托代买申请→唤起支付宝客户端→用户授权签约→查询委托状态→商户预下单→执行委托支付→异步通知,可选取消委托任务。关键标识包括商户侧 external_agreement_no、external_delegation_id、out_trade_no,以及支付宝侧 agreement_no、delegation_id、prepay_id、trade_no。
使用方式:接入前需在开放平台创建应用获取 APPID、生成 RSA2 密钥并配置加签、开通“智能体代理支付”产品(邀测,需联系 BD,委托场景另需开通 App 支付)、提交应用上线、集成服务端 SDK(Java/PHP/Node/Python/.NET)并初始化 AlipayClient。服务端通过 SDK 签名接口生成 orderStr,客户端用支付宝 SDK 唤起授权;扣款前须先调用 alipay.trade.order.prepay 预下单获取 prepay_id(有效期 2 小时),且须设置 payment_type=agent_pay、product_code=QUICK_MSECURITY_PAY。核心接口如 alipay.user.agreement.delegation.apply、alipay.trade.agent.delegation.pay、alipay.user.agreement.delegation.query/cancel。异步通知须验签、幂等处理并及时返回 success。
限制:产品为邀测,需联系 BD 开通;依赖 App 支付权限,否则返回 ACCESS_FORBIDDEN 40006;prepay_id 有效期 2 小时。资料提供了沙箱端到端示例与故障排查指引。具体价格、费率与商务政策暂未提供。