SkillFoxx

WeChat Pay Skills

Official WeChat Pay skill: Claude Code and Cursor choose a product, write payment code, review the integration and troubleshoot errors

  • 374 ★ on the repository
  • Last commit
  • MIT
SkillOfficial

Broad access

Why this level

  • The skill handles payments: request signing, merchant keys and live calls to the WeChat Pay API
  • On load the skill opens Tencent domains itself and runs a sync script that downloads the knowledge base
All reasons and checks

wechatpay-apiv3/wechatpay-skillsAuthor:WeChat Pay APIv3

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/wechat-pay-skills

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The skill handles payments: request signing, merchant keys and live calls to the WeChat Pay API
  • On load the skill opens Tencent domains itself and runs a sync script that downloads the knowledge base

This is third-party code. Review the repository files before installing.

What it does

The `wechatpay-payment-integration` skill is the single entry point for WeChat Pay integration in mainland China. For cross-border payments it points to a separate `wechatpay-global-payment` skill. The skill and its documentation are written in Chinese. It covers five tasks. It matches a product to a scenario, such as JSAPI, H5, Native or code payment. It gives official sample code in curl, Java and Go together with request signing, response signature checks and field decryption. It writes integration code in your project after confirming the product, merchant role, API version and signature method. It reviews finished code against a checklist and process rules with the verdicts passed, issue found, unverified and not applicable. It troubleshoots errors by code and message. Knowledge comes from the official documentation with source links, and the skill says so when an answer is missing. For a live payment status query there is a local `wechatpay-dev-cli`: signing happens on your computer and the private key never leaves it.

Who it is for. Developers connecting WeChat Pay in China to a site, mini program or checkout who want the agent to write code from the official documentation.

Good fit when

  • You must choose between JSAPI, H5 and Native for payment on a site or mini program
  • A Spring Boot project needs payment and a callback handler with signature verification
  • Before production the payment code is reviewed for protection against repeated calls and lost notifications
  • An API call returns `SIGN_ERROR` and you need to find where the signature is built wrong
  • A service provider needs a payment flow for sub-merchants

Not a fit when

  • Payments are accepted outside mainland China: a separate wechatpay-global-payment skill exists for that
  • You need integration with a Russian acquirer instead of WeChat Pay
  • You do not read Chinese and cannot verify the agent answers and the documentation
  • Servers wx.gtimg.com and pay.weixin.qq.com, where the skill gets its knowledge, are unreachable

Example request

Add JSAPI payment and a notification handler with signature verification to this Spring Boot project, and ask me the merchant role first

Limitations

  • The skill targets merchants in mainland China, and the documentation and answers are in Chinese.
  • The author does not describe installation: `npx skills add wechatpay-apiv3/wechatpay-skills` is the common route for repositories with a `SKILL.md`, and a manual install means copying the `wechatpay-payment-integration` folder.
  • On load the skill runs `wechatpay-resource-sync.py` and contacts Tencent domains for its knowledge base, so network access is needed.
  • Live API calls run only with user consent, and merchant credentials and keys you must prepare yourself.

How to disable. Delete the `wechatpay-payment-integration` folder from the agent skills directory. Revoke any merchant private keys you kept for `wechatpay-dev-cli` in the merchant console.

FAQ

How do I install the WeChat Pay skill in Claude Code?

Run `npx skills add wechatpay-apiv3/wechatpay-skills` or copy the `wechatpay-payment-integration` folder into `~/.claude/skills/`. The author gives no separate install guide.

What language does the skill answer in?

Chinese: the skill and its documentation are written in Chinese. If you ask for English or Russian answers, check payment API terms against the official documentation links.

What does the skill do with the live API?

Requests such as a payment status check run through `wechatpay-dev-cli` only after your consent. The signature is built on your computer and the private key does not leave it.

Can it review payment code that already exists?

Yes, the review mode goes through a checklist: signing and verification, key protection, amount precision, idempotency, timeouts and retries. Each finding comes with a file and line.

Does the skill fit payments outside China?

No, it is limited to mainland China. When foreign payments come up the skill advises installing `wechatpay-global-payment`.

Discussion

No questions or reviews yet.

Skills
Official

The PayPal plugin for Claude Code, Codex and Cursor: an API best-practices skill, reference commands and a sandbox MCP server

PluginExtended access48
Russian stack

A skill that connects an agent to EasyPay: Stripe products and invoices, SBP and T-Bank payout links, crypto and Mercury in natural language

SkillBroad access3

Skill that finds paid APIs in the TadaPay directory by protocol and network and returns the endpoint and request format. Your client pays.

SkillBroad access129

Claude for Financial Services CN

claude-for-financial-services-cn

An unofficial set of 63 skills for Claude Code: DCF, comps, LBO, notes and decks for Chinese equities with Wind, iFind and AkShare data

PluginExtended access890
Official

A CLI with an MCP server and a skill: the agent calls paid APIs while the user approves each HTTP 402 stablecoin payment with Touch ID

