微信支付

程序员文章站 2022-06-15 12:40:40

...

微信支付平台

https://pay.weixin.qq.com/index.php/core/home/login?return_url=%2F

微信支付准备资料

微信支付

扫码支付可分为两种模式，商户根据支付场景选择相应模式。

模式一

商户后台系统根据微信支付规则链接生成二维码，链接中带固定参数productid（可定义为产品标识或订单号）。用户扫码后，微信支付系统将productid和用户唯一标识(openid)回调商户后台系统(需要设置支付回调URL)，商户后台系统根据productid生成支付交易，最后微信支付系统发起用户支付流程。

商户支付回调URL设置指引：进入商户平台-->产品中心-->开发配置，进行配置和修改，如图6.6所示。

微信支付

图6.6 扫码支付回调URL设置

设置完成后，详细接入步骤：模式一

【模式二】：商户后台系统调用微信支付【统一下单API】生成预付交易，将接口返回的链接生成二维码，用户扫码后输入密码完成支付交易。注意：该模式的预付单有效期为2小时，过期后无法支付。

模式二

模式二与模式一相比，流程更为简单，不依赖设置的回调支付URL。商户后台系统先调用微信支付的统一下单接口，微信后台系统返回链接参数code_url，商户后台系统将code_url值生成二维码图片，用户使用微信客户端扫码后发起支付。注意：code_url有效期为2小时，过期后扫码不能再发起支付。

业务流程时序图

微信支付

原生支付模式二时序图

业务流程说明：

（1）商户后台系统根据用户选购的商品生成订单。

（2）用户确认支付后调用微信支付【统一下单API】生成预支付交易；

（3）微信支付系统收到请求后生成预支付交易单，并返回交易会话的二维码链接code_url。

（4）商户后台系统根据返回的code_url生成二维码。

（5）用户打开微信“扫一扫”扫描二维码，微信客户端将扫码内容发送到微信支付系统。

（6）微信支付系统收到客户端请求，验证链接有效性后发起用户支付，要求用户授权。

（7）用户在微信客户端输入密码，确认支付后，微信客户端提交授权。

（8）微信支付系统根据用户授权完成支付交易。

（9）微信支付系统完成支付交易后给微信客户端返回交易结果，并将交易结果通过短信、微信消息提示用户。微信客户端展示支付交易结果页面。

（10）微信支付系统通过发送异步消息通知商户后台系统支付结果。商户后台系统需回复接收情况，通知微信后台系统不再发送该单的支付通知。

（11）未收到支付通知的情况，商户后台系统调用【查询订单API】。

（12）商户确认订单已支付后给用户发货。

生成二维码规则

对应链接格式：weixin：//wxpay/bizpayurl?sr=XXXXX。请商户调用第三方库将code_url生成二维码图片。该模式链接较短，生成的二维码打印到结账小票上的识别率较高。

统一下单

应用场景

除被扫支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。

状态机

支付状态转变如下：

微信支付

接口链接

URL地址：https://api.mch.weixin.qq.com/pay/unifiedorder

是否需要证书

否

请求参数

