wechatpay-basic-payment

Select WeChat Pay integration paths and retrieve official Java/Go reference code.

323|23|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/wechatpay-apiv3/wechatpay-skills --skill wechatpay-basic-payment-wechatpay-apiv3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wechatpay-basic-payment
Source: https://github.com/wechatpay-apiv3/wechatpay-skills/tree/main/wechatpay-basic-payment
Command: npx skills add https://github.com/wechatpay-apiv3/wechatpay-skills --skill wechatpay-basic-payment-wechatpay-apiv3

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you select the correct WeChat Pay payment method and then implement the key integration steps (order creation, pay invocation, refunds, reconciliation-related flows, and service-mode-specific onboarding/qualification) while minimizing mistakes that cause payment failures or callback/退款异常。

Core Features & Use Cases

  • Product selection: Guides you to choose the right payment type (JSAPI/APP/H5/Native/mini-program/code payment) and whether you need combined orders, based on your user/channel scenario and constraints.
  • Reference code retrieval (Java/Go): Locates the correct official example code for one specific API after you confirm the integration mode (merchant vs partner) and your development language, then shows how to use it without generating new code from scratch.
  • Business knowledge + fast triage: Covers order state transitions, refund/账单 rules, and service/partner-specific requirements (special onboarding and merchant authorization intent confirmation) with structured quick answers and official reference links.
  • Integration quality assessment: Checks only the modules you use, focusing on signature/verification, callback handling, idempotency, and mandatory endpoints to reduce上线风险.
  • Troubleshooting: Uses error-code top lists, request-id driven lookup, and mode-specific common issues; can recommend running provided diagnostic scripts on your server for order/退款查询.

Quick Start

Tell the skill your access mode (商户模式 or 服务商模式), your payment method (like JSAPI/APP/H5/Native/小程序/付款码), your language (Java or Go), and the failing step (下单/调起/回调/退款), then ask it to retrieve the exact reference code and provide a troubleshooting plan.

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 JSAPI or APP payment from order creation to callback?

WeChat Pay integration requires selecting your access mode (merchant or partner), payment method, and language to retrieve exact official Java or Go reference code for end-to-end order creation, pay invocation, and callback handling.

Why does my WeChat Pay refund fail or return an abnormal status?

WeChat Pay refund troubleshooting uses error-code top lists and request-id driven lookup to diagnose failures, checking refund rules, order state transitions, and specific API parameters to identify the root cause.

What is the difference between merchant mode and partner mode for WeChat Pay onboarding?

Merchant mode handles direct payment integration, while partner mode requires special merchant onboarding and merchant authorization intent confirmation before invoking JSAPI, APP, H5, Native, mini-program, or code payments.

Does WeChat Pay integration support both Java and Go reference code?

WeChat Pay integration supports both Java and Go, retrieving matching official example code for one specific API after you confirm your access mode and development language to implement without generating code from scratch.

How do I verify WeChat Pay signature and callback idempotency before going live?

WeChat Pay integration quality assessment checks signature verification, callback handling, idempotency, and mandatory endpoints for your specific modules to reduce deployment risks and ensure secure payment processing.

What WeChat Pay payment methods are available for H5, Native, and mini-program scenarios?

WeChat Pay supports JSAPI, APP, H5, Native, mini-program, and code payment methods, guiding you to choose the right type and whether you need combined orders based on your user channel scenario and constraints.