一、概述
通联支付 Skills 是通联支付推出的 AI 代码生成技能包。安装到 AI 编码工具后，用自然语言描述需求，即可生成符合通联 SDK 规范的完整接入代码，覆盖云商通2.0、收单产品（收银宝SYB）、收付产品（收付通SFT）三大核心产品线。
传统对接 vs Skills 对接：
|
传统方式 |
Skills 方式 |
|
1. 打开 SDK 文档 |
1. 告诉 AI "接入通联协议支付" |
|
2. 定位接口、阅读参数表 |
2. 自动生成完整代码 |
|
3. 手写请求代码 |
3. 替换商户参数 |
|
4. 处理签名逻辑 |
4. 完成 |
|
5. 编写异步通知接收 |
|
|
6. 调试、排查错误码 |
你会得到什么：
|
Skill 方式 |
版本记录
|
版本 |
日期 |
下载地址 |
版本说明 |
|
v1.0.0 |
2026/4/16 |
Skillhub |
初始版本，覆盖云商通2.0、收银宝、收付通全产品线 |
二、接入前准备
在安装 Skills 之前，你需要先在通联对应平台侧获取或配置如下参数：
|
平台 |
参数名称 |
获取/配置方式 |
|
云商通2.0 |
appid(应用ID) |
通联客户经理提供 |
|
云商通2.0 |
allinpayPublicKey（通联公钥SM2用于验签） |
应用开通后法人接收云梯门户短信，从云梯门户获取； |
|
云商通2.0 |
merSecretKey（商户加密秘钥用于 SM4 加密） |
应用开通后法人接收云梯门户短信，从云梯门户获取； |
|
云商通2.0 |
merPrivateKey（商户私钥SM2用于签名） |
应用开通后法人接收云梯门户短信，从云梯门户获取； |
|
收银宝 |
cusid(商户号) |
通联客户经理提供 |
|
收银宝 |
appid(应用ID) |
在收银宝商户平台自行配置 |
|
收银宝 |
privateKey(私钥) |
在收银宝商户平台自行根据签名方式配置 |
|
收银宝 |
publicKey(公钥) |
在收银宝商户平台自行根据签名方式获取 |
|
收付通 |
MERCHANT_ID（商户号） |
通联客户经理提供 |
|
收付通 |
USER_NAME（用户名） |
通联客户经理提供 |
|
收付通 |
BUSINESS_CODE（业务代码） |
通联客户经理提供 |
|
收付通 |
privateKey(私钥) |
商户自己生成并配置在商户侧的程序中 |
|
收付通 |
publicKey(公钥) |
在收付通商户平台自行配置 |
安全要求：
- 所有密钥通过环境变量注入，严禁硬编码到源码或上传到代码仓库
- 联调阶段使用联调专用密钥，不要提供生产密钥
- 日志中避免打印完整密钥信息
三、安装
获取技能包
从 Skillhub（https://skillhub.cn/）获取通联支付技能包发布包。
# 通联支付云商通产品skill下载地址
https://skillhub.cn/skills/allinpay-yst-skill
# 通联支付收单产品skill下载地址
https://skillhub.cn/skills/allinpay-syb-skill
# 通联支付收付产品skill下载地址
https://skillhub.cn/skills/allinpay-sft-skill
安装到 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 已被识别：
|
Plain Text |
如果 AI 能识别并回应通联相关内容，说明安装成功。
四、选择你的接入路径
先选产品线
|
你的场景是什么？ |
技能包包含什么
当前技能包覆盖 3 条产品线、多个 Skill：
|
Skill 标识 |
产品名称 |
核心功能 |
适用业务场景 |
依赖 SDK 版本 |
|
allinpay-yst-skill |
通联云商通 2.0 |
全链路支付接入助手，覆盖产品选型、代码生成、质量检查、端到端演示，同时提供问题排查、业务知识查询与接口索引能力 |
接入云商通 2.0 综合支付版、消费 / 退款申请、订单查询、对账、统一收银台、代收代付、国密加解密等服务，后续陆续更新KA 客户版、ISV 服务版 |
未单独指定（复用云商通官方 SDK） |
|
allinpay-syb-skill |
通联收单产品 (收银宝SYB） |
覆盖 allinpay-syb-sdk-java 全量 request API，按场景自动路由并生成可运行 Java Demo，提供 "仅看代码 / 工程落地" 两种输出模式 |
通联收银宝收单业务的后端 Java 项目快速集成与开发 |
allinpay-syb-sdk-java:1.1.10 |
|
allinpay-sft-skill |
通联收付产品 （收付通SFT） |
生成协议支付完整流程调用代码，覆盖从签约到退款的全业务链路，包含标准化的状态判断与异常处理逻辑 |
后端 Java 项目接入通联收付通协议支付，实现银行卡签约、代扣支付、交易查询、退款等功能 |
allinpay-sft-sdk-java:1.0.0 |
五、快速开始
（1）云商通2.0
接入顺序：
|
① yst-base SDK 初始化 + 产品选型 |
你可以这样描述需求：
|
你说 |
AI 会做什么 |
|
"接入通联云商通 H5 支付" |
对接完成 H5 统一收银 |
|
"生成通联云商通小程序支付代码" |
对接完成小程序支付 |
|
"接入云商通综合支付退款" |
对接完成退款交易 |
重要： 前端支付完成回调不等于最终交易成功。最终状态必须由服务端查询接口或异步通知确认。
（2）收银宝扫码支付
接入顺序：
|
① syb-base SDK 初始化 |
你可以这样描述需求：
|
你说 |
AI 会做什么 |
|
"接入通联收银宝微信扫码支付" |
生成微信主扫支付代码 |
|
"生成通联收银宝支付宝被扫代码" |
生成支付宝付款码支付代码 |
|
"查询收银宝订单状态" |
生成交易查询代码 |
（3）收付通协议支付
接入顺序：
|
① sft-base SDK 初始化 |
端到端流程：
|
Plain Text |
你可以这样描述需求：
|
你说 |
AI 会做什么 |
|
"接入通联收付通协议支付" |
生成签约 + 支付 + 查询 + 退款完整代码 |
|
"生成通联协议支付签约代码" |
生成签约短信触发和签约确认代码 |
|
"帮我写通联收付通的交易查询" |
生成交易查询代码 |
|
"对这笔收付通订单退款" |
生成退款申请 + 退款查询代码 |
六、常见问题
Q：Skills 安装后触发不了？
- 确认完整 Skill 目录（含 SKILL.md + references/）已复制到正确路径
- 重启 AI 工具使其重新加载技能
- 描述需求时包含明确的产品关键词，如 "通联"、"云商通"、"收银宝"、"收付通"
Q：生成的代码报依赖错误？
项目中需要先添加对应 SDK 依赖：
- 云商通2.0：
|
xml |
- 收银宝：
|
xml |
- 收付通：
|
xml |
Q：为什么生成的代码里没有硬编码密钥和配置？
- 这是 Skill 的强制安全规则：所有敏感配置必须从环境变量或配置文件读取
- 代码中只会生成配置项占位符，需要开发者自行替换为实际的商户信息
- 严禁将密钥硬编码到源码或上传到代码仓库