字段名	变量名	必填	类型	示例值	描述
公众账号ID	appid	是	String(32)	wxd678efh567hg6787	微信支付分配的公众账号ID（企业号corpid即为此appId）
商户号	mch_id	是	String(32)	1230000109	微信支付分配的商户号
设备号	device_info	否	String(32)	013467007045764	自定义参数，可以为终端设备号(门店号或收银设备ID)，PC网页或公众号内支付可以传"WEB"
随机字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，长度要求在32位以内。推荐随机数生成算法
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	通过签名算法计算得出的签名值，详见签名生成算法
签名类型	sign_type	否	String(32)	MD5	签名类型，默认为MD5，支持HMAC-SHA256和MD5。
商品描述	body	是	String(128)	腾讯充值中心-QQ会员充值	商品简单描述，该字段请按照规范传递，具体请见参数规定
商品详情	detail	否	String(6000)		商品详细描述，对于使用单品优惠的商户，改字段必须按照规范上传，详见“单品优惠参数说明”
附加数据	attach	否	String(127)	深圳分店	附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用。
商户订单号	out_trade_no	是	String(32)	20150806125346	商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-\|* 且在同一个商户号下唯一。详见商户订单号
标价币种	fee_type	否	String(16)	CNY	符合ISO 4217标准的三位字母代码，默认人民币：CNY，详细列表请参见货币类型
标价金额	total_fee	是	Int	88	订单总金额，单位为分，详见支付金额
终端IP	spbill_create_ip	是	String(16)	123.12.12.123	APP和网页支付提交用户端ip，Native支付填调用微信支付API的机器IP。
交易起始时间	time_start	否	String(14)	20091225091010	订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则
交易结束时间	time_expire	否	String(14)	20091227091010	订单失效时间，格式为yyyyMMddHHmmss，如2009年12月27日9点10分10秒表示为20091227091010。订单失效时间是针对订单号而言的，由于在请求支付的时候有一个必传参数prepay_id只有两小时的有效期，所以在重入时间超过2小时的时候需要重新请求下单接口获取新的prepay_id。其他详见时间规则建议：最短失效时间间隔大于1分钟
订单优惠标记	goods_tag	否	String(32)	WXG	订单优惠标记，使用代金券或立减优惠功能时需要的参数，说明详见代金券或立减优惠
通知地址	notify_url	是	String(256)	http://www.weixin.qq.com/wxpay/pay.php	异步接收微信支付结果通知的回调地址，通知url必须为外网可访问的url，不能携带参数。
交易类型	trade_type	是	String(16)	JSAPI	JSAPI 公众号支付 NATIVE 扫码支付 APP APP支付说明详见参数规定
商品ID	product_id	否	String(32)	12235413214070356458058	trade_type=NATIVE时（即扫码支付），此参数必传。此参数为二维码中包含的商品ID，商户自行定义。
指定支付方式	limit_pay	否	String(32)	no_credit	上传此参数no_credit--可限制用户不能使用信用卡支付
用户标识	openid	否	String(128)	oUpF8uMuAJO_M2pxb1Q9zNjWeS6o	trade_type=JSAPI时（即公众号支付），此参数必传，此参数为微信用户在商户对应appid下的唯一标识。openid如何获取，可参考【获取openid】。企业号请使用【企业号OAuth2.0接口】获取企业号内成员userid，再调用【企业号userid转openid接口】进行转换
+场景信息	scene_info	否	String(256)	{"store_info" : { "id": "SZTX001", "name": "腾大餐厅", "area_code": "440305", "address": "科技园中一路腾讯大厦" }}	该字段用于上报场景信息，目前支持上报实际门店信息。该字段为JSON对象数据，对象格式为{"store_info":{"id": "门店ID","name": "名称","area_code": "编码","address": "地址" }} ，字段详细说明请点击行前的+展开

举例如下：

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <attach>支付测试</attach>
   <body>JSAPI支付测试</body>
   <mch_id>10000100</mch_id>
   <detail><![CDATA[{ "goods_detail":[ { "goods_id":"iphone6s_16G", "wxpay_goods_id":"1001", "goods_name":"iPhone6s 16G", "quantity":1, "price":528800, "goods_category":"123456", "body":"苹果手机" }, { "goods_id":"iphone6s_32G", "wxpay_goods_id":"1002", "goods_name":"iPhone6s 32G", "quantity":1, "price":608800, "goods_category":"123789", "body":"苹果手机" } ] }]]></detail>
   <nonce_str>1add1a30ac87aa2db72f57a2375d8fec</nonce_str>
   <notify_url>http://wxpay.wxutil.com/pub_v2/pay/notify.v2.php</notify_url>
   <openid>oUpF8uMuAJO_M2pxb1Q9zNjWeS6o</openid>
   <out_trade_no>1415659990</out_trade_no>
   <spbill_create_ip>14.23.150.211</spbill_create_ip>
   <total_fee>1</total_fee>
   <trade_type>JSAPI</trade_type>
   <sign>0CB01533B8C1EF103065174F50BCA001</sign>
</xml>

