抖音支付接入集成 Skill (Douyin Pay Payment Integration Skill)

抖音支付为 AI Agent 提供了专业的技能包（Skills），将产品的业务知识、代码示例和接入规范以 Agent 可理解的方式组织，使 Agent 能够准确地协助开发者完成抖音支付的接入工作。

本 Skill 对应抖音支付的各项产品接入场景（如 APP 支付、H5 支付、JSAPI 支付、Native 支付等），包含：

• 业务知识 — 接入流程、参数说明、状态流转、签名与验签规则等，结构化整理，Agent 可直接检索。
• 代码示例 — 覆盖各接口的 API 调用示例（含服务端签名、回调解密及客户端参数透传），Agent 检索后展示，开发者参考即用。
• 交互规范 — 定义 Agent 的能力边界和交互流程（如禁止编造未知的 SDK 版本号），确保回答准确可靠。

核心覆盖场景

基于以上内容，本 Skill 覆盖接入过程中的五大场景：

| 场景 | 说明 | | --- | --- | | 产品选型 | 根据业务需求，引导开发者选择合适的抖音支付产品方案（如原生 APP 优先推荐客户端 SDK）。 | | 示例代码 | 提供各语言（Go、Java、PHP等）的 API 调用、回调验签、解密示例代码，开发者参考即用。 | | 知识问答 | 涵盖接入流程、参数说明、测试注意事项（如订单金额 1 分钱）、常见错误码等业务知识，随问随答。 | | 质量检测 | 协助开发者扫描代码，检查签名拼接顺序、回调幂等处理、并发控制锁、金额单位（分）等常见隐患。 | | 排障 | 根据开发者提供的错误信息（如 401 签名错误、解密异常等），定位问题原因，给出明确的排查与修复方案。 |

目录结构说明

• douyinpay-payment-integration/：抖音支付集成核心模块。
  • references/coding-guide.md：编码规范与注意事项，指导 Agent 按照统一标准生成符合抖音支付安全要求的代码。
  • references/app-sdk-integration-guide.md：APP 客户端 SDK 接入指南，规范客户端拉起支付流程。
  • scripts/：提供给 Agent 调用的辅助脚本工具（如 gen_rsa_key.sh 生成商户私钥，search_docs.sh 检索官方文档最新版本等）。

特别提醒

SKill集成提醒

1. 本Skill提供的内容（包括但不限于代码片段、参数解释、排查建议与流程指引）仅用于辅助开发者理 解与接入抖音支付，不构成任何明示或默示的承诺、保证或担保。开发者应结合自身业务场景独立评 估并自行验证接入方案与实现结果。
2. 在法律允许的范围内，抖音支付不对因使用或无法使用本Skill及其生成内容所导致的任何直接或间接 损失承担责任。
3. 本Skill仅做技术辅助，使用本Skill提供的内容不代表可通过抖音支付官方接入审核；开发者仍需自主完 成商户入网、资质提交、协议签署、密钥管理、风控配置等流程。

SKill效果提醒

1. 本Skill的输出质量与最终接入效果会受到开发者实际使用的模型能力、提示信息完整度、项目结构 复杂度、网络/权限环境等因素影响。同一问题在不同模型或不同上下文下可能产生差异化输出。

交流与反馈

在使用过程中遇到问题、有改进建议，或者想和其他开发者交流接入经验，欢迎提交 Issue 或联系抖音支付官方技术支持团队（抖音支付·商家平台 官网地址：pay.douyinpay.com ）。

安装方式

通过 npx 直接运行，无需手动安装：

npx @douyinpay_skill/douyinpay-payment-integration <command> [--global | --local | <target-dir>]

位置参数（三选一）：

| 参数 | 目标路径 | | --- | --- | | --global | 默认为 ~/.agents/skills/douyinpay-payment-integration | | --local | 当前运行命令的目录 | | <target-dir> | 指定任意目录 |

如有需要也可以手动复制npm包产物中的 douyinpay-payment-integration 目录到任意需要安装的位置。

使用方式

install

将 skill 部署到目标位置，若已存在则先清理再重装：

# 安装到全局目录 ~/.agents/skills/douyinpay-payment-integration
npx @douyinpay_skill/douyinpay-payment-integration install --global

# 安装到当前目录 ./douyinpay-payment-integration
npx @douyinpay_skill/douyinpay-payment-integration install --local

# 安装到指定目录 /path/to/dir/douyinpay-payment-integration
npx @douyinpay_skill/douyinpay-payment-integration install /path/to/dir

uninstall

移除指定位置的 skill 目录：

npx @douyinpay_skill/douyinpay-payment-integration uninstall --global
npx @douyinpay_skill/douyinpay-payment-integration uninstall --local
npx @douyinpay_skill/douyinpay-payment-integration uninstall /path/to/dir

常见 AI Coding 工具的 skill 目录

不同工具识别 skill 的目录各有约定，可根据你使用的工具选择合适的安装位置。下表中「用户级目录」以 ~（当前用户主目录）为前缀，全局生效；「项目级目录」为相对路径，需放在项目根目录下，仅对该项目生效。

| 工具 | 用户级目录 | 项目级目录 | | --- | --- | --- | | 通用 Agent 约定 | ~/.agents/skills/ | .agents/skills/ | | Claude Code | ~/.claude/skills/ | .claude/skills/ | | Cursor | ~/.cursor/skills/ | .cursor/skills/ 或 .agents/skills/ | | Trae | ~/.trae/skills/ | .trae/skills/ |

注：各工具目录约定可能随版本更新而变化，如有差异请以对应工具的官方文档为准。