通联支付云商通2.0支付接入指引

核心规则（最高优先级）

> CRITICAL：以下规则覆盖所有能力与全部对话轮次，任何步骤不得违反。

1. 等待用户明确回复：除产品选型阶段外，所有需要用户确认的环节必须等待明确回复后再继续。
2. 公共配置禁止硬编码：示例代码中的 APP_ID、MER_PRIVATEKEY、ALLINPAY_PUBLIC_KEY、MER_SECRET_KEY、接口服务地址 必须从配置文件读取。
3. 示例代码必须复用参考文件：命中下列场景时，一律从 reference/示例代码/ 下对应文件输出，不得自行生成：
• 加签 / 验签
• 公共报文组装
• 网络调用
• 文件上传 / 下载
• 异步通知处理
• 敏感字段加密
4. 标记 "重要" 的内容必须执行：文档中任何带 重要 标记的指令不得忽略。

主工作流：接入云商通2.0

> 触发条件：用户请求接入云商通、接入通联支付、生成支付接入代码时启动。

>

> 必须按 步骤 1 → 步骤 2 → 步骤 3 顺序执行，不得跳步。

步骤 1 · 产品选型

阅读 → reference/产品选型.md

交付要求（用户确认后进入下一步）：

• 产品版本（默认：综合支付版）
• 接口范围（默认：2.1 ~ 2.8）
• 开发语言（默认：Java）

步骤 2 · 代码编写

阅读 → reference/代码编写.md

步骤 3 · 质量检查

代码编写完成后，逐项验证并向用户报告结果：

• [ ] 编译通过
• [ ] 代码可正常运行
• [ ] 公共配置参数齐全（APP_ID、MER_PRIVATEKEY、ALLINPAY_PUBLIC_KEY、MER_SECRET_KEY、接口服务地址）

辅助工作流

下列能力按各自触发条件独立启用，不属于主工作流的必经步骤。

问题排查

> 触发条件：用户遇到接口调用报错、签名失败、验签失败、回调未收到、对账失败或支付流程异常。

阅读 → reference/问题排查.md

业务知识

> 触发条件：用户询问云商通2.0业务概念、交易流程、产品差异或接入策略。

阅读 → reference/业务知识.md

接口索引

> 触发条件：用户需查找具体接口文档、transCode、接口路径或在线文档链接。

阅读 → reference/接口索引.md