前言¶

接入通聯收付通時，協議支付往往要串起簽約短信、簽約確認、扣款、查單和退款，交易碼和業務代碼又多，官方文檔分散在多個章節。自己翻文檔寫 SftClient 調用，容易在狀態判斷、businessCode 混用、超時後是否查單等細節上踩坑。下面介紹 SkillHub 上的社區 Skill「通聯支付收付產品skill」，它把收付通 Java SDK 的公共約定、單接口說明和整條業務鏈路整理成 Agent 可路由的技能包，便於在 Cursor、Claude Code 等環境裏用自然語言生成對接代碼。

這是什麼¶

「通聯支付收付產品skill」（座標 @user_0512de0a/allinpay-sft-skill，當前版本 1.0.3，來源 community，發佈者 user_0512de0a）是面向 Agent 的收付通技能包，總入口對應通聯收付通 Java SDK allinpay-sft-sdk-java 1.0.3。Skill 頁簡介寫明：覆蓋簽約短信 310001、簽約確認 310002、協議支付 310011、交易查詢 200004、退款 REFUND 的全流程；包內還通過 flow/、api/ 擴展批量協議支付、實時代付、賬戶與對賬等場景。

在 SkillHub 上，該 Skill 分類爲 dev-programming，標籤含 requires_api_key=false（安裝 Skill 本身不要求單獨配置 SkillHub API Key；通聯商戶與 SDK 環境配置仍按收付通接入規範自行準備）。頁面統計（以抓取資料爲準）：評分 100000，下載 783，安裝 4。

核心功能¶

Skill 根目錄 SKILL.md 充當路由入口，生成代碼前要求先遵守 common/SKILL.md，再進入具體業務說明。

協議支付主鏈路¶

收款側「協議支付」完整鏈路在 flow/agreement-pay.md 中定義爲：

310001（簽約短信）→ 310002（簽約確認）→ 310011（協議支付）→ 200004（交易查詢）→ REFUND（退款）→ 200004（退款查單）

各步與 SDK 方法、成功判斷、落庫字段在流程文檔中有表格式說明，例如簽約確認用 isSigned()，資金類步驟用 isTrx* 系列判斷，處理中或超時需走 200004 查單而非直接判失敗。

更廣的產品與接口覆蓋¶

除簡介中的協議支付五步外，同一技能包還提供：

觸發描述（來自 SKILL.md）包括：收付通、通聯支付、SftClient、協議支付、代收代付、還款通、賬戶提現充值、對賬回單、退款、查單、返回碼等關鍵詞，Agent 會據此選擇 common/、flow/ 或 api/ 下的子說明。

與 SDK 對齊的硬性約束¶

技能包統一要求：

• Maven 依賴 com.allinpay.cus.sdk:allinpay-sft-sdk-java:1.0.3，包名 com.allinpay.cus.sdk.sft
• 金額單位爲分；businessCode 在支付與退款等場景不可混用（協議支付測試示例爲 19900，退款爲 09200，上線以業務方爲準）
• 資金/驗證類業務成功判斷禁止僅依賴 isSuccess()
• 出現 HttpTimeoutException 或處理中狀態時查單，禁止直接當失敗

安裝與啓用¶

通過 SkillHub CLI（推薦）¶

先確認本機已安裝 skillhub（安裝方式見 SkillHub 安裝說明）。安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。

command -v skillhub && skillhub --version

skillhub install allinpay-sft-skill --namespace user_0512de0a --dir ~/.cursor/skills/

常見 Agent 的 skills 路徑（摘自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可在對話中讓 Agent 按官方提示安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_0512de0a/allinpay-sft-skill`。

手動複製目錄結構¶

技能包 README 說明：標準 Agent Skills 形態爲「一個目錄 + 入口 SKILL.md」，需包含 SKILL.md、README.md 以及 common/、api/、flow/。示例（bash）：

DEST="$HOME/.cursor/skills/allinpay-sft-skills"
mkdir -p "$DEST"
cp SKILL.md README.md "$DEST/"
cp -r common api flow "$DEST/"

安裝完成後，在對話中提到「協議支付」「收付通」「310001」等描述中的詞，確認 Agent 已加載該 Skill。

工程側 SDK 依賴¶

生成代碼所依賴的 Maven 座標（與技能包版本一致）：

<dependency>
    <groupId>com.allinpay.cus.sdk</groupId>
    <artifactId>allinpay-sft-sdk-java</artifactId>
    <version>1.0.3</version>
</dependency>

典型用法¶

用法以自然語言描述場景爲主，由 Agent 按 SKILL.md 路由到對應 flow 或 api 文檔後生成 Java 串聯代碼。README 中的示例如下。

整鏈路：

我需要對接通聯收付通協議支付

按步驟拆開：

我需要對接通聯收付通協議支付簽約短信接口
我需要對接通聯收付通協議支付簽約確認接口
我需要對接通聯收付通協議支付扣款接口
我需要查詢通聯收付通的交易結果
我需要對通聯收付通的訂單發起退款

其它域可類似描述，例如「單筆實時代付 100014」「賬戶提現 300003」「對賬文件下載」。

協議支付流程文檔中還給出了步驟與數據依賴要點：310001 返回的 REQ_SN 作爲 310002 的 srcReqSn；簽約成功後的 agrmNo 需持久化並用於 310011；支付 REQ_SN 用於查單與退款的 orgBatchId 等。測試環境簽約短信驗證碼在流程說明中記爲 111111（以通聯官方環境爲準）。

適用場景與注意¶

適合誰

• 正在接入通聯收付通、使用 allinpay-sft-sdk-java 1.0.3 的 Java 後端或全棧開發者
• 需要協議支付從簽約到退款的標準串聯，或只需某一個交易碼的字段與調用示例
• 希望在 IDE 裏用 Agent 生成代碼，並統一遵守收付通狀態機、返回碼與查單規則

限制與注意

• 技能包聚焦 SDK 對接與代碼生成規範，不能替代通聯商戶入網、密鑰與生產環境配置；官方文檔入口見包內 README（如 收付通開放平臺、技術文檔）
• 社區來源 Skill，接入前建議在測試環境覈對交易碼、businessCode 與返回碼錶（包內 common/RETURN_CODES.md）
• Skill 生成約束要求：交付給商戶的代碼註釋中不應出現技能包內部編號或 SKILL.md 等字樣；修改接入方工程時已有配置項宜只追加、不刪改，鍵衝突需先說明

結尾¶

「通聯支付收付產品skill」把收付通協議支付核心交易碼與更完整的 flow/api 文檔裝進可路由的 Agent 技能包，並綁定 SDK 1.0.3 的初始化、判成功與超時查單規則，適合作爲收付通 Java 聯調時的對話側參考。

• SkillHub 頁面：https://www.skillhub.cn/skills/user_0512de0a/allinpay-sft-skill
• API 座標頁：https://api.skillhub.cn/user_0512de0a/allinpay-sft-skill