A comprehensive technical and operational guide for integrating and managing the WeChat Pay financial ecosystem.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wechatpay
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wechatpay using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WeChat Pay Ecosystem & Integration Specialist?
The WeChat Pay Ecosystem & Integration Specialist skill is a robust resource for developers and businesses looking to leverage Tencent's financial technology. It provides deep technical insights into the Openclaw Skills framework for payment processing, covering everything from active and passive scanning to complex mobile SDK implementations. This skill bridges the gap between merchant requirements and technical execution, ensuring a seamless user experience across various platforms.
By utilizing this skill, teams can navigate the complexities of real-name verification, risk management, and the evolution of biometric payments like Palm-to-Pay. It serves as an essential manual for building secure, scalable, and compliant financial applications within the massive WeChat ecosystem, focusing on both regional and cross-border capabilities.
WeChat Pay Ecosystem & Integration Specialist Use Cases
- Implementing Native Pay for PC-based e-commerce websites using dynamic QR codes.
- Integrating App Pay into iOS and Android applications via the WeChat Mobile SDK.
- Developing payment flows for WeChat Mini Programs and Official Accounts using JSAPI.
- Setting up password-free withholding for subscription-based services and recurring billing.
- Troubleshooting merchant-side errors such as payment failures or category restrictions.
- Migrating legacy payment systems from the V2 XML-based API to the modern V3 JSON API.
How WeChat Pay Ecosystem & Integration Specialist Works
- Scenario Identification: The skill identifies the payment context—whether it is active scanning, passive scanning, or in-app payment.
- Pre-order Creation: For digital integrations, the merchant server communicates with the WeChat Pay API to generate a
prepay_idor QR code. - Authentication & Security: The system validates the transaction against real-name verification and internal risk control monitors.
- Payment Invocation: The user confirms the transaction via the WeChat interface using a password, fingerprint, or face ID.
- Callback & Notification: The WeChat Pay server sends an asynchronous callback notification to the merchant's server to confirm the order status.
- Settlement & Reconciliation: The transaction is logged for financial reporting, refund management, and potential cross-border currency conversion.
WeChat Pay Ecosystem & Integration Specialist Setup
To begin integrating this skill into your workflow, ensure your environment is configured for the WeChat Pay V3 API. Use the following steps to initialize your development environment:
# Install the official WeChat Pay SDK for your language (e.g., Node.js)
npm install wechatpay-node-v3
# Configure your Merchant ID and API Certificates
export WECHAT_MCH_ID="your_merchant_id"
export WECHAT_API_KEY_PATH="./certs/apiclient_key.pem"
Ensure that your server can receive HTTPS POST requests for the payment callback notification.
WeChat Pay Ecosystem & Integration Specialist Data Schema & Taxonomy
The skill manages payment data through a structured taxonomy focused on security and transaction integrity:
| Data Object | Description | Key Fields |
|---|---|---|
| Transaction | Core payment record | transaction_id, out_trade_no, amount |
| Payer Info | User identification | openid, is_subscribe |
| Security | Risk management data | spbill_create_ip, sign_type, nonce_str |
| Refund | Post-payment records | refund_id, out_refund_no, status |
All metadata is structured in JSON for V3 API compatibility, replacing the older XML format for improved parsing efficiency.
WeChat Pay Ecosystem & Integration Specialist Advanced Features
- V3 API Migration: Specialized tools for moving from XML-based V2 systems to modern JSON-based architectures.
- Marketing Tool Integration: Built-in support for the Cash Vouchers and Store Coupons APIs to drive user conversion.
- Biometric Processing: Guidelines for integrating Brush-to-Pay (Face) and Palm-to-Pay hardware systems.
- Cross-Platform Interoperability: Support for UnionPay Cloud QuickPass and JD Pay cross-scanning scenarios.
- Subscription Auto-debit: Advanced configuration for recurring payments and highway toll withholding.
SKILL.md
Loading
Related Openclaw Skills
Zsh Themes Reference
A documentation-focused reference tool providing immediate access to Zsh Themes concepts, security patterns, and implementation best practices.
Veterinary Clinic Operations Agent
An automated operational assistant designed to optimize scheduling, inventory, and client communication for veterinary practices.
Schema Markup
A specialized technical skill for implementing, fixing, and optimizing schema.org structured data to earn Google rich results.
Rails TDD Standards
A comprehensive guide for implementing high-quality RSpec testing and FactoryBot patterns in Ruby on Rails applications.
TikTok Video Analyzer
A strategic tool designed to break down TikTok performance drivers and extract actionable content lessons for creators and ecommerce brands.
Limit Authority
A high-priority safety protocol that mandates explicit user confirmation and full path transparency for all AI-driven file modifications.
Featured*