注：参数值用XML转义即可，CDATA标签用于说明数据不被XML解析器解析。

返回结果

字段名	变量名	必填	类型	示例值	描述
返回状态码	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
返回信息	return_msg	是	String(128)	OK	当return_code为FAIL时返回信息为错误原因，例如签名失败参数格式校验错误

字段名

变量名

必填

类型

示例值

描述

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断

返回信息

return_msg

是

String(128)

当return_code为FAIL时返回信息为错误原因，例如

签名失败

参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回

字段名	变量名	必填	类型	示例值	描述
公众账号ID	appid	是	String(32)	wx8888888888888888	调用接口提交的公众账号ID
商户号	mch_id	是	String(32)	1900000109	调用接口提交的商户号
设备号	device_info	否	String(32)	013467007045764	自定义参数，可以为请求支付的终端设备号等
随机字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	微信返回的随机字符串
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	微信返回的签名值，详见签名算法
业务结果	result_code	是	String(16)	SUCCESS	SUCCESS/FAIL
错误代码	err_code	否	String(32)		当result_code为FAIL时返回错误代码，详细参见下文错误列表
错误代码描述	err_code_des	否	String(128)		当result_code为FAIL时返回错误描述，详细参见下文错误列表

以下字段在return_code 和result_code都为SUCCESS的时候有返回

字段名	变量名	必填	类型	示例值	描述
交易类型	trade_type	是	String(16)	JSAPI	JSAPI 公众号支付 NATIVE 扫码支付 APP APP支付说明详见参数规定
预支付交易会话标识	prepay_id	是	String(64)	wx201410272009395522657a690389285100	微信生成的预支付会话标识，用于后续接口调用中使用，该值有效期为2小时
二维码链接	code_url	否	String(64)	URl：weixin：//wxpay/s/An4baqw	trade_type为NATIVE时有返回，用于生成二维码，展示给用户进行扫码支付

字段名

变量名

必填

类型

示例值

描述

交易类型

trade_type

是

String(16)

JSAPI

JSAPI 公众号支付

NATIVE 扫码支付

APP APP支付

说明详见参数规定

预支付交易会话标识

prepay_id

是

String(64)

wx201410272009395522657a690389285100

微信生成的预支付会话标识，用于后续接口调用中使用，该值有效期为2小时

二维码链接

code_url

否

String(64)

URl：weixin：//wxpay/s/An4baqw

trade_type为NATIVE时有返回，用于生成二维码，展示给用户进行扫码支付

举例如下：

错误码

名称	描述	原因	解决方案
NOAUTH	商户无此接口权限	商户未开通此接口权限	请商户前往申请此接口权限
NOTENOUGH	余额不足	用户帐号余额不足	用户帐号余额不足，请用户充值或更换支付卡后再支付
ORDERPAID	商户订单已支付	商户订单已支付，无需重复操作	商户订单已支付，无需更多操作
ORDERCLOSED	订单已关闭	当前订单已关闭，无法支付	当前订单已关闭，请重新下单
SYSTEMERROR	系统错误	系统超时	系统异常，请用相同参数重新调用
APPID_NOT_EXIST	APPID不存在	参数中缺少APPID	请检查APPID是否正确
MCHID_NOT_EXIST	MCHID不存在	参数中缺少MCHID	请检查MCHID是否正确
APPID_MCHID_NOT_MATCH	appid和mch_id不匹配	appid和mch_id不匹配	请确认appid和mch_id是否匹配
LACK_PARAMS	缺少参数	缺少必要的请求参数	请检查参数是否齐全
OUT_TRADE_NO_USED	商户订单号重复	同一笔交易不能多次提交	请核实商户订单号是否重复提交
SIGNERROR	签名错误	参数签名结果不正确	请检查签名参数和方法是否都符合签名算法要求
XML_FORMAT_ERROR	XML格式错误	XML格式错误	请检查XML参数格式是否正确
REQUIRE_POST_METHOD	请使用post方法	未使用post传递参数	请检查请求参数是否通过post方法提交
POST_DATA_EMPTY	post数据为空	post数据不能为空	请检查post数据是否为空
NOT_UTF8	编码格式错误	未使用指定编码格式	请使用UTF-8编码格式

