WeChat Pay
Gain access to shoppers on WeChat Pay
Introduction
WeChat 是中国主要移动支付平台，集成于微信应用。支持转账、商户支付、公共服务缴费和在线购物，主要通过二维码或付款码交易。用户可绑定银行卡或使用钱包余额。提供小程序功能，便于商家开展业务。采用多重身份验证和加密技术确保安全。在中国广泛使用，并向海外拓展，支持多币种结算。微信支付因其社交属性、便捷性和广泛的生态系统，成为中国消费者日常生活中不可或缺的支付工具。
Basic information
Properties
| properties | WeChat Pay | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 支付类别 | APM | ||||||||
| 支付类型 | E-Wallet | ||||||||
| 支持的地区 | CN,HK | ||||||||
| 支付方式 | ["WeChat Pay"] | ||||||||
| 支持的交易币种 | 新加坡商户主体:["SGD"] 香港商户主体:["HKD","CNY"] | ||||||||
| 结算周期 | 结算周期 | ||||||||
| 支付限额 | |||||||||
| 退款 |
| ||||||||
| Tokenization |
| ||||||||
| 3DS | |||||||||
| 请款 | |||||||||
| 周期支付（MIT） | |||||||||
| 拒付/争议 | |||||||||
| 集成能力 | |||||||||
| remark | 微信退款 不能小于0.01CNY（包括换汇情况） |
Properties
支付域名授权
根据微信要求，需要将商户的域名加入微信的 H5 支付授权域名中。并且需设置 Referer 请求头。 我们默认将您的申请开户申报的域名加入微信的 H5 支付授权域名中。
如果您需要添加其他域名， 请您将相关申请信息发送到acquire-risk@pingpongx.com并抄送acquire-ts@pingpongx.com。
申请材料：
- 商户Client ID
- 商户授权域名
支付场景说明
PC端支付
- 显示微信支付二维码
- 用户使用微信扫码完成支付
- 页面实时显示支付状态更新
移动端支付
- 微信内浏览器：暂不支持直接调起微信支付，根据微信要求需要JSAPI调用。
- 微信外浏览器：
- iOS：跳转到微信客户端
- Android：显示二维码或尝试调起微信
- 其他情况：显示二维码供扫码支付
提示
- 您的域名必须加入微信 H5 支付授权域名。
- 微信对Referer 的要求严格，请务必设置 Referer 请求头。
- 确保用户通过页面跳转进入支付页面，而非直接访问支付链接
常见问题
错误提示："商家参数格式有误，请联系商家解决"
问题原因：
- Referer 请求头为空或缺失
- 用户直接访问支付链接，未通过页面跳转
解决方案：
- 确保用户通过页面跳转进入支付页面，而非直接访问支付链接
- App 内 WebView 需手动设置 Referer 请求头：
Map<String, String> extraHeaders = new HashMap<>(); extraHeaders.put("Referer", "https://你的授权域名");
错误提示："商家存在未配置的参数，请联系商家解决"
问题原因：
- 当前网页域名与微信后台配置的 H5 支付授权域名不一致
解决方案：
- 联系我们确认授权域名是否正确
- 修改或添加正确的授权域名
错误提示："支付请求已失效，请重新发起支付"
问题原因：
- 支付链接超过 5 分钟有效期
解决方案：
- 重新调用支付接口生成新的支付链接
错误提示："请在微信外打开订单，进行支付"
问题原因：
- 在微信客户端内使用了 H5 支付方式
解决方案：
- 微信内环境应使用 JSAPI 支付
- 引导用户在外部浏览器中打开支付页面
错误提示："签名验证失败"或"系统繁忙"
问题原因：
- 多个微信账号访问同一支付链接
- 回调 URL 编码不正确
解决方案：
- 为每个用户生成独立的支付链接
- 确保回调 URL 参数正确编码
错误提示："由于商家传入的H5交易参数有误"
问题原因：
- 客户端 IP 地址错误（如使用 127.0.0.1）
解决方案：
- 使用真实的客户端 IP 地址
Referer 相关配置说明
微信 H5 支付对 Referer（HTTP 请求头中的来源域名）有严格要求：
Referer 作用： 微信服务器通过 Referer 头部判断当前网页的来源域名，是否与微信商户平台中配置的 H5 支付授权域名一致。
常见 Referer 问题解决方案：
| 问题类型 | 具体表现 | 解决方案 |
|---|---|---|
| Referer 为空 | 直接访问支付链接或 WebView 未设置 Referer | 确保通过页面跳转访问；WebView 手动设置 Referer |
| 域名不匹配 | 当前域名与授权域名不一致 | 在微信商户平台添加或修改授权域名 |
| WebView 配置 | App 内 H5 无法调起支付 | 手动添加 Referer Header |