wechatpay-basic-payment

Integrate WeChat Pay transactions, refunds, and settlement workflows with APIv3 signing.

8|1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Tugoukezhang/workbuddy-skills --skill wechatpay-basic-payment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wechatpay-basic-payment
Source: https://github.com/Tugoukezhang/workbuddy-skills/tree/main/skills/wechatpay-basic-payment
Command: npx skills add https://github.com/Tugoukezhang/workbuddy-skills --skill wechatpay-basic-payment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill centralizes the complexities of integrating WeChat Pay, including payments, refunds, settlements, merchant onboarding, and risk checks, to accelerate secure deployments and reduce integration risk.

Core Features & Use Cases

  • Product selection guidance: help choose between JSAPI/APP/H5/Native/mini-program by scenario.
  • Code samples & interfaces index: provide ready-to-reference code templates and the corresponding API endpoints.
  • Business knowledge quick lookup: quick access to states, refund rules, and reconciliation basics.
  • Quality & troubleshooting: guidance for integration checks, signature validation, and callback handling.
  • Use cases: e.g., merchant wants to implement refunds and split refunds across sub-merchants.

Quick Start

Load the appropriate interface index for your integration mode and begin with the sample for your payment method.

Frequently Asked Questions about wechatpay-basic-payment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate WeChat Pay APIv3 with certificate-based signing for production deployments?

To integrate WeChat Pay APIv3, you must construct requests using certificate-based signing, verify responses, handle callbacks, and apply robust error handling for secure production deployments across JSAPI, APP, H5, Native, and mini-program scenarios.

What is the best way to choose the right WeChat Pay payment method for my application scenario?

Choosing the right WeChat Pay payment method requires evaluating your application scenario to select between JSAPI, APP, H5, Native, or mini-program integrations, ensuring the payment flow aligns with your specific user interaction environment.

How do I handle WeChat Pay refund rules and split refunds across sub-merchants?

Handling WeChat Pay refunds and split refunds across sub-merchants involves applying specific refund rules and settlement workflows, accessing business state lookups, and utilizing provided code templates to manage sub-merchant reconciliation accurately.

Why does my WeChat Pay callback signature validation fail during integration testing?

WeChat Pay callback signature validation fails when certificate-based signing is incorrectly applied or response verification is skipped, requiring strict adherence to APIv3 request construction and callback handling checks to resolve the issue.

Can I use this integration guide for merchant onboarding and risk checks?

Yes, you can use this integration guide for merchant onboarding and risk checks, as it centralizes complexities like settlements, onboarding workflows, and risk checks to accelerate secure deployments and reduce integration risk.

What are the limitations when troubleshooting WeChat Pay settlement workflows?

Troubleshooting WeChat Pay settlement workflows is limited by the need for precise APIv3 request construction and response verification; errors often stem from incorrect certificate-based signing or inadequate handling of settlement state transitions.