前言¶
在抖音生态里做收款，常见难点不是「有没有文档」，而是 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
