189 8069 5689
本篇内容主要讲解“微信支付接入步骤”，感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷，实用性强。下面就让小编来带大家学习“微信支付接入步骤”吧!
成都创新互联-专业网站定制、快速模板网站建设、高性价比故城网站开发、企业建站全套包干低至880元,成熟完善的模板库,直接使用。一站式故城网站制作公司更省心,省钱,快速模板网站建设找我们，业务覆盖故城地区。费用合理售后完善，10多年实体公司更值得信赖。
微信支付接入大概步骤如下：
获取支付接口 URL
构建请求参数
发起请求
唤起支付
支付异步通知处理
步骤一中获取支付接口 URL，需要考虑这几点
如何同时支持国内微信支付与境外微信支付
如何同时支持普通的商户模式以及服务商模式
步骤二中经常遇到的问题就是参数签名验证问题
MD5 加密
HMAC-SHA256 加密
步骤三中难点在于微信支付双向证书的处理
步骤四中预付订单二次签名异常以及唤起支付提示各种配置错误
步骤五中异步通知验证签名、订单重复通知以及敏感数据的解密问题
以上接入步骤中，你踩过那些坑呢？欢迎评论区分享交流
Talk is cheap. Show me the code
有人会说「这不很简单么」官方文档接口中就有提供。对你说的没错，那如何做到一套系统同时支持国内微信支付与境外微信支付，又如何做跨城冗灾方案呢？
根据业务区域的不同微信提供了不同的域名来支持
api.mch.weixin.qq.com（建议接入点：中国国内）
api2.mch.weixin.qq.com（建议接入点：中国国内备用）
apihk.mch.weixin.qq.com（建议接入点：东南亚）
apius.mch.weixin.qq.com（建议接入点：其它）
api.mch.weixin.qq.com/sandboxnew（特殊：仿真测试）
聪明的你，不难就会想到枚举，具体跨城冗灾方案可以参考微信支付商户系统跨城冗灾升级指引
/** *IJPay 让支付触手可及，封装了微信支付、支付宝支付、银联支付常用的支付方式以及各种常用的接口。
* *不依赖任何第三方 mvc 框架，仅仅作为工具使用简单快速完成支付模块的开发，可轻松嵌入到任何系统里。
* *IJPay 交流群: 723992875
* *Node.js 版: https://gitee.com/javen205/TNW
* *微信支付可用域名枚举
* * @author Javen */ public enum WxDomain { /** * 中国国内 */ CHINA("https://api.mch.weixin.qq.com"), /** * 中国国内(备用域名) */ CHINA2("https://api2.mch.weixin.qq.com"), /** * 东南亚 */ HK("https://apihk.mch.weixin.qq.com"), /** * 其它 */ US("https://apius.mch.weixin.qq.com"); /** * 域名 */ private final String domain; WxDomain(String domain) { this.domain = domain; } public String getType() { return domain; } }
至此获取微信支付接口 URL 已解决掉了核心问题。剩下的就是根据不同的支付方式来拼接具体的支付接口 URL。
付款码支付、JSAPI支付、Native支付、App支付、H5支付、小程序支付、红包、企业付款、酒店押金、刷脸支付常用的支付方式以及支付工具不完全统计接口大概有 90+
package com.ijpay.wxpay.enums; /** *IJPay 让支付触手可及，封装了微信支付、支付宝支付、银联支付常用的支付方式以及各种常用的接口。
* *不依赖任何第三方 mvc 框架，仅仅作为工具使用简单快速完成支付模块的开发，可轻松嵌入到任何系统里。
* *IJPay 交流群: 723992875
* *Node.js 版: https://gitee.com/javen205/TNW
* *微信支付接口枚举
* * @author Javen */ public enum WxApiType { /** * 沙箱环境 */ SAND_BOX_NEW("/sandboxnew"), /** * 获取沙箱环境验签秘钥 */ GET_SIGN_KEY("/sandboxnew/pay/getsignkey"), /** * 统一下单 */ UNIFIED_ORDER("/pay/unifiedorder"), /** * 提交付款码支付 */ MICRO_PAY("/pay/micropay"), /** * 查询订单 */ ORDER_QUERY("/pay/orderquery"), /** * 关闭订单 */ CLOSE_ORDER("/pay/closeorder"), /** * 撤销订单 */ REVERSE("/secapi/pay/reverse"), /** * 申请退款 */ REFUND("/secapi/pay/refund"), /** * 查询退款 */ REFUND_QUERY("/pay/refundquery"), /** * 下载对账单 */ DOWNLOAD_BILL("/pay/downloadbill"), /** * 下载资金对账单 */ DOWNLOAD_FUND_FLOW("/pay/downloadfundflow"), /** * 交易保障 */ REPORT("/payitil/report"), /** * 转换短链接 */ SHORT_URL("/tools/shorturl"), /** * 授权码查询 openId */ AUTH_CODE_TO_OPENID("/tools/authcodetoopenid"), /** * 拉取订单评价数据 */ BATCH_QUERY_COMMENT("/billcommentsp/batchquerycomment"), /** * 企业付款 */ TRANSFER("/mmpaymkttransfers/promotion/transfers"), /** * 查询企业付款 */ GET_TRANSFER_INFO("/mmpaymkttransfers/gettransferinfo"), /** * 企业付款到银行卡 */ TRANSFER_BANK("/mmpaysptrans/pay_bank"), /** * 查询企业付款到银行卡 */ GET_TRANSFER_BANK_INFO("/mmpaysptrans/query_bank"), /** * 获取 RSA 加密公钥 */ GET_PUBLIC_KEY("/risk/getpublickey"), /** * 发放红包 */ SEND_RED_PACK("/mmpaymkttransfers/sendredpack"), /** * 发放裂变红包 */ SEND_GROUP_RED_PACK("/mmpaymkttransfers/sendgroupredpack"), /** * 查询红包记录 */ GET_HB_INFO("/mmpaymkttransfers/gethbinfo"), /** * 小程序发红包 */ SEND_MINI_PROGRAM_HB("/mmpaymkttransfers/sendminiprogramhb"), /** * 发放代金券 */ SEND_COUPON("/mmpaymkttransfers/send_coupon"), /** * 查询代金券批次 */ QUERY_COUPON_STOCK("/mmpaymkttransfers/query_coupon_stock"), /** * 查询代金券信息 */ QUERY_COUPONS_INFO("/mmpaymkttransfers/querycouponsinfo"), /** * 请求单次分账 */ PROFIT_SHARING("/secapi/pay/profitsharing"), /** * 请求多次分账 */ MULTI_PROFIT_SHARING("/secapi/pay/multiprofitsharing"), /** * 查询分账结果 */ PROFIT_SHARING_QUERY("/pay/profitsharingquery"), /** * 添加分账接收方 */ PROFITS_HARING_ADD_RECEIVER("/pay/profitsharingaddreceiver"), /** * 删除分账接收方 */ PROFIT_SHARING_REMOVE_RECEIVER("/pay/profitsharingremovereceiver"), /** * 完结分账 */ PROFIT_SHARING_FINISH("/secapi/pay/profitsharingfinish"), /** * 分账回退 */ PROFIT_SHARING_RETURN("/secapi/pay/profitsharingreturn"), /** * 分账回退结果查询 */ PROFIT_SHARING_RETURN_QUERY("/pay/profitsharingreturnquery"), /** * 支付押金（人脸支付） */ DEPOSIT_FACE_PAY("/deposit/facepay"), /** * 支付押金（付款码支付） */ DEPOSIT_MICRO_PAY("/deposit/micropay"), /** * 查询订单（押金） */ DEPOSIT_ORDER_QUERY("/deposit/orderquery"), /** * 撤销订单（押金） */ DEPOSIT_REVERSE("/deposit/reverse"), /** * 消费押金 */ DEPOSIT_CONSUME("/deposit/consume"), /** * 申请退款（押金） */ DEPOSIT_REFUND("/deposit/refund"), /** * 查询退款（押金） */ DEPOSIT_REFUND_QUERY("deposit/refundquery"), /** * 公众号纯签约 */ ENTRUST_WEB("/papay/entrustweb"), /** * 公众号纯签约（服务商模式） */ PARTNER_ENTRUST_WEB("/papay/partner/entrustweb"), /** * APP纯签约 */ PRE_ENTRUST_WEB("/papay/preentrustweb"), /** * APP纯签约（服务商模式） */ PARTNER_PRE_ENTRUST_WEB("/papay/partner/preentrustweb"), /** * H5纯签约 */ H5_ENTRUST_WEB("/papay/h6entrustweb"), /** * H5纯签约（服务商模式） */ PARTNER_H5_ENTRUST_WEB("/papay/partner/h6entrustweb"), /** * 支付中签约 */ PAY_CONTRACT_ORDER("/pay/contractorder"), /** * 查询签约关系 */ QUERY_ENTRUST_CONTRACT("/papay/querycontract"), /** * 查询签约关系（服务商模式） */ PARTNER_QUERY_ENTRUST_CONTRACT("/papay/partner/querycontract"), /** * 代扣申请扣款 */ PAP_PAY_APPLY("/pay/pappayapply"), /** * 代扣申请扣款（服务商模式） */ PARTNER_PAP_PAY_APPLY("/pay/partner/pappayapply"), /** * 查询代扣订单 */ PAP_ORDER_QUERY("/pay/paporderquery"), /** * 查询代扣订单 */ PARTNER_PAP_ORDER_QUERY("/pay/partner/paporderquery"), /** * 代扣申请解约 */ DELETE_ENTRUST_CONTRACT("/papay/deletecontract"), /** * 代扣申请解约（服务商模式） */ PARTNER_DELETE_ENTRUST_CONTRACT("/papay/partner/deletecontract"), /** * 刷脸支付 */ FACE_PAY("/pay/facepay"), /** * 查询刷脸支付订单 */ FACE_PAY_QUERY("/pay/facepayqueryy"), /** * 撤销刷脸支付订单 */ FACE_PAY_REVERSE("/secapi/pay/facepayreverse"), /** * 小微商户申请入驻 */ MICRO_SUBMIT("/applyment/micro/submit"), /** * 查询申请状态 */ GET_MICRO_SUBMIT_STATE("/applyment/micro/getstate"), /** * 提交升级申请 */ MICRO_SUBMIT_UPGRADE("/applyment/micro/submitupgrade"), /** * 查询升级申请单状态 */ GET_MICRO_UPGRADE_STATE("/applyment/micro/getupgradestate"), /** * 查询提现状态 */ QUERY_AUTO_WITH_DRAW_BY_DATE("/fund/queryautowithdrawbydate"), /** * 修改结算银行卡 */ MICRO_MODIFY_ARCHIVES("/applyment/micro/modifyarchives"), /** * 重新发起提现 */ RE_AUTO_WITH_DRAW_BY_DATE("/fund/reautowithdrawbydate"), /** * 修改联系信息 */ MICRO_MODIFY_CONTACT_INFO("/applyment/micro/modifycontactinfo"), /** * 小微商户关注功能配置 */ ADD_RECOMMEND_CONF("/secapi/mkt/addrecommendconf"), /** * 小微商户开发配置新增支付目录 */ ADD_SUB_DEV_CONFIG("/secapi/mch/addsubdevconfig"), /** * 小微商户开发配置查询 */ QUERY_SUB_DEV_CONFIG("/secapi/mch/querysubdevconfig"); /** * 类型 */ private final String type; WxApiType(String type) { this.type = type; } public String getType() { return type; } }
同时支持任意接口任意域名的切换，为跨城冗灾打下良好基础
/**
* 获取接口请求的 URL
*
* @param wxApiType {@link WxApiType} 支付 API 接口枚举
* @return {@link String} 返回完整的接口请求URL
*/
public static String getReqUrl(WxApiType wxApiType) {
return getReqUrl(wxApiType, null, false);
}
/**
* 获取接口请求的 URL
*
* @param wxApiType {@link WxApiType} 支付 API 接口枚举
* @param isSandBox 是否是沙箱环境
* @return {@link String} 返回完整的接口请求URL
*/
public static String getReqUrl(WxApiType wxApiType, boolean isSandBox) {
return getReqUrl(wxApiType, null, isSandBox);
}
/**
* 获取接口请求的 URL
*
* @param wxApiType {@link WxApiType} 支付 API 接口枚举
* @param wxDomain {@link WxDomain} 支付 API 接口域名枚举
* @param isSandBox 是否是沙箱环境
* @return {@link String} 返回完整的接口请求URL
*/
public static String getReqUrl(WxApiType wxApiType, WxDomain wxDomain, boolean isSandBox) {
if (wxDomain == null) {
wxDomain = WxDomain.CHINA;
}
return wxDomain.getType()
.concat(isSandBox ? WxApiType.SAND_BOX_NEW.getType() : "")
.concat(wxApiType.getType());
}这里构建请求参数使用的是 Lombok + Java 反射机制来实现。
BaseModel 实现将 Lombok builder 后对象中的属性以及值转为 Map并提供创建签名的方法自动生成 sign (同时支持 MD5 以及 HMAC-SHA256)。以微信支付中的统一下单为例代码如下
public class BaseModel {
/**
* 将建构的 builder 转为 Map
*
* @return 转化后的 Map
*/
public Map toMap() {
String[] fieldNames = getFiledNames(this);
HashMap map = new HashMap(fieldNames.length);
for (int i = 0; i < fieldNames.length; i++) {
String name = fieldNames[i];
String value = (String) getFieldValueByName(name, this);
if (StrUtil.isNotEmpty(value)) {
map.put(name, value);
}
}
return map;
}
/**
* 构建签名 Map
*
* @param partnerKey API KEY
* @param signType {@link SignType} 签名类型
* @return 构建签名后的 Map
*/
public Map createSign(String partnerKey, SignType signType) {
return createSign(partnerKey,signType,true);
}
/**
* 构建签名 Map
*
* @param partnerKey API KEY
* @param signType {@link SignType} 签名类型
* @param haveSignType 签名是否包含 sign_type 字段
* @return 构建签名后的 Map
*/
public Map createSign(String partnerKey, SignType signType, boolean haveSignType) {
return WxPayKit.buildSign(toMap(), partnerKey, signType,haveSignType);
}
/**
* 获取属性名数组
*
* @param obj 对象
* @return 返回对象属性名数组
*/
public String[] getFiledNames(Object obj) {
Field[] fields = obj.getClass().getDeclaredFields();
String[] fieldNames = new String[fields.length];
for (int i = 0; i < fields.length; i++) {
fieldNames[i] = fields[i].getName();
}
return fieldNames;
}
/**
* 根据属性名获取属性值
*
* @param fieldName 属性名称
* @param obj 对象
* @return 返回对应属性的值
*/
public Object getFieldValueByName(String fieldName, Object obj) {
try {
String firstLetter = fieldName.substring(0, 1).toUpperCase();
String getter = new StringBuffer().append("get")
.append(firstLetter)
.append(fieldName.substring(1))
.toString();
Method method = obj.getClass().getMethod(getter, new Class[]{});
return method.invoke(obj, new Object[]{});
} catch (Exception e) {
return null;
}
}
} UnifiedOrderModel 微信统一下单
/** *IJPay 让支付触手可及，封装了微信支付、支付宝支付、银联支付常用的支付方式以及各种常用的接口。
* *不依赖任何第三方 mvc 框架，仅仅作为工具使用简单快速完成支付模块的开发，可轻松嵌入到任何系统里。
* *IJPay 交流群: 723992875
* *Node.js 版: https://gitee.com/javen205/TNW
* *统一下单 Model
* * @author Javen */ package com.ijpay.wxpay.model; import com.ijpay.core.model.BaseModel; import lombok.AccessLevel; import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Getter; @Builder @AllArgsConstructor(access = AccessLevel.PRIVATE) @Getter public class UnifiedOrderModel extends BaseModel { private String appid; private String mch_id; private String sub_appid; private String sub_mch_id; private String device_info; private String nonce_str; private String sign; private String sign_type; private String body; private String detail; private String attach; private String out_trade_no; private String fee_type; private String total_fee; private String spbill_create_ip; private String time_start; private String time_expire; private String goods_tag; private String notify_url; private String trade_type; private String product_id; private String limit_pay; private String openid; private String sub_openid; private String receipt; private String scene_info; }
UnifiedOrderModel 中是熟悉字段完全来自官方接口文档。遗憾的是 Model 不能遵守小驼峰式命名规则。
MD5 以及 HMAC-SHA256 签名算法实现使用的是 Hutool 提供的工具类来实现
public static String hmacSha256(String data, String key) {
return SecureUtil.hmac(HmacAlgorithm.HmacSHA256, key).digestHex(data, CharsetUtil.UTF_8);
}
public static String md5(String data) {
return SecureUtil.md5(data);
}构建签名逻辑如下