User GuidePayment
WeChat Pay Configuration
Configure WeChat Pay
WeChat Pay is the primary payment method for Chinese users, supporting QR code and JSAPI payment.
Setup Steps
- Visit WeChat Pay Merchant Platform
- Register merchant account
- Get Merchant ID and API key
- Download API certificate
Environment Variables
WECHAT_PAY_MCH_ID="your-merchant-id"
WECHAT_PAY_SERIAL_NO="your-certificate-serial-no"
WECHAT_PAY_PRIVATE_KEY="your-private-key"
WECHAT_PAY_APIV3_KEY="your-apiv3-key"
WECHAT_PAY_NOTIFY_URL="https://yourdomain.com/api/payment/wechat/webhook"API Certificate Configuration
- Login Merchant Platform → Account Center → API Security
- Apply for API certificate
- Download certificate files
- Extract private key content
Private key needs to be converted to single line format, using \n for line breaks.
Supported Payment Scenarios
| Scenario | Description |
|---|---|
| Native Payment | QR code payment, for PC web |
| JSAPI Payment | Payment in WeChat built-in browser |
Configure Pricing
export const paymentConfig = {
mode: 'one-time',
defaultProvider: 'wechat',
oneTimePlans: [
{
id: 'basic',
name: 'Basic',
price: 99,
currency: 'CNY',
features: ['Lifetime use'],
}
]
}Important Notes
- WeChat Pay requires enterprise qualification
- Callback URL must use HTTPS
- Amount unit is cents (1 yuan = 100 cents)