微信公众号开发

微信小程序支付

本文主要是介绍微信小程序支付,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

当下,微信小程序十分火爆,现在无论是购物还是生活服务,都是推荐你使用微信小程序,主要是它无需下载安装就可以使用,让手机变得非常清爽,给用户也带来很大的方便之处。

今天给大家分享的是,微信小程序 API v3 支付。

目录

1、效果演示
2、微信小程序支付官方文档
3、生成密钥、生成证书
4、如何生成签名
5、微信小程序下单接口
6、微信小程序商户订单查询接口

一、效果演示

步骤1:用户选择好商品,提交订单,服务端下预订单

下单

步骤2:小程序端拉起支付控件,并完成支付

支付

步骤3:查询支付结果

支付查询

步骤4:完成支付,显示支付结果

支付结果

二、微信小程序支付官方文档

  • 2.1 API v3 密钥
  • 2.2 如何生成请求签名
  • 2.3 小程序下单接口
  • 2.4 商户订单号查询订单接口

三、生成密码,生成证书

看 【2.1】文档,生成 API v3 密钥 和 API 证书。

注意:

1、生成证书,需要配合客户端软件(WXCertUtil)生成。
2、附件中的三份文件(证书pkcs12格式、证书pem格式、证书密钥pem格式)。建议读一读 证书使用说明.txt

四、生成签名

这一步是相当复杂,我们一定要把【2.2】文档多读几遍。

先说结论,这一步主要是构建下面这样一个东西:

Authorization: 认证类型 签名信息

认证类型是 WECHATPAY2-SHA256-RSA2048

签名信息:

  • 发起请求的商户(包括直连商户、服务商或渠道商)的商户号mchid
  • 商户API证书序列号serial_no,用于声明所使用的证书
  • 请求随机串nonce_str
  • 时间戳timestamp
  • 签名值signature

商户号 mchid,这个拿到了。
商户API证书序列号serial_no,这个有两种方式,一是从证书(p12)文件中获取,二是在后台查看:【API安全 > 申请API证书 > 点击“管理证书” > “证书序列号”】

下面就来重点说一下这个签名了。

格式:

HTTP请求方法\n
URL\n
请求时间戳\n
请求随机串\n
请求报文主体\n

HTTP请求方法,每个接口都不一样,比如下单接口是POST,查询接口是GET。

URL,这是是除去域名,后面的全部。官方文档是这样说的:

第二步,获取请求的绝对URL,并去除域名部分得到参与签名的URL。如果请求中有查询参数,URL末尾应附加有’?'和对应的查询字符串。

请求时间戳,这个是秒数。

接口报文体,官网也说的比较详细,

第五步,获取请求中的请求报文主体(request body)。

请求方法为GET时,报文主体为空。
当请求方法为POST或PUT时,请使用真实发送的JSON报文。
图片上传API,请使用meta对应的JSON报文。
对于下载证书的接口来说,请求报文主体是一个空串。

综合起来,就是这样的,举个例子:

GET\n 
/v3/certificates\n 
1554208460\n 
593BEC0C930BF1AFEB40B4A08C8FB242\n 
\n

下一个难点来了,计算签名。

签名方式:使用商户私钥对待签名串进行SHA256 with RSA签名,并对签名结果进行Base64编码得到签名值。

简单来说,
1:就是先要读到商户私钥,
2:然后使用私钥进行SHA256 with RSA签名,
3:Base64编码

到这里,就算得到 Authorization 的值了。

五、微信小程序下单接口

下面我们就以小程序下单接口来做说明。

首先,构造下单的参数

WechatAppletPayRequest request = new WechatAppletPayRequest();
request.setAppId(merchantConfigBo.getAppId());
request.setMchId(merchantConfigBo.getMchId());
request.setDescription("演示订单");
request.setOutTradeNo(orderId);
request.setNotifyUrl("https://examine.com/pay/notify");
request.setAmount(amount);
request.setPayer(payer);

这里需要说明的,过期时间(time_expire)格式为:yyyy-MM-DDTHH:mm:ss+TIMEZONE

应该如何赋值呢?

LocalDateTime timeExpire = LocalDateTime.now().plusMinutes(30);
OffsetDateTime offsetDateTime = OffsetDateTime.of(timeExpire, ZoneOffset.of("+8"));
String timeExpireStr = offsetDateTime.format(DateTimeFormatter.ofPattern("uuuu-MM-dd'T'HH:mm:ssXXX"));
request.setTimeExpire(timeExpireStr);

我们对请求参数进行 json 格式转换:

String param = JsonUtils.convertString(request);

获取证书:

public KeyPair createPKCS12(String keyPath, String keyAlias, String keyPass) {
    try {
        char[] pem = keyPass.toCharArray();
        InputStream inputStream = new FileInputStream(keyPath);
        synchronized (lock) {
            if (store == null) {
                synchronized (lock) {
                    store = KeyStore.getInstance("PKCS12");
                    store.load(inputStream, pem);
                }
            }
        }
        X509Certificate certificate = (X509Certificate) store.getCertificate(keyAlias);
        certificate.checkValidity();
        // 证书的序列号 也有用
        String serialNumber = certificate.getSerialNumber().toString(16).toUpperCase();
        // 证书的 公钥
        PublicKey publicKey = certificate.getPublicKey();
        // 证书的私钥
        PrivateKey storeKey = (PrivateKey) store.getKey(keyAlias, pem);

        return new KeyPair(publicKey, storeKey);

    } catch (Exception e) {
        throw new IllegalStateException("Cannot load keys from store: " + keyPath, e);
    }
}

