技能介绍

解决的问题

接入通联收付通协议支付时，最容易踩坑的不是单个接口调用，而是状态机：签约、代扣、退款、查询之间依赖不同流水号，返回码语义分散，0000 与 4000 都表示成功，而 2000、2007、2008、1108、1000 必须继续查询，HTTPS 超时也不能直接判失败。这个技能面向后端 Java 项目，目标是把通联 SDK 的文档、示例和返回码规则压缩成可落地的调用代码。

技能如何工作

技能按业务链路生成代码，而不是零散接口示例：

签约阶段：先用 310001 触发签约短信，保存 REQ_SN；再用 310002 校验验证码，拿到 AGRMNO 协议号。
支付阶段：使用 310011 和协议号发起代扣，保存交易流水，并按返回码判断是否需要 200004 查询。
查询阶段：对支付和退款统一使用 200004，重点处理 1002、处理中状态和明细返回码。
退款阶段：使用 REFUND 发起退款，注意退款业务代码与协议支付业务代码不能混用。

代码生成会强调 SDK 推荐判断方式，例如 isTrxSuccess()、isTrxFailed()、getErrMsg()；查询接口在 SDK 1.0.2 中还应使用 QueryDetail.isSuccess() 判断每笔明细。

适用边界与注意点

该技能适合已有通联 SDK、商户代码、业务代码和密钥文件的 Java 工程。资料未提供完整代码示例时，不应把示例中的商户号、卡号、验证码当作真实凭证。测试环境短信验证码固定为 111111，仅用于联调；生产环境必须按真实短信、真实密钥、真实业务代码接入。若涉及 SM2 与 RSA 签名，签名类型必须和密钥格式匹配，p12 私钥需配置密码。