乐趣区

关于微信支付:手把手教你接入微信支付

随着微信小程序的倒退,越来越多的挪动端利用抉择了微信产品做为媒介。无论是公众号开发还是小程序开发,微信领取永远都是绕不开的话题。因为微信领取波及了很多场景,本文咱们只学习如何在公众号、小程序中接入微信领取。

一、微信领取的前提条件

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 领取状态查问

  1. 商户 APP 或者前端页面收到领取返回时,商户须要调用商户查单接口确认订单状态,并把查问后果展现给用户。
  2. 商户后盾须要精确、高效地解决微信领取发送的异步领取后果告诉,并按接口标准把处理结果返回给微信领取。
  3. 商户后盾未收到异步领取后果告诉时,商户应该被动调用 微信领取查单接口,同步订单状态。
  4. 商户在 T + 1 日从微信领取侧获取 T 日的交易账单,并与商户零碎中的订单核查。如呈现订单在微信领取侧胜利,然而在商户侧未胜利的状况,商户须要给用户补发货或者退款解决。

四、总结

本文次要以公众号领取为例,总结了接入微信领取须要的相干配置和领取流程。其余领取像 APP 领取也是开发中比拟常见的利用场景,APP 领取须要在 微信开放平台 去创立利用来接入微信领取。除此之外,微信领取 API 在向 v3 平滑降级,有些接口也还没有降级实现,降级完的接口相较于 v2 产生了一些数据格式方面的变动。如果援用第三方开发包进行开发,须要留神接口对应的版本。

参考

微信领取开发文档

点关注、不迷路

如果感觉文章不错,欢送关注、点赞、珍藏,你们的反对是我创作的能源,感激大家。

如果文章写的有问题,请不要吝惜文笔,欢送留言指出,我会及时核查批改。

如果你还想看到更多别的货色,能够微信搜寻「Java 旅途」进行关注。回复“手册”支付 Java 面试手册!

退出移动版