获取微信OAuth2授权链接 ¶

TIP

例如使用微信公众号支付时，调起支付中需要传输用户OpenId信息，虽然我们可以直接在客户系统中直接调用微信接口进行获取，但有些情况下我们不方便让业务系统知道微信公众平台的敏感数据，如AppId、appSecret，所以提供这个中转接口来支持间接的调用微信平台。

接口说明 ¶

参数	说明
请求URL	`/unipay/assist/getWxAuthUrl`
请求方式	`POST`
请求类型	`application/json`

请求参数 ¶

字段名	变量名	必填	类型	长度	示例值	描述
回调地址	url	是	String	200	https://daxpay.demo.bootx.cn/h5/#/result/success	不可以携带参数，因为授权成功进行回调时会加入
state值	state	否	String	128	892e382a7093b81e6a	重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节
用户IP	clientIp	否	String	64	127.0.0.1	支持V4和V6，部分支付方式要求必填，如调用微信支付方式时Long
随机数	nonceStr	否	String	32	d112892e382a7093
签名值	sign	否	String	64	072695d112892e382a7093b81e6a52af
请求时间	reqTime	是	Long		123123121	使用时间戳(秒级)

响应结果 ¶

TIP

生成的授权链接是用于实现静默授权的，scope范围是snsapi_base级别。

请配合查阅微信公众平台相关文档一起使用，文档地址：微信网页授权文档

字段名	变量名	必传	类型	示例值	描述
微信oauth2授权的url	url	是	String	https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx9xxxxxf030e85&redirect_uri=https%3A%2F%2Fdaxpay.demo.bootx.cn%2Fserver%2Fdemo%2Fcashier%2FwxAuthCallback&response_type=code&scope=snsapi_base&state=&connect_redirect=1#wechat_redirect
状态码	code	是	Integer	0
错误信息	msg	否	String	关闭失败	状态非0时会有返回值
响应时间	resTime	是	Long	123123121
签名	sign	是	String	072695d112892e382a7093b81e6a52af	对响应内容进行签名

错误码 ¶

状态码	名称	备注
0	成功	获取成功

HTTP请求示例 ¶

请求参数 ¶

json

{
  "clientIp": "127.0.0.1",
  "sign": "458565a54e959fa206dcda9b44eecaf0d5907e8af40f9457d404e533e092a9ed",
  "reqTime": "123457711",
  "url": "https://daxpay.demo.bootx.cn/h5/#/result/success",
  "state": "1705441100211"
}

响应参数(成功) ¶

json

{
  "msg": "success",
  "code": 0,
  "data": {
    "url": "https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx9xxxxxf030e85&redirect_uri=https%3A%2F%2Fdaxpay.demo.bootx.cn%2Fserver%2Fdemo%2Fcashier%2FwxAuthCallback&response_type=code&scope=snsapi_base&state=&connect_redirect=1#wechat_redirect",
    "sign": "fc35c71844a49f5ca0cd3aebea65395b13e672d607f7d7788ec4c49e6c062849",
    "code": "0",
    "resTime": 1715345598
  },
  "traceId": "sNiSFTXDufTR"
}

响应参数(失败) ¶

json

{
  "msg": "success",
  "code": 0,
  "data": {
    "sign": "2bcc5ac7902379d65dc9901186cd81a2833835a30d5a59b3b1860df82f012557",
    "code": "1",
    "msg": "校验失败",
    "resTime": 1715345296
  },
  "traceId": "7UEqCd1v3fcZ"
}

SDK请求示例 ¶

提示

使用SDK可以简化接入支付的速度

java

package cn.bootx.platform.daxpay.sdk;

import cn.bootx.platform.daxpay.sdk.code.PayChannelEnum;
import cn.bootx.platform.daxpay.sdk.code.PayWayEnum;
import cn.bootx.platform.daxpay.sdk.model.PayOrderModel;
import cn.bootx.platform.daxpay.sdk.net.DaxPayConfig;
import cn.bootx.platform.daxpay.sdk.net.DaxPayKit;
import cn.bootx.platform.daxpay.sdk.param.pay.SimplePayParam;
import cn.bootx.platform.daxpay.sdk.response.DaxPayResult;
import org.junit.Before;
import org.junit.Test;

/**
 * 获取微信AccessToken
 * @author xxm
 * @since 2024/2/2
 */
public class SimplePayOrderTest {

    @Before
    public void init() {
        // 初始化支付配置
        DaxPayConfig config = DaxPayConfig.builder()
                .serviceUrl("http://127.0.0.1:9000")
                .signSecret("123456")
                .build();
        DaxPayKit.initConfig(config);
    }

    @Test
    public void test() {
        // 回调地址为 结算台微信jsapi支付的回调地址
        WxAuthUrlParam wxAuthUrlParam = new WxAuthUrlParam();
        String url = StrUtil.format("{}/demo/cashier/wxAuthCallback", "https://daxpay.demo.bootx.cn/h5/#/result/success");
        wxAuthUrlParam.setUrl(url);
        DaxPayResult<WxAuthUrlModel> execute = DaxPayKit.execute(wxAuthUrlParam);
        if (execute.getCode() != 0){
            throw new BizException(execute.getMsg());
        }
        System.out.println(execute);
    }
}