Agent Skills
返回列表
微信支付接入指引

微信支付接入指引

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/wechatpay-payment-integration。

技能介绍

接入微信支付时最容易卡在哪里

许多团队不是缺接口文档,而是在产品选型、角色版本、字段含义、错误码和上线前检查之间反复切换。支付问题往往横跨 APIv3、回调、退款、对账和安全合规,凭记忆写代码容易把接口版本或角色搞错,导致查单失败、退款异常或线上资金风险。

这个技能如何工作

该技能围绕境内微信支付接入场景,要求先做资源同步和知识检索,再基于官方文档作答。核心能力包括:

  • 产品选型:根据业务场景、角色和资金链路匹配支付产品,避免把商户号角色或产品版本弄混。
  • 示例代码:对 curl、Java、Go 直接给出官方文档中的请求示例;其他语言只能作为“参考实现”提示用户自行审查。
  • 接入质量评估:加载质量检查清单,结合产品注意事项扫描代码,按 🔴🟡🟠 输出问题与修复方向。
  • 答疑与排障:作为兜底能力,检索文档回答字段、流程、错误码;需要验证交易状态时,可进入查单类排障流程。

关键步骤强调“先检索、后回答”:每轮先运行知识检索,读取对应文档,未覆盖时如实说明,而不是硬凑答案。

适用边界

它默认面向境内商户,不处理跨境支付。涉及非官方语言代码时必须显式说明为 AI 翻译参考;涉及线上操作前需要用户确认风险。它适合研发接入、联调排障和上线前检查,不适合替代业务决策、资金审计或人工安全评审。

使用场景

  • 新业务上线前,根据商户角色和资金链路选择合适微信支付产品。
  • 开发支付接口时,获取 curl、Java 或 Go 官方示例与文档链接。
  • 联调阶段遇到查单失败或错误码,定位交易状态并给出排查方案。
  • 上线前扫描支付代码,输出安全合规和资金链路问题清单。

适合人员

  • 后端工程师:需要接支付接口并排查 curl、Java 或 Go 示例。
  • 支付系统负责人:上线前审查资金链路和安全合规风险。
  • 联调测试工程师:定位查单失败、退款异常和错误码含义。
  • 业务研发:根据商户角色选择合适微信支付产品。