代码如下：

第一步引入微信sdk里面的工具类

微信支付

第二步配置ymi文件要与微信需求到的信息的一模一样，不然会缺失参数

#tomcat配置
server:
  port: 8082

wechatpay:
   notifyUrl: http://域名/WeChat/pay/notify #回调地址
   appId:     #应用id
   mchId:    #商户平台账号
   mchKey:  #商户平台**

第三部搭建微信的配置类，注意要与yml信息一致，不然会导致注入错误

新建config包,新建WeChatPayConfig

@Component
@ConfigurationProperties("wechatpay")
public class WeChatPayConfig {
    /**
     * 回调地址
     */
    private String notifyUrl;
    /**
     * 应用id
     */
    private String appId;

    /**
     * 商户号
     */
    private String mchId;

    /**
     * 商户**
     */
    private String mchKey;


    public String getMchKey() {
        return mchKey;
    }

    public void setMchKey(String mchKey) {
        this.mchKey = mchKey;
    }

    public String getNotifyUrl() {
        return notifyUrl;
    }

    public void setNotifyUrl(String notifyUrl) {
        this.notifyUrl = notifyUrl;
    }

    public String getAppId() {
        return appId;
    }

    public void setAppId(String appId) {
        this.appId = appId;
    }

    public String getMchId() {
        return mchId;
    }

    public void setMchId(String mchId) {
        this.mchId = mchId;
    }
}

第四步Controller实现:，实现微信二维码链接获取和支付结果通知

@RestController
@RequestMapping("/WeChat/pay")
public class WxPayController {

    @Autowired
    WeChatPayConfig weChatPayConfig;

