# 接口地图

先按对象和动作定位，再读单接口语义与对应参数 YAML。此表是发现入口，不重复维护字段。调用方式与客户端结果见[客户端指南](guides/client-sdk.md)。

## 委托主链

| 接口 | 作用和调用方 | 在方案中的角色 |
| --- | --- | --- |
| [alipay.user.agreement.delegation.apply](interfaces/alipay.user.agreement.delegation.apply.md) | 智能体服务端构造委托申请签名串，客户端展示授权 | 独立签约入口 |
| [alipay.user.agreement.delegation.query](interfaces/alipay.user.agreement.delegation.query.md) | 智能体服务端查询委托及授权余量 | 确认授权状态、恢复未知结果；不是交易查询 |
| [alipay.user.agreement.delegation.cancel](interfaces/alipay.user.agreement.delegation.cancel.md) | 服务端取消指定委托任务 | 有取消需求时接入；不作为退款 |
| [alipay.trade.agent.delegation.pay](interfaces/alipay.trade.agent.delegation.pay.md) | 智能体服务端对已授权委托发起扣款 | 委托支付执行 |

## 流程核验补充的两项依赖

| 接口 | 作用和调用方 | 为什么补充 |
| --- | --- | --- |
| [alipay.trade.order.prepay](interfaces/alipay.trade.order.prepay.md) | 商品商户服务端预下单，提供给智能体订单输入 | 用户列出的支付接口需要 prepay_id；YQ-DELEGATION 与 SDK 均有依据 |
| [alipay.user.agreement.delegation.sign](interfaces/alipay.user.agreement.delegation.sign.md) | 获准调用方基于既有协议直接建立委托 | YQ-DELEGATION / YQ-AUTHORIZATION 中的静默签约；本地 4.40.987.ALL 已含请求/模型/响应 |

支付后推荐没有据本轮材料确认的单个商户公开推荐接口。参见[支付后推荐场景](scenarios/post-payment-recommend.md)，不把内部收银路径追加成需商户直调的接口清单。

## 通用 AI 付能力

| 接口 | 用途 | 条件 |
| --- | --- | --- |
| [alipay.user.agreement.agent.sign](interfaces/alipay.user.agreement.agent.sign.md) | AI 付协议签约 | 业务另有独立 AI 付协议开通需求时使用，不要求全部委托用户先调 |
| [alipay.user.agreement.agent.query](interfaces/alipay.user.agreement.agent.query.md) | 查询 AI 付协议 | 需核实协议、取回协议标识或恢复状态时；不沿用旧 skill 的通用 agreement.query 类 |
| [alipay.user.agreement.agent.unsign](interfaces/alipay.user.agreement.agent.unsign.md) | 解除 AI 付协议 | 用户明确要解除该协议时；与取消单个委托区分 |
| [alipay.security.risk.verifyidentity.common.query](interfaces/alipay.security.risk.verifyidentity.common.query.md) | 核身通用查询，AI 付场景有特定身份语义 | 需做该生物能力查询时使用，不替代 SDK 内部的委托核身提交 |

## 即时与语音边界

| 接口 | 用途 | 与委托的关系 |
| --- | --- | --- |
| [alipay.trade.agent.pay](interfaces/alipay.trade.agent.pay.md) | 当次智能体支付，签名串由客户端收银能力消费 | 不与委托后台扣款接口互换，不自动具备委托任务授权 |
| [alipay.pay.agent.voice.upload](interfaces/alipay.pay.agent.voice.upload.md) | 语音上传/流式初始化 | 语音凭据不是协议、委托号或支付完成结果；普通委托流程不默认需要 |

参数和响应结构依据 SDK-4.40.987；流程依据 YQ-INTEGRATION、YQ-DELEGATION、YQ-AUTHORIZATION。完整来源定位见 [sources.yaml](sources.yaml)。