Woo PayGate插件使用文档

Woo PayGate插件可为WooCommerce插件提供微信、支付宝支付接口，实现在线付款功能。

安装激活

插件安装启用后进入后台支付网关激活入口，填写邮箱和激活码激活，具体激活方法参考主题的激活流程：https://www.wpcom.cn/docs/themer/auth.html

微信支付

微信支付需要先申请开通微信支付功能，可前往微信商户平台申请。

插件可支持Native支付、JSAPI支付、H5支付接口，使用前可在微信商户平台产品中心-我的产品申请好这几个接口。其中不同接口的用途如下：

Native支付用于电脑浏览器访问支付，以微信扫码支付的形式；
JSAPI支付接口用于微信内置浏览器访问支付，直接唤起微信支付；
H5支付接口用于手机浏览器（非微信）访问支付，比如手机自带浏览器，会呼起微信客户端进行支付。

 温馨提示

由于微信支付的产品体系全部搭载于微信的社交体系之上，所以商户接入微信支付之前，都需要有一个微信社交载体，该载体可以是已认证的服务号、媒体类订阅号、小程序，如果需要实现微信内置浏览器访问支付的话，那么建议直接使用认证的服务号、媒体类订阅号。

网站设置

Native支付接口回调通知在未设置好固定链接的情况下可能会出现异常，导致订单状态无法更新，所以需要先设置好固定链接：设置-固定链接。

另外Member Pro用户中心插件的支付回调通知基于REST API实现，请确保网站没有禁用REST API功能。

插件设置

进入WooCommerce-设置-付款，启用微信支付，点击管理进入接口设置页面，按选项说明设置：

APPID：开户邮件中可查看，如果找不到，可以进入微信支付商户平台查看（产品中心-AppID账号管理-我关联的AppID账号）;

APPSecret：（Woo PayGate Lite免费版无此选项）公众号开发者密码，用于公众号支付。可在微信公众平台里面获取（设置与开发-开发接口管理-基本配置）；

商户号：MCHID 商户号，开户邮件中可查看，也可以进入微信支付商户平台查看（账户中心>商户信息）；

API 版本：推荐使用 APIv3 版本，安全性更高，历史用户可继续使用APIv2；

APIv2

APIv2密钥：微信支付商户平台-账户中心-API安全-商户APIv2密钥；

商户API证书：证书 (apiclient_cert.pem) / 商户API证书：私钥 (apiclient_key.pem)：进入微信支付商户平台，账户中心-API安全-商户API证书，没有的话可以申请一下，之前已经申请过可以直接使用之前的证书文件，或者重新申请新证书。申请后请留意文件选项名称分别上传apiclient_cert.pem和apiclient_key.pem。

 温馨提示

商户API证书在APIv2版本中仅用于涉及资金回滚的接口，比如退款操作，如果不涉及到直接在网站后台操作退款的需求可不设置。

APIv3

APIv3密钥：微信支付商户平台-账户中心-API安全-APIv3密钥；

商户API证书序列号：微信支付商户平台-账户中心-API安全-商户API证书-管理证书-证书序列号；

微信支付公钥ID：微信支付商户平台-账户中心-API安全-微信支付公钥-管理公钥；

微信支付公钥 (pub_key.pem)：微信支付商户平台-账户中心-API安全-微信支付公钥。

微信平台设置

微信公众号平台设置：https://mp.weixin.qq.com/

进入设置与开发-账号设置-功能设置，配置好业务域名、JS接口安全域名、网页授权域名；

微信开发者平台：https://developers.weixin.qq.com/platform

进入控制台，在我的业务下面找到上面填写的APPID对应账号（比如服务号）进入，在基础信息-开发密钥下面找到API IP白名单设置IP白名单，添加网站服务器IP地址。

微信支付商户平台设置：https://pay.weixin.qq.com/

进入产品中心-开发配置-支付配置：

1、JSAPI支付：添加结账付款页面的目录地址。

Woo PayGate插件默认为：https://网站首页地址/checkout/order-pay/，如果网站有修改过结账页面的链接则以实际结账付款链接地址为准。

Member Pro用户中心插件为：https://网站首页地址/wp-admin/

温馨提示：如果网站没有启用https则以上链接地址需要调整为http协议的地址。

2、H5支付：添加网站域名，区分www，需要和网站地址保持一致；

3、Native支付：Native支付的回调链接填写网站首页地址。

 温馨提示

如果微信支付遇到“URL”未注册错误，则可能是固定链接的问题，需要进入网站后台检查设置-固定链接里面的固定链接规则里面（固定链接结构-自定义结构）最后是否有/，如果有的话，会导致和支付配置里面配置的目录地址不一致，需要去除才可以。

支付宝支付

接口申请

支付宝支付需要先在支付宝商家中心申请好支付接口，目前支持的支付接口有：

电脑网站支付：针对PC端浏览器访问；
手机网站支付：针对手机移动端浏览器访问；
当面付：主要针对个体户，有电脑网站支付和手机网站支付接口权限可以不用申请

支付宝平台设置

接口申请好后可以先进入支付宝开放平台-控制台-网页/移动应用（点击进入），在应用列表里面找到已经添加的应用（如果没有的话可以自己创建），点击应用查看详情，可调用产品里面需要有电脑网站支付和手机网站支付（没有的话参考上一步接口申请部分），如果申请的是当面付接口，则需要有当面付，并且完成签约，如图：