前言¶
在抖音生態裏做收款，常見難點不是「有沒有文檔」，而是 App、H5、JSAPI、Native 等產品線多，選型與對接步驟容易混在一起。團隊往往要在商戶平臺規則、各端能力與退款流程之間反覆查資料，Agent 也容易給出與當前場景不匹配的方案。
下面介紹 SkillHub 上的社區 Skill「抖音支付集成」，它把抖音支付商戶平臺接入的最佳實踐整理成可被 Agent 調用的指導，覆蓋多支付形態與退款等能力，便於在編碼對話裏按場景追問、按步驟落地。
這是什麼¶
「抖音支付集成」是 SkillHub 座標 @user_8509461a/douyin-pay-integration 上的社區 Skill（business-ops 分類），當前版本 1.0.0，由發佈者 user_8509461a 維護；SkillHub 頁面標註作者爲蜀企投管（四川省）企業管理有限公司。
官方簡介：抖音支付商戶平臺接入最佳實踐，涵蓋 App 支付、H5 支付、JSAPI 支付、Native 支付、訂單退款等全場景的產品選型與集成指導。標籤 requires_api_key=true 表示對接真實商戶能力時需要你在平臺側準備並妥善保管 API 密鑰類憑證，Skill 本身不替代商戶開戶與密鑰發放流程。
核心功能¶
以下能力均來自 SkillHub 官方頁面與抓取元數據，不展開未在資料中出現的接口細節：
- 產品選型：在 App、H5、JSAPI、Native 等支付形態之間，按業務場景做接入方式選擇。
- 集成指導：圍繞商戶平臺接入路徑，給出可跟進的集成步驟與注意事項（具體步驟以安裝後 Skill 內
SKILL.md爲準）。 - 退款場景：包含訂單退款相關接入與流程說明（與「支付下單」並列的全場景之一）。
Skill 的定位是指導型 Skill，適合交給 Cursor、Claude Code、Codex 等帶 Skills 能力的 Agent，在寫代碼或排錯時引用平臺實踐，而不是單獨運行的支付 SDK。
安裝與啓用¶
方式一：用 SkillHub CLI 安裝（推薦）¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法識別。常用路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
在對應目錄下執行：
skillhub install user_8509461a/douyin-pay-integration --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 換成你實際使用的 Agent skills 路徑。安裝後按各客戶端說明重啓或刷新 Skills 列表。
方式二：讓 Agent 按官方提示安裝¶
SkillHub 技能頁提供的安裝提示爲：請根據 SkillHub 安裝與優先源配置，安裝 @user_8509461a/douyin-pay-integration。把該句發給已配置 SkillHub 能力的 Agent 即可走同一套安裝流程。
API 元數據地址（供工具鏈拉取 Skill 包）：https://api.skillhub.cn/user_8509461a/douyin-pay-integration
人類可讀頁面：https://www.skillhub.cn/skills/user_8509461a/douyin-pay-integration
典型用法¶
資料中未附帶獨立代碼倉庫示例；通用用法是安裝並啓用 Skill 後，在對話裏用具體場景提問，由 Agent 結合 Skill 內的商戶平臺實踐作答。可按下面思路復現：
- 說明業務端類型（例如 H5 收銀臺、抖音內 JSAPI、原生 App 等）與是否涉及退款。
- 明確你已在抖音支付商戶平臺完成必要配置，並說明密鑰、應用 ID 等由你在安全環境中管理（勿把密鑰貼進對話）。
- 讓 Agent 給出選型結論、對接順序、需要覈對的配置項，以及與你技術棧相關的僞代碼或接口調用提綱。
示例提示（僅作對話模板，非官方固定命令）：
已安裝 @user_8509461a/douyin-pay-integration。我們要在移動端 H5 完成抖音支付下單，
請按 Skill 裏的最佳實踐說明應選哪種產品、接入順序和退款接口要注意什麼。
更細的字段名、簽名算法與請求示例以 Skill 安裝包內文檔及抖音支付商戶平臺現行文檔爲準。
適用場景與注意¶
適合誰
- 需要在抖音相關業務裏接入支付或退款的 backend / 全棧開發者。
- 希望減少在多份官方文檔間手工對照，用 Agent 按場景拉齊選型與集成步驟的團隊。
限制與注意
- 社區來源（
community），版本 1.0.0；平臺規則或接口若有更新，應以商戶平臺最新文檔爲準，必要時在 SkillHub 檢查是否有新版本。 requires_api_key=true：生產密鑰只能放在你的配置與密鑰管理系統中，不要寫入倉庫或公開 Issue。- SkillHub 頁面統計（抓取時）：評分 100000，下載 1441，安裝 122——僅反映商店側熱度，不代表對接成功率；上線前仍需在沙箱或小額環境自測。
- 本文未覈實 Cursor / Codex CLI / Claude Code 在 2026-10-21 的專屬一鍵安裝差異；除 skills 目錄路徑外，其餘按各產品官方 Skills 說明操作。
結尾¶
「抖音支付集成」把抖音支付商戶平臺的多形態支付與退款接入，收斂成 Agent 可調用的最佳實踐 Skill，適合在 SkillHub 安裝後，用場景化提問驅動集成與排錯。
官方技能頁：https://www.skillhub.cn/skills/user_8509461a/douyin-pay-integration
API / 安裝座標：https://api.skillhub.cn/user_8509461a/douyin-pay-integration，@user_8509461a/douyin-pay-integration
