随着微信小程序的倒退，越来越多的挪动端利用抉择了微信产品做为媒介。无论是公众号开发还是小程序开发，微信领取永远都是绕不开的话题。因为微信领取波及了很多场景，本文咱们只学习如何在公众号、小程序中接入微信领取。
一、微信领取的前提条件
1.1 公众号
微信公众号大体上能够分为服务号和订阅号，订阅号和服务号的具体区别在以前写过的一篇文章Spring Boot开发微信公众号中具体介绍了，这里就不再赘述，总的来说就是服务号提供了更高级的性能。
微信领取接入须要曾经实现微信认证的服务号。如果是小程序的话，也须要实现微信认证。
公众号能够关联同一主体的10个小程序，不同主体的3个小程序，如果是和公众号同一主体的小程序并且公众号曾经实现认证，则间接能够在公众号后盾的小程序管理中，进行疾速注册并认证，这样就无需反复领取微信认证所需的300RMB了。
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面试手册！