> For the complete documentation index, see [llms.txt](https://useepay.gitbook.io/developer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://useepay.gitbook.io/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/dian-zi-qian-bao/wechat-hk/office-account.md).

# 微信公众号支付

## 1. 使用场景

商户已有H5商城网站，用户通过消息或扫描二维码在微信内打开网页时，可以调用微信支付完成下单购买的流程。

步骤（1）：如图7.1，商户下发图文消息或者通过自定义菜单吸引用户点击进入商户网页。

步骤（2）：如图7.2，进入商户网页，用户选择购买，完成选购流程。

![图7.3 用户确认支付，输入密码](/files/cVrYZIWmBCxyNNQk0O9B)![图7.4 用户支付成功提示](/files/XBgCgBaWLv7GZOaDAHil)

步骤（3）：如图7.3，调起微信支付控件，用户开始输入支付密码。

步骤（4）：如图7.4，密码验证通过，支付成功。商户后台得到支付成功的通知。

![](/files/zQpdOPrjam5XXfMyOQFw)![](/files/wuFhcjeHQUJ9K49b5z6J)

## 2. 开发步骤

### 2.1. 设置支付授权目录

提供需要调用支付的域名给UseePay进行配置

### 2.2. 设置页面授权域名

开发公众号支付时，在下单接口中要求必传用户openid，而获取openid则需要您在公众平台设置获取openid的域名，只有被设置过的域名才是一个有效的获取openid的域名，否则将获取失败。具体界面如图7.8所示：

<figure><img src="/files/ALyInlgvNR4CBZIHvj5O" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/V9Ezr2MkhCDSyOwQBCwI" alt=""><figcaption></figcaption></figure>

### 2.3. 业务流程时序图

<figure><img src="/files/rpWnDrUQ5cPvn9QmzvaR" alt=""><figcaption></figcaption></figure>

商户与UseePay系统主要交互：

1. 商户Server 调用 [pay 接口请求订单](#wei-xin-gong-zhong-hao-zhi-fu-wechatofficeaccount)
2. 商户Server接受[支付通知](/developer/reference/notify/notifyurl.md)
3. 商户Server[查询支付结果 ](/developer/reference/api-reference-xin-yong-ka/order/order-detail.md)

## 3. Pay接口

请查看[Jsapi支付下单接口](/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/dian-zi-qian-bao/wechat-hk/jsapi.md)

## 4. 如何获取openId

请查看[微信授权](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)

## 5. 微信H5调起支付

> 在微信浏览器里面打开H5网页中执行JS调起支付。接口输入输出数据格式为JSON。
>
> 注意：WeixinJSBridge内置对象在其他浏览器中无效。
>
> **列表中参数名区分大小，大小写错误签名验证会失败。**&#x20;
>
> getBrandWCPayRequest参数以及返回值定义如下：

网页内支付接口err\_msg返回结果值说明：

```javascript
 WeixinJSBridge.invoke(
       'getBrandWCPayRequest',{
             "appId":"wx2421b1c4370ec43b",//公众号名称，由商户传入
             "timeStamp":"1395712654", //时间戳，自1970年以来的秒数
             "nonceStr":"e61463f8efa94090b1f366cccfbbb444",//随机串
             "package":"prepay_id=u802345jgfjsdfgsdg888",
             "signType":"RSA", //微信签名方式：
             "paySign":"70EA570631E4BB79628FBCA90534C63FF7FADD89"//微信签名
         },
        function(res){
            if(res.err_msg === "get_brand_wcpay_request:ok" ) {
                // 使用以上方式判断前端返回,微信团队郑重提示：res.err_msg将在用户支付成功后返回    ok，但并不保证它绝对可靠。
                alert("支付成功");
            }
        }
    )

```

| 返回值                               | 描述        |
| --------------------------------- | --------- |
| get\_brand\_wcpay\_request:ok     | 支付成功      |
| get\_brand\_wcpay\_request:cancel | 支付过程中用户取消 |
| get\_brand\_wcpay\_request:fail   | 支付失败      |

JS API的返回结果get\_brand\_wcpay\_request:ok仅在用户成功完成支付时返回。由于前端交互复杂，get\_brand\_wcpay\_request:cancel或者get\_brand\_wcpay\_request:fail可以统一处理为用户遇到错误或者主动放弃，不必细化区分