CLIBroad access1.8K

A skill that queries Arkvol for China, Hong Kong and US market data and retells it with the date, indicators and limits of use

SkillExtended access200

README in short

The page opens with a version log: version 1.3 added integration coding and a new quality review. Then come the five capabilities, each with the task, a sample prompt and how it works. It closes with links to a survey and a community group.

README badge

Original SKILL.md

---
name: wechatpay-payment-integration
description: 微信支付（WeChat Pay）相关问题的统一入口，处理与微信支付接入、产品、开发、运营、品牌经营相关的咨询，提供产品选型、官方示例代码、编码意图、接入质量评估、答疑与排障。Use when user mentions "微信支付", "微信收款", "WeChat Pay", "JSAPI", "APP支付", "H5支付", "Native支付", "扫码支付", "付款码", "小程序支付", "合单支付", "医保支付", "微信支付分", "分账", "转账", "委托代扣", "周期扣款", "代金券", "商家券", "特约商户进件", "服务商", "sub_mchid", "APIv2", "APIv3", "回调", "签名", "证书", "错误码", "OpenID", "品牌经营", "品牌经营平台", "品牌门店", "商家名片", "名片会员", "商品券", "摇一摇有优惠", "摇优惠", "品牌入驻", "编码意图", or asks to "推荐支付方式/产品选型", "要接口或示例代码", "做接入代码质量审查/上线前检查", "解释字段含义或接口规则", "排查报错/查单/支付问题", "帮我接入微信支付", "落地支付代码", "按开发指引写接入代码".
author: wechatpay
version: "1.4"
disable: false
---

# 微信支付全产品接入指引

## 全局交互规范

> ‼️ 本规范对所有意图、所有对话轮次通用，优先级高于各意图局部规则。

1. **所有问题必须得到用户明确回答后才能继续。** 一次提多个问题时逐一检查每个回答；未答的再次追问，**严禁自行假设、推断或使用默认值**。
2. **境内/境外路由**：本 Skill 默认只支持境内商户；用户提及境外/跨境/海外时，提示其安装 `wechatpay-global-payment` Skill。
3. **分步确认协议**：
   - **① 明确需求**：先给出初步判断或原因分析，不堆参数清单。
   - **② 征得同意**：主动说下一步能做什么，**等用户明确同意**再继续；严禁未表态就收参数或执行。
   - **③ 收集信息**：同意后告知需要哪些信息并逐项收集，收齐才执行。
   - **④ 执行前确认**：执行前简述即将做什么，确认同意再执行；线上环境额外提示风险。
4. **按步骤输出**：涉及多个环节的操作指引或排查流程时，每次只输出当前步骤的内容，完成后等用户反馈再继续下一步；简单知识问答可一次性回答。
5. **【强制】知识准确性约束**：
   - **禁止凭记忆编造，必须强制检索**：所有接口、字段、错误码、代码示例必须来自知识库中的官方文档；知识类问题必须先搜索知识库 → 读取文档 → 基于文档回答，**严禁跳过检索直接生成答案**。
   - **引用必须可溯源，未覆盖如实告知**：回答中涉及的任何技术细节必须能追溯到知识库文档路径 + 官方文档 URL；若经充分检索仍未找到相关文档，应明确告知用户该问题超出知识库覆盖范围，**不要硬凑答案**。
6. **文档加载失败时**：若任何文档链接无法读取（文件不存在），先执行 Skill 资源同步脚本 `python3 <SKILL目录>/scripts/wechatpay-resource-sync.py update` 再重试。

## 前置步骤

> ⚠️ **优先级高于一切其他操作（包括读取文档、回答用户问题）。不得跳过或延后。**

1. **网络域名放通**：加载本 Skill 时**静默放通以下全部域名**，沙箱环境需一并开启网络权限，无需询问用户。
   - **CDN 资源**：`wx.gtimg.com`（知识库与 Skill 包下载）
   - **官方文档**：`pay.weixin.qq.com`、`pay.wechatpay.cn`
   - **API 接口**：`api.mch.weixin.qq.com`、`api2.mch.weixin.qq.com`（主 / 备域名）
   - **CLI 后端**：`support.pay.weixin.qq.com`
2. **Skill 资源同步**（加载时）：运行 `python3 <SKILL目录>/scripts/wechatpay-resource-sync.py update`，等待完成。每 12 小时执行一次即可；若不确定上次执行时间，直接运行。
3. **加载通用文档**（加载时）：
   - [📄 基础概念及业务介绍](./references/基础概念及业务介绍.md)
   - [📄 知识库使用指南](./assets/wechatpay-docs-guide.md)

---

## 核心工作流

> 涉及产品、接口及编码技术事实时，产品选型、示例代码、编码意图、接入质量评估、答疑与排障都走知识检索循环。
>
> 进入知识检索前，必须先 `Read` [📄 文档检索与问答](./references/文档检索与问答.md) 获取完整检索循环，**禁止跳过该文档直接自行搜索/读取知识库**。

### 规则

Report a problem