为什么提供微信支付？
800M+ Users
WeChat 的月活跃用户超过 10 亿，WeChat Pay 的用户超过 8 亿。
Mobile-First
客户会在 WeChat 应用内批准付款，中国客户已经熟悉这一流程。
Dual Currency
根据您的客户群体，选择使用 USD 或 CNY 计费。
概述
工作原理
客户体验
- 客户在结账时选择 WeChat，然后点击 Pay。
- 结账页会在全屏叠加层中打开二维码。
- 客户在手机上打开 WeChat 并扫描二维码。如果客户已经在手机上付款，结账页会显示相关步骤，指导客户截取二维码，然后从 WeChat 相册中扫描该二维码。
- 客户在 WeChat 应用中确认付款。
- 结账页检测到付款完成后，会将客户重定向到您的成功页面。
客户用美元或人民币支付，您按美元结算。
配置
billing_currency: 'CNY'。
API 方法类型
测试
1
Enable test mode
关闭控制面板侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API keys。
2
Create a test checkout
在
allowed_payment_method_types 中使用 we_chat_pay 创建一次性结账会话。3
Scan the QR code
结账页会显示一个测试二维码。使用手机摄像头扫描该二维码；无需使用 WeChat 应用。二维码会打开一个测试页面，您可以在其中授权或使付款失败。
最佳实践
Target Chinese customers
Target Chinese customers
WeChat Pay 主要由中国消费者使用。当您的客户包括中国买家，或您向中国市场销售商品时，请提供 WeChat Pay。
Always include card fallbacks
Always include card fallbacks
并非每位客户都有 WeChat。请将
credit 和 debit 作为备用支付方式。Optimize for mobile
Optimize for mobile
在电脑或平板电脑上打开结账页，并让客户使用手机扫描时，扫描最为方便。在手机上，结账页会指导客户截取二维码，然后从 WeChat 相册中扫描该二维码，因此请确保您的结账页具有响应式布局。
Consider both currencies
Consider both currencies
WeChat Pay 支持 USD 和 CNY。选择适合您客户的计费货币：如果您使用 USD 定价，请选择 USD；如果希望向中国客户显示本地货币价格，请选择 CNY。无论选择哪种货币，结算均使用 USD。
故障排除
WeChat Pay not appearing at checkout
WeChat Pay not appearing at checkout
检查：
we_chat_pay是否包含在allowed_payment_method_types中？- 计费货币是否为 USD 或 CNY？
- 金额是否达到最低金额（$0.50 或 4.00 CNY）？
- 这是否为一次性付款？订阅不提供 WeChat Pay。
QR code not scanning
QR code not scanning
原因： QR code 可能已过期，或者客户使用的 WeChat 版本过旧。QR code 会在有限时间后过期。解决方案： 如果 QR code 已过期，客户需要从您的网站重新开始一次 checkout，或者您可以为其创建新的 checkout session。如果 QR code 仍然有效，请客户将 WeChat 更新到当前版本。
Payment not confirming
Payment not confirming
原因： WeChat Pay 通常会在几秒内确认付款，但也可能出现网络延迟。解决方案： 使用 webhooks 异步确认付款。如果付款在几分钟内仍未确认，客户可能需要重试。
相关页面
Payment Methods Overview
查看所有支持的支付方式。
Checkout Guide
完成结账实现指南。
Webhooks
异步处理付款确认。
Asia-Pacific
GCash（菲律宾）、Alipay HK 和 FPS（香港），以及 Touch ‘n Go（马来西亚）。
Testing Process
所有支付方式的完整测试指南。