# 兼容性与组合约束

规则的证据状态与本次接入的检查结论分开。`documented` 表示资料有记载，`implementation_documented` 只表示内部实现说明，`conflicted` 表示来源冲突，`unknown` 表示缺证据；这些都不是商户资格证明。

每次检查输出：通过（相关证据齐全）、有条件通过（明确可完成的配置动作及完成判据）、不支持（权威明确排除）、待确认（准入/授权/契约或用户事实不足）。准入和授权未知必须记为待确认，不能当普通配置待办。引用来源见 [sources.yaml](sources.yaml)。

<a id="c-access"></a>
## C-ACCESS：产品与主体

适用全部模式。YQ-INTEGRATION §5.1.1 记载需开通智能体代理支付产品。检查应用、调用商户与已开通能力的对应关系；无法证明该商户获得当前模式能力时，方案停留在带条件设计。旧 skill 的“邀测 BD/App 支付权限/沙箱完整可用”等描述未在本轮取得同等权威的能力确认，不普遍化。

证据状态：产品前提 `documented`；当前商户的开通情况 `unknown`（除非用户或实际配置提供进一步证明）。下一步：请产品接入负责人确认该 app/商户/场景开通范围。来源：YQ-INTEGRATION；ANTCODE-NEW（旧版声明的对照）。

<a id="c-auth"></a>
## C-AUTH：授权对象和复用

独立签约检查商户签约号与用户映射。已有 AI 付协议时复用相应商户签约号；没有时，YQ-INTEGRATION §5.1.2 与 YQ-AUTHORIZATION §独立签约描述了用户确认过程中建立 AI 付协议的链路，因此 `agent.sign` 不是全部委托模式的必经前置。仍需用户完成此流程的授权与核身。

静默签约的既有协议条件见 C-SILENT。取消委托、解约 AI 付协议与退回已扣资金是不同对象的操作，不彼此替代；退款接口的详细契约不在本轮覆盖内。

证据状态：`documented`。证据不足动作：查询相应对象和映射，不把“用户愿意购买”的自然语言当成已经建立有效协议。来源：YQ-INTEGRATION §1/5/6；YQ-AUTHORIZATION §独立签约；SDK-4.40.987 各对象接口。

<a id="c-handoff"></a>
## C-HANDOFF：跨接口数据一致性

检查当前用户、AI 付协议、委托任务、商户订单和预下单属于同一次业务链。通过标准是每个下一步输入都能定位到已确认的上游结果或业务映射，不能用展示文字推断协议号。

委托查询：协议标识二选一（`agreement_no`/`external_agreement_no`）与委托标识二选一（`delegation_id`/`external_delegation_id`）两组都需要，可交叉组合。单字段取值见[查询目录](catalogs/parameters/alipay.user.agreement.delegation.query.yaml)。

扣款依赖商品商户预下单返回的 `prepay_id`，以及正确的 `agreement_no` 和 `delegation_id`。不因预下单存在、客户端返回或委托状态正常就宣布交易成功。静默 sign 有 AI 付和免密两个协议输出；当公开资料未明确该场景支付 `agreement_no` 的映射时，将映射单列待确认，不能随便取其中之一。

证据状态：基本链路 `documented`；静默两协议到支付字段的特定场景映射 `unknown`。来源：YQ-INTEGRATION §5.3.1/6.1；YQ-DELEGATION §委托支付；SDK-4.40.987。

<a id="c-postpay"></a>
## C-POSTPAY：支付后推荐条件

仅支付后推荐。YQ-AUTHORIZATION 描述推荐准入、签约上下文恢复、已有协议及重复委托检查；`deductRecommendAfterPay`、`signAfterPayCacheId`、`ALLOW_AFTER_PAY_RECOMMEND` 等是内部流程标识，不是已确认的商户公共 API 参数。

需要接入负责人确认当前收银链路如何接入推荐、业务场景准入、现有协议承接和用户确认入口。只有“支付已成功”无法通过本检查。未获平台支持时不自行请求 `/cashier/*`、paygrowth 或 mdeduct 内部服务；可讨论独立授权的业务替代，但须用户接受入口变化并重新检查 D-INDEPENDENT。

证据状态：机制 `implementation_documented`；当前商户准入及公开配置契约 `unknown`。来源：YQ-AUTHORIZATION §支付后推荐签约；YQ-DELEGATION 同名节。

<a id="c-silent"></a>
## C-SILENT：静默签约条件

仅静默签约。检查已有 AI 付协议和免密协议是否存在、有效并允许当前用途，用户是否一致，请求 PID 是否与 AI 付协议 PID 一致，以及该 PID + 场景是否获准直接签约。SDK 中确有 `alipay.user.agreement.delegation.sign`，参数见[静默签约目录](catalogs/parameters/alipay.user.agreement.delegation.sign.yaml)；类存在不表示商户已获准调用。

YQ-AUTHORIZATION 描述按 PID + scene 加载 `allowDirectApply` / `allowAfterPayRecommend` 等内部产品配置，以及外部委托号复用；千问打车场景还有同场景 NORMAL 委托去重。不能把该特定场景规则扩展到所有商户，也不能把内部配置名当作用户可传字段。协议主体不一致属于已记载的排除条件，不建议改标识绕过。

证据状态：字段 `sdk_verified`，内部校验与机制 `implementation_documented`；商户资格、场景字典、协议用途与有效性证明 `unknown`。下一步：产品/API 负责人确认准入与协议可用性，再补齐 C-HANDOFF 映射。来源：SDK-4.40.987；YQ-AUTHORIZATION §静默签约。

<a id="c-env"></a>
## C-ENV：客户端、通知与环境

所有模式检查真实客户端 SDK 能力、服务端签名和商户通知接收配置的环境一致性。调用方式见[客户端指南](guides/client-sdk.md)，事件字段与环境证据只在[通知目录](catalogs/callbacks.yaml)维护。

旧版沙箱示例不能证明当前委托产品在沙箱/预发已开通。确认材料缺失时可继续参数与流程设计，不能声称已联调成功。下一步：SDK 与接入负责人提供客户端版本、对应能力、网关及商户接收地址配置规则。

证据状态：`partially_documented`，本轮没有实际环境验证。来源：YQ-INTEGRATION §1.3.2/5.2/5.3.3；ANTCODE-NEW；SDK-4.40.987。

<a id="c-recovery"></a>
## C-RECOVERY：状态、幂等与恢复

同一业务请求保留原协议、委托和订单映射；新业务可创建新的业务标识，重试不是新业务的证明。旧故障排查“每次换 external_*”与其幂等章节冲突，不能作为状态未知时的恢复方案。

授权未知查询协议/委托；支付未知由有权限的商品商户核对原交易及支付通知。委托查询不查询交易结果；若需 `alipay.trade.query` 或退款等扩展接口，另取其当前契约，不能依据本包编造字段或重试时限。状态全集、通知完整性或可重试性未确认时，保留未知状态并停在核对路径。

证据状态：旧规则 `conflicted`；上述保守恢复动作是本包接入设计约束，不是平台无限幂等承诺。具体码见[错误目录指南](guides/error-handling.md)。来源：LOCAL-DESIGN；ANTCODE-NEW；ANTCODE-OLD；YQ-INTEGRATION §5.3.1/6.1。