    /**
     * @param orderNo 订单编号 由前端传入
     * @return
     */
    @RequestMapping("/createQRCode")
    public Dto createQRcode(String orderNo) {
        //1.组装请求所需要的参数
        HashMap<String, String> paramsMap = new HashMap<>();
        paramsMap.put("body", "订单支付");
        paramsMap.put("out_trade_no", orderNo); 
        //这里是我测试的，1分钱，代替了订单的价格
        paramsMap.put("total_fee", "1");
        paramsMap.put("spbill_create_ip", "自己的ip");
        paramsMap.put("notify_url", weChatPayConfig.getNotifyUrl());
        //	JSAPI 公众号支付,这里我的选择为NATIVE 扫码支付
        paramsMap.put("trade_type", "NATIVE");
        paramsMap.put("nonce_str", WXPayUtil.generateNonceStr());
        paramsMap.put("appid", weChatPayConfig.getAppId());
        paramsMap.put("mch_id", weChatPayConfig.getMchId());

        //2.将参数转换成xml格式,并且签名
        Map<String, String> respMap = null;
        try {
            String xmlData = WXPayUtil.generateSignedXml(paramsMap, weChatPayConfig.getMchKey());

            //3.请求的url:https://api.mch.weixin.qq.com/pay/unifiedorder xml格式的请求参数
            String respXml = new WXPayRequest().requestOnce("https://api.mch.weixin.qq.com/pay/unifiedorder", xmlData);

            //4.获取响应的结果中的code_url:二维码的链接
            respMap = WXPayUtil.xmlToMap(respXml);

            //5.return_code 和result_code都为SUCCESS的时候有返回
            if (respMap.get("return_code").equals(WXPayConstants.SUCCESS)
                    && respMap.get("result_code").equals(WXPayConstants.SUCCESS)) {
                String code_url = respMap.get("code_url");
                return DtoUtil.returnSuccess("获取二维码链接成功", code_url);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

        return DtoUtil.returnFail("获取二维码链接失败",
                respMap.get("err_code") + ":" + respMap.get("err_code_des"));
    }


    /**
     * 微信异步通知支付结果
     */
    @RequestMapping("/notify")
    public String notify(HttpServletRequest request) {
        //1.利用IO获取微信异步通知XML数据
        HashMap<String, String> returnMap = null;
        try {
            InputStreamReader reader = new InputStreamReader(request.getInputStream(), "UTF-8");
            BufferedReader bufferedReader = new BufferedReader(reader);
            StringBuilder sb = new StringBuilder();
            String line;
            while ((line = bufferedReader.readLine()) != null) {
                sb.append(line);
            }
            reader.close();
            bufferedReader.close();

            //2.将xml数据封转到map中
            Map<String, String> paramsMap = WXPayUtil.xmlToMap(sb.toString());

            //3.验签,保证安全性
            boolean signatureValid = WXPayUtil.isSignatureValid(paramsMap, weChatPayConfig.getMchKey());
            returnMap = new HashMap<>();//定义一个返回参数的map
            if (signatureValid) {//验签成功
                String out_trade_no = paramsMap.get("out_trade_no");
                if (paramsMap.get("return_code").equals("SUCCESS")) {//说明支付成功
                    //进行业务逻辑:在订单未支付的状态下
                    // 修改订单状态为支付成功,修改库存等
                    returnMap.put("return_code", "SUCCESS");
                    returnMap.put("return_msg", "OK");
                } else {
                    returnMap.put("return_code", "FAIL");
                    returnMap.put("return_msg", "支付失败");
                }

            } else {
                returnMap.put("return_code", "FAIL");
                returnMap.put("return_msg", "签名失败");
            }

        } catch (Exception e) {
            returnMap.put("return_code", "FAIL");
            returnMap.put("return_msg", "系统内部错误");
            e.printStackTrace();
        }

        String returnData = null;
        try {
            returnData = WXPayUtil.mapToXml(returnMap);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return returnData;
    }
}

微信支付

微信支付平台

微信支付准备资料

扫码支付可分为两种模式，商户根据支付场景选择相应模式。

模式一

模式二

业务流程时序图

生成二维码规则

统一下单

应用场景

状态机

接口链接

是否需要证书

请求参数

返回结果

错误码

代码如下：

第一步引入微信sdk里面的工具类

第二步配置ymi文件要与微信需求到的信息的一模一样，不然会缺失参数

第三部搭建微信的配置类，注意要与yml信息一致，不然会导致注入错误

第四步Controller实现:，实现微信二维码链接获取和支付结果通知

网页版网易邮箱6.0如何使用易信进行聊天？

如何在网易邮箱中聊易信把邮箱的内容保存到易信中

微信公众号文章怎么另存为pdf文件?

微信小程序常用工具类详解及实例

未来已来新加坡YGB项目打造区块链全球金融产业支付新格局

微信推送功能实现方式图文详解

PS制作微信公众号中按住指纹扫描关注微信号动画效果图

手机微博视频链接如何获取?微博视频链接获取教程

智联招聘怎么改求职信？智联招聘修改求职信教程

利用格式工厂将电脑视频快速转发到手机QQ微信

微信支付

微信支付平台

微信支付准备资料

扫码支付可分为两种模式，商户根据支付场景选择相应模式。

模式一

模式二

业务流程时序图

生成二维码规则

统一下单

应用场景

状态机

接口链接

是否需要证书

请求参数

返回结果

错误码

代码如下：

第一步引入微信sdk里面的工具类

第二步配置ymi文件要与微信需求到的信息的一模一样，不然会缺失参数

第三部搭建微信的配置类，注意要与yml信息一致，不然会导致注入错误

第四步Controller实现:，实现微信二维码链接获取和支付结果通知

网页版网易邮箱6.0如何使用易信进行聊天？

如何在网易邮箱中聊易信把邮箱的内容保存到易信中

微信公众号文章怎么另存为pdf文件?

微信小程序 常用工具类详解及实例

未来已来 新加坡YGB项目打造区块链全球金融产业支付新格局

微信推送功能实现方式图文详解

PS制作微信公众号中按住指纹扫描关注微信号动画效果图

手机微博视频链接如何获取?微博视频链接获取教程

智联招聘怎么改求职信？智联招聘修改求职信教程

利用格式工厂将电脑视频快速转发到手机QQ微信

微信小程序常用工具类详解及实例

未来已来新加坡YGB项目打造区块链全球金融产业支付新格局