一、概述
通联支付AI Skills 是通联支付推出的AI 代码生成技能包，安装到 AI 编码工具后，用自然语言描述需求，即可生成符合通联 SDK 规范的完整支付接入代码，大幅降低接入成本、提升对接效率。
传统对接 vs Skills 对接
| Plain Text传统方式 | Skills 方式 |
|
1. 打开SDK文档 2. 查找接口、核对参数表 3. 手写请求/签名逻辑 4. 编写通知接收与异常处理 5. 调试返回码、排查联调问题 |
1. 告诉AI"接入通联收付通协议支付" 2. 自动生成完整代码 3. 替换商户参数 4. 完成 |
你会得到什么
你说：帮我接入通联收付通协议支付
你得到：
✓ pom.xml 依赖配置
✓ SDK 初始化完整代码
✓ 签约短信→签约确认→协议支付全流程代码
✓ 交易查询 + 退款接口实现
✓ 异常处理 + 返回码判断逻辑
✓ 需填写的商户配置清单
你说：帮我生成通联收银宝统一下单工程代码
你得到：
✓ Maven 工程脚手架
✓ SDK 原生初始化配置
✓ 统一下单 / 查询 / 退款可运行 Demo
✓ 工程落地步骤 + JSON 执行工单
版本记录
|
版本 |
日期 |
技能名称 |
版本说明 |
|
v1.0.0 |
2026/04/16 |
allinpay-syb-sdk-unified |
收银宝全量接口路由，新增双输出模式、工程落地能力 |
|
v1.0.0 |
2026/04/16 |
allinpay-sft-agreement-pay |
收付通协议支付全流程，完善异常处理与返回码规则 |
二、接入前准备
在安装 Skills 之前，确认已获得如下配置参数：
|
配置项 |
说明 |
安全级别 |
适用产品 |
|
ALLINPAY_MERCHANT_ID |
通联分配商户号 |
普通 |
全产品 |
|
ALLINPAY_USER_NAME |
通联分配用户名 |
普通 |
全产品 |
|
ALLINPAY_SIGN_TYPE |
签名类型 (SM2/RSA) |
普通 |
全产品 |
|
ALLINPAY_PRIVATE_KEY |
商户私钥 (p12) |
高敏感 |
收付通 |
|
ALLINPAY_PUBLIC_KEY |
通联公钥 (cer) |
中等 |
收付通 |
|
SYB_SM4_KEY |
收银宝对称密钥 |
高敏感 |
收银宝 |
|
SYB_MD5_KEY |
收银宝 MD5 密钥 |
高敏感 |
收银宝 |
|
SYB_PRI_KEY |
收银宝商户私钥 |
高敏感 |
收银宝 |
|
SYB_PUB_KEY |
收银宝通联公钥 |
中等 |
收银宝 |
场景化配置项
|
配置项 |
说明 |
适用场景 |
|
ALLINPAY_NOTIFY_URL |
支付异步通知地址 |
协议支付 / 收银宝下单 |
|
ALLINPAY_REFUND_NOTIFY_URL |
退款异步通知地址 |
退款接口 |
|
SYB_ENV |
运行环境 (test/prod) |
收银宝 |
安全要求
- 所有密钥通过环境变量注入，严禁硬编码到源码或上传代码仓库
- 联调阶段使用联调专用密钥，禁止使用生产密钥
- 日志中避免打印完整密钥、银行卡号、证件号等敏感信息
- 私钥文件妥善保管，仅限服务端读取，禁止暴露到前端
三、安装
获取技能包
|
# 通联支付收单产品API使用技能包下载地址
# 通联支付收付产品API使用技能包下载地址 |
安装到 AI 工具
将技能包内的 Skill 目录复制到对应 AI 工具的 skills 路径：
|
AI 工具 |
skills 路径 |
|
Claude Code / Warp |
~/.claude/skills/ |
|
Cursor |
~/.cursor/skills/ |
|
Trae |
~/.trae/skills/ |
|
OpenClaw |
~/.openclaw/workspace/skills/ |
|
Codex |
~/.codex/skills/ |
示例（安装到 Claude Code/Warp）：
|
bash |
⚠️ 必须复制完整 Skill 目录（含SKILL.md+references/），不可仅复制单个文件。
验证安装
在 AI 工具中输入以下任意指令，确认 Skill 已识别：
- "我需要接入通联收付通协议支付"
- "帮我生成通联收银宝统一下单代码"
- "通联协议支付退款怎么写"
- "创建通联收银宝 Maven 工程"
AI 能识别并返回通联支付相关代码，即安装成功。
四、选择你的接入路径
先选产品线
|
Plain Text |
两套 SDK 对比
|
对比项 |
收付通协议支付 |
收银宝全量业务 |
|
SDK |
allinpay-sft-sdk-java |
allinpay-syb-sdk-java |
|
特点 |
垂直专用，固定签约 + 支付 + 退款流程 |
全场景覆盖，支持工程落地 |
|
核心能力 |
协议签约、银行卡代扣 |
统一下单、快捷支付、退款、撤销、文件处理 |
|
输出模式 |
仅业务代码 |
代码展示 + Maven 工程落地（双模式） |
|
适合场景 |
代扣、协议支付、固定流程 |
全场景收款、快速搭建工程 |
技能包包含内容
通联支付 Skills 共覆盖2 条产品线、2 个核心 Skill：
|
Skill 名称 |
功能 |
前置依赖 |
|
allinpay-sft-agreement-pay |
收付通协议支付全流程（签约 / 支付 / 查询 / 退款） |
无 |
|
allinpay-syb-sdk-unified |
收银宝全量接口路由 + Java Demo |
allinpay-syb-pay-shared-base |
语言支持
- 服务端：Java（完整支持）
- 构建工具：Maven（仅收银宝支持工程落地）
- 接入规范：先使用共享基础 Skill，再调用业务 Skill，不可跳过基础直接调用业务接口
五、快速开始
模块一：收付通协议支付（专用）
接入顺序
|
Plain Text |
端到端流程
|
Plain Text |
需求描述示例
|
你说 |
AI 会做什么 |
|
"接入通联收付通协议支付全流程" |
生成签约 + 支付 + 查询 + 退款完整代码 |
|
"通联协议支付签约短信怎么写" |
生成 310001 接口代码 |
|
"帮我写通联协议支付退款代码" |
生成 REFUND+200004 退款查询代码 |
|
"通联支付 HTTPS 超时怎么处理" |
生成超时查单的异常处理代码 |
模块二：收银宝全量业务（通用）
接入顺序
|
Plain Text |
核心输出模式
- show_code_only：仅生成可复制 Java 代码，不修改工程
- scaffold_java_maven_demo：生成 Maven 工程、自动添加依赖、创建可运行 Demo
端到端流程
|
Plain Text |
需求描述示例
|
你说 |
AI 会做什么 |
|
"接入通联收银宝统一下单" |
生成统一下单请求 + 响应代码 |
|
"帮我创建通联收银宝 Maven 工程" |
生成工程脚手架 + pom 依赖 + Demo 类 |
|
"只看代码，不修改工程" |
仅输出 Java 示例代码 |
|
"通联收银宝退款 + 查询" |
生成退款 + 查询接口代码 |
六、常见问题
Q1：Skills 安装后触发不了？
- 确认完整 Skill 目录（含md+references/）已复制到正确路径
- 重启 AI 工具重新加载技能
- 描述需求时包含通联、收付通、收银宝、协议支付等关键词
Q2：生成的代码报依赖错误？
- 收付通需添加依赖：
|
xml |
- 收银宝需添加依赖：
|
xml |
Q3：签名验签失败？
- 检查私钥、公钥、签名类型（SM2/RSA）与通联后台一致
- 确认未混用联调 / 生产密钥
- 收付通：私钥路径、密码配置正确
- 收银宝：SM4/MD5 密钥与后台匹配
Q4：交易状态一直 "处理中"？
- 间隔 5 秒轮询 200004 查询接口，最多 30 次（150 秒）
- 超时记录日志并人工介入，不自动关单
- 同时关注异步通知
Q5：协议支付与退款业务代码混用报错？
- 协议支付：使用09100专用业务代码
- 退款：使用09200专用业务代码
- 二者不可混用，否则返回 "未开通该业务代码"
Q6：HTTPS 超时 / 异常怎么处理？
⚠️ 严禁直接判定失败！必须调用200004 查询接口确认最终交易状态。
Q7：收银宝工程落地不支持 Gradle？
- 仅支持Maven工程，Gradle 需手动转换依赖配置