获取到证书,就可以用私钥进行签名

public static String sign(String url, 
                          String method, 
                          long timestamp, 
                          String nonceStr, 
                          String body, 
                          KeyPair keyPair)  {
    try {
        String canonicalUrl = getCanonicalUrl(url);
        String signatureStr = Stream.of(method, canonicalUrl, String.valueOf(timestamp), nonceStr, body)
                .collect(Collectors.joining("\n", "", "\n"));
        Signature sign = Signature.getInstance("SHA256withRSA");
        sign.initSign(keyPair.getPrivate());
        sign.update(signatureStr.getBytes(StandardCharsets.UTF_8));
        return Base64.getEncoder().encodeToString(sign.sign());
    } catch (Exception e) {
        throw new RuntimeException(e);
    }
}

然后进行拼接:

private String getToken(String mchId, String nonceStr, long timestamp, String serialNo, String signature) {
    final String TOKEN_PATTERN = "mchid=\"%s\",nonce_str=\"%s\",timestamp=\"%d\",serial_no=\"%s\",signature=\"%s\"";
    // 生成token
    return String.format(TOKEN_PATTERN,
            mchId,
            nonceStr, timestamp, serialNo, signature);
}

最后就是用http工具发起请求:

private String httpPost(String url, String token, String param) {
    Map<String, String> headerMap = new HashMap<>();
    headerMap.put("Accept", "application/json");
    headerMap.put("Content-Type", "application/json");
    headerMap.put("Authorization", "WECHATPAY2-SHA256-RSA2048 " + token);

    Request request = new Request();
    request.setUrl(url);
    request.setParam(param);
    request.setMethod(Request.Method.POST);
    request.setUtil(Request.Util.OkHttp);
    request.setParamFormat(Request.ParamFormat.JSON);

    Request.Option option = new Request.Option();
    option.setHeaders(headerMap);

    try {
        return HttpUtils.execute(request, option);
    } catch (IOException e) {
        throw new RuntimeException(e);
    }
}

以上就是post方式请求微信 API v3 接口

六、微信小程序商户订单查询接口

支付查询是GET方式,如果你没有仔细看第【四】点,可能会遇到一些问题

我们先构造url:

String payQueryUrl = "https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/%s";
String url = String.format(payQueryUrl, dto.getOutTradeNo());
url += "?mchid=" + merchantConfigBo.getMchId();

签名时,获取url需要注意,参数也需要带上

public static String getCanonicalUrl(String url) {
    try {
        URL u = new URL(url);
        String query = u.getQuery();
        String result = u.getPath();
        if (StringUtils.hasText(query)) {
            result = result + "?" + query;
        }
        return result;
    } catch (Exception e) {
        throw new RuntimeException(e);
    }
}

请求方法为GET时,报文主体为空。

private String httpGet(String url, String token) {
    Map<String, String> headerMap = new HashMap<>();
    headerMap.put("Accept", "application/json");
    headerMap.put("Content-Type", "application/json");
    headerMap.put("Authorization", "WECHATPAY2-SHA256-RSA2048 " + token);

    Request request = new Request();
    request.setUrl(url);
    request.setMethod(Request.Method.GET);
    request.setUtil(Request.Util.OkHttp);

    Request.Option option = new Request.Option();
    option.setHeaders(headerMap);

    try {
        return HttpUtils.execute(request, option);
    } catch (IOException e) {
        throw new RuntimeException(e);
    }
}

小程序调起支付

最后,补充一下,在小程序端如何拉起支付:

文档:

  • 小程序调起支付签名
  • 小程序支付

小程序调起支付,需要 appId,也需要签名。

AppId 这种一般都会配到后台,所以,建议签名放到后台,如下:

public static String paySign(String appid, String packageStr, long timestamp, String nonceStr, KeyPair keyPair) {
    try {
        String message = appid + "\n"
                + timestamp + "\n"
                + nonceStr + "\n"
                + packageStr + "\n";
        //签名方式
        Signature sign = Signature.getInstance("SHA256withRSA");
        sign.initSign(keyPair.getPrivate());
        sign.update(message.getBytes(StandardCharsets.UTF_8));
        return Base64.getEncoder().encodeToString(sign.sign());
    } catch (Exception e) {
        throw new RuntimeException(e);
    }
}

只需要将签名号的参数返回给小程序就好了。

wx.requestPayment({
    timeStamp: payVo.timeStamp,
    nonceStr: payVo.nonceStr,
    package: payVo.packageStr,
    signType: 'RSA',
    paySign: payVo.paySign,
    success (res: any) { 
        wx.navigateTo({
            url: `/pages/cashier/index?id=${id}`
        })
    },
    fail (res) {
        console.error(res);
    }
})
这篇关于微信小程序支付的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!