随着微信小程序的倒退,越来越多的挪动端利用抉择了微信产品做为媒介。无论是公众号开发还是小程序开发,微信领取永远都是绕不开的话题。因为微信领取波及了很多场景,本文咱们只学习如何在公众号、小程序中接入微信领取。
一、微信领取的前提条件
1.1 公众号
微信公众号大体上能够分为服务号和订阅号,订阅号和服务号的具体区别在以前写过的一篇文章 Spring Boot 开发微信公众号中具体介绍了,这里就不再赘述,总的来说就是服务号提供了更高级的性能。
微信领取接入须要 曾经实现微信认证的服务号 。如果是小程序的话,也须要实现 微信认证。
公众号能够关联同一主体的 10 个小程序,不同主体的 3 个小程序,如果是和公众号同一主体的小程序并且公众号曾经实现认证,则间接能够在公众号后盾的 小程序管理
中,进行疾速注册并认证,这样就无需反复领取微信认证所需的300
RMB 了。
1.2 微信商户平台
微信认证实现后,在公众号后盾的 微信领取
中开明微信领取性能。提交微信领取申请后,3- 5 个工作日内,会进行审核,审核通过后会往你填写的邮箱里发送一份蕴含商户号信息的邮件,同时会往你填写的对公账户中打几毛钱的汇款,须要你查看具体金额后在商户平台中验证。
商户分为一般商户和服务商商户,千万不要申请错了。
一般商户是能够进行交易,然而不能拓展商户。
服务商能够拓展商户,然而不能交易。
服务商就是提供对立的领取入口,它须要绑定具体的一般商户,微信领取时会在领取接口中携带一般商户参数,领取胜利后金额会间接到具体的一般商户账户上。
申请时间接申请 一般商户 就能够了。
1.3 绑定商户
微信领取发动依赖于公众号、小程序等利用与商户号的绑定关系。因而在进行开发前,须要将商户与具体利用进行绑定。
如果商户和须要绑定的 AppID 是同一主体,只须要以下步骤即可实现绑定。
- 在商户平台 - 产品核心 -AppID 账户治理中关联 AppID,输出 AppId 申请绑定
- 在公众号或小程序后盾微信领取 - 商户号治理中进行确认。
如果商户和须要绑定的 AppID 是不同主体,步骤和上述一样,除了输出 AppId 之外,还须要填入 AppId 的认证信息。
二、微信领取相干配置
2.1 领取产品类型
1. 付款码领取
用户关上微信钱包 - 付款码的界面,商户扫码后提交实现领取。
2. JSAPI 领取
用户通过微信扫码,关注公众号等形式进入商家 H5 页面,并在微信内调用 JSSDK 实现领取。
3. Native 领取
用户关上微信扫一扫,扫描商户的二维码后实现领取。
4. APP 领取
商户 APP 中集成微信 SDK,用户点击后跳转到微信内实现领取。
5. H5 领取
用户在微信以外的手机浏览器申请微信领取的场景唤起微信领取。
6. 小程序领取
用户在微信小程序中应用微信领取的场景。
7. 刷脸领取
无需掏出手机,刷脸实现领取,适宜线下各种场景。
在商户平台 - 产品核心 - 我的产品中申请开明领取产品。
2.2 领取受权目录配置
在商户平台 - 产品核心 - 开发配置中进行领取受权目录的配置(即你开发的下单接口地址),须要留神的是受权目录最多能够配置 五个,在开发过程中请正当定义领取接口。
2.3 配置商户密钥
在商户平台 - 账户核心 -API 平安中设置 API 密钥。
第一次设置时,须要安装操作证书,傻瓜式装置,依照提醒一步一步操作就能够。
API 密钥须要时一个 32 位 的随机字符串,记得 不要随便更改 API 密钥。
在微信 API v3 版本中,除了要配置 API 密钥外,还须要配置 APIv3 密钥和申请 CA 颁发的 API 证书。
- API v3 密钥次要用于平台证书解密、回调信息解密。
- API 证书用于调用更高级别的 api 接口,蕴含退款、红包等接口。
如果应用开源的微信开发包,请理解是否反对 v3 版本。
2.4 配置服务器
在公众号后盾 - 开发 - 根本配置 - 服务器配置中启用并填写服务器信息。
2.5 白名单配置
在公众号后盾 - 开发 - 根本配置 - 公众号开发信息中配置开发者密钥,同时填写 IP 白名单。
2.6 JS 接口平安域名
在公众号后盾 - 公众号设置 - 性能设置中设置 JS 接口平安域名。
下面的配置是基于公众号领取配置的,小程序领取没有这么麻烦,小程序领取不必配置领取受权目录和受权域名。
JSAPI | 小程序 | |
---|---|---|
领取协定 | HTTP/HTTPS | HTTPS |
领取目录 | 有 | 无 |
受权域名 | 有 | 无 |
三、微信领取流程
因为微信降级了 API 接口,在 API v3 接口中,须要加载申请的 API 证书,微信曾经封装了相干 jar 包,并且提供了加载示例,具体可参考“https://pay.weixin.qq.com/wik… v2 为例具体学习一下微信接入的次要流程(因为 API v3 的一些接口还在继续降级,v2 接口绝对残缺)。
下面的这张图片来自微信开发文档,咱们详细分析一下领取流程。
3.1 微信下单接口
用户通过微信客户端发动领取,在商戶后盾生成订单,而后调用微信下单接口,生成预领取订单,返回订单号!
下单接口波及到的主要参数,只列举重要的几个参数:
申请参数 | 是否必传 | 类型 | 形容 |
---|---|---|---|
appid | 是 | String | 公众号 appid |
mch_id | 是 | String | 商户号 |
nonce_str | 是 | String | 随机字符串,32 位以内 |
sign | 是 | String | 签名,默认应用 MD5 进行加密 |
out_trade_no | 是 | String | 零碎外部订单号 |
total_fee | 是 | Int | 订单总金额,单位是分 |
notify_url | 是 | String | 领取后果告诉接口 |
sign
的签名也比拟通用,波及了一个保障签名不可预测的nonce_str
- 将所有发送的非空参数应用字典排序生成键值对(key1=value1&key2=value2);
- 将商户平台密钥拼接在上述字符串的最初(”String”+&key= 密钥);
- 将上述字符串采纳 MD5 加密
3.2 领取
拉起微信领取,输出明码,实现领取。这一步须要在 H5 网页中执行 JS 调起领取。
须要以下参数,因而在预付订单返回和,须要将下列参数封装后响应给页面,由页面实现领取。
参数名 | 是否必传 | 类型 | 形容 |
---|---|---|---|
appId | 是 | String | 公众号 id |
timeStamp | 是 | String | 以后工夫戳 |
nonceStr | 是 | String | 随机字符串 |
package | 是 | String | 预领取订单,格局为 prepay_id=* |
signType | 是 | String | 签名类型,默认 MD5 |
paySign | 是 | String | 签名 |
签名和下单接口的签名形式一样。
JS 伪代码如下:
function onBridgeReady(){
WeixinJSBridge.invoke(
'getBrandWCPayRequest', {
// 公众号 ID,由商户传入
"appId":"wx2421b1c4370ec43b",
// 工夫戳,自 1970 年以来的秒数
"timeStamp":"1395712654",
// 随机串
"nonceStr":"e61463f8efa94090b1f366cccfbbb444",
"package":"prepay_id=u802345jgfjsdfgsdg888",
// 微信签名形式
"signType":"MD5",
// 微信签名
"paySign":"70EA570631E4BB79628FBCA90534C63FF7FADD89"
},
function(res){if(res.err_msg == "get_brand_wcpay_request:ok"){
// 应用以上形式判断前端返回, 微信团队郑重提醒:// res.err_msg 将在用户领取胜利后返回 ok,但并不保障它相对牢靠。}
});
}
if (typeof WeixinJSBridge == "undefined"){if( document.addEventListener){document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false);
}else if (document.attachEvent){document.attachEvent('WeixinJSBridgeReady', onBridgeReady);
document.attachEvent('onWeixinJSBridgeReady', onBridgeReady);
}
}else{onBridgeReady();
}
留神伪代码中的这句话 // res.err_msg 将在用户领取胜利后返回 ok,但并不保障它相对牢靠。
为什么这么说呢,我举个例子应该就明确了。如果你去超市买货色,是不是你说领取胜利了你就能够把货色带走呢?必定不是,是当商家收到钱后才算你领取胜利,你才能够把货色带走。也就是说,这里提醒的胜利并不能说肯定领取胜利了,具体是否胜利,微信平台会以异步的形式给你进行告诉。
3.3 异步告诉
异步告诉是比拟重要的一步,在这里你能够依据告诉后果解决你的业务逻辑。然而,可能会因为网络稳定等起因告诉不到,或者说微信接管到的响应不合乎 API 的规定,微信会继续发动屡次告诉(请在回调告诉接口中正当解决,防止反复告诉造成业务反复解决),直到胜利为止,告诉频率为15s
/15s
/30s
/3m
/10m
/20m
/30m
/30m
/30m
/60m
/3h
/3h
/3h
/6h
/6h
– 总计 24h4m
)。然而微信不保障告诉最终肯定会胜利。
异步告诉 响应参数 如下:
参数名 | 是否必传 | 类型 | 形容 |
---|---|---|---|
return_code | 是 | String | 返回状态码,SUCCESS /FAIL |
return_msg | 否 | String | 返回信息 |
如果微信始终告诉不胜利怎么?还是方才那个例子,你明明领取胜利了,然而商家却始终说她没收到钱,这时候你怎么办?必定是去看一下她的手机是否真的没有收到钱!这里也一样。
3.4 领取状态查问
- 商户 APP 或者前端页面收到领取返回时,商户须要调用商户查单接口确认订单状态,并把查问后果展现给用户。
- 商户后盾须要精确、高效地解决微信领取发送的异步领取后果告诉,并按接口标准把处理结果返回给微信领取。
- 商户后盾未收到异步领取后果告诉时,商户应该被动调用
微信领取查单接口
,同步订单状态。 - 商户在 T + 1 日从微信领取侧获取 T 日的交易账单,并与商户零碎中的订单核查。如呈现订单在微信领取侧胜利,然而在商户侧未胜利的状况,商户须要给用户补发货或者退款解决。
四、总结
本文次要以公众号领取为例,总结了接入微信领取须要的相干配置和领取流程。其余领取像 APP 领取也是开发中比拟常见的利用场景,APP 领取须要在 微信开放平台
去创立利用来接入微信领取。除此之外,微信领取 API 在向 v3 平滑降级,有些接口也还没有降级实现,降级完的接口相较于 v2 产生了一些数据格式方面的变动。如果援用第三方开发包进行开发,须要留神接口对应的版本。
参考
微信领取开发文档
点关注、不迷路
如果感觉文章不错,欢送关注、点赞、珍藏,你们的反对是我创作的能源,感激大家。
如果文章写的有问题,请不要吝惜文笔,欢送留言指出,我会及时核查批改。
如果你还想看到更多别的货色,能够微信搜寻「Java 旅途」进行关注。回复“手册”支付 Java 面试手册!