微信支付接口参数讲解
JSAPI支付
一、通过微信统一下单接口下单预支付
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1
二、JSAPI调起支付接口
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6
统一下单接口
必填参数
Map<String, Object> map = new HashMap<>();
map.put("appid", appid);
map.put("mch_id", mchId);
map.put("nonce_str", UUID.randomUUID().toString().replaceAll("-", ""));
map.put("body", requestParam.getBody());
map.put("out_trade_no", requestParam.getOutTradeNo());
map.put("fee_type", requestParam.getFeeType());
map.put("total_fee", requestParam.getTotalFee());
map.put("spbill_create_ip", Inet4Address.getLocalHost().getHostAddress());
map.put("notify_url", redirectUrl);
map.put("trade_type", requestParam.getTradeType());
//签名放到最后，前面的参数都已经存储进来
map.put("sign", SignUtil.md5Sign(map));
//sign_type不参与签名
map.put("sign_type", "MD5");
String xmlBody = Map2XmlUtil.map2Xml(map);
| 参数 | 描述 | 获取值 |
|---|---|---|
| spbill_create_ip | 系统服务器ip地址 | Inet4Address.getLocalHost().getHostAddress() |
| sign | 签名 | https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3 |
JSAPI调起支付接口
必填参数设置
①在Java中将各个参数设置好值
Map<String, Object> map = new HashMap<>();
map.put("appId", appid);
map.put("timeStamp", System.currentTimeMillis()/1000);
map.put("nonceStr", UUID.randomUUID().toString().replaceAll("-", ""));
//统一下单接口返回的prepay_id值
map.put("package", "prepay_id=123456789");
map.put("paySign", SignUtil.md5Sign(map));
//此处需要与统一下单的签名类型一致，sign_type参数不参与签名
map.put("signType", "MD5");
String jsonBody = Map2JsonUtil.map2Json(map);
②传到html中调起支付
function onBridgeReady(){
WeixinJSBridge.invoke(
'getBrandWCPayRequest', {
"appId":"wx2421b1c4370ec43b", //公众号ID，由商户传入
"timeStamp":"1395712654", //时间戳，自1970年以来的秒数
"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();
}
退款
微信v2版本在退款的时候，需要在客户端添加api证书（如下OkHttp3Util）。
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4
必填参数设置
Map<String, Object> map = new HashMap<>();
map.put("appId", appid);
map.put("mch_id", mchId);
map.put("nonceStr", UUID.randomUUID().toString().replaceAll("-", ""));
map.put("out_trade_no", refundRequest.getOutTradeNo());
map.put("out_refund_no", refundRequest.getOutRefundNo());
map.put("total_fee", refundRequest.getTotalFee());
map.put("refund_fee", refundRequest.getRefundFee());
map.put("refund_fee_type", "CNY");
//签名放到最后，前面的参数都已经存储进来
map.put("sign", SignUtil.md5Sign(map));
//sign_type参数不参与签名
map.put("signType", "MD5");
String xmlBody = Map2XmlUtil.map2Xml(map);
备注：以上接口都是微信v2版本接口，请求数据都是xml格式v2版本接口地址；
v3版本的接口是为json格式v3版本接口地址
工具SignUtil，Map2XmlUtil，OkHttp3Util，SslFactoryUtil
public class SignUtil {
private static String signKey = "1234567890";
/**
* md5签名
*
* @return
*/
public static String md5Sign(Map<String, Object> signParam) {
//对参数按照key=value的格式，并按照参数名ASCII字典序排序
List<String> keySet = signParam.keySet().stream().sorted().collect(Collectors.toList());
StringBuilder stringA = new StringBuilder();
for (String key : keySet) {
stringA.append(key).append("=").append(signParam.get(key)).append("&");
}
//拼接API密钥
String stringSignTemp = stringA.append("key=").append(signKey).toString();
System.out.println("签名参数[" + stringSignTemp + "]");
//apache的md5工具
return DigestUtils.md5DigestAsHex(stringSignTemp.getBytes()).toUpperCase();
}
}
public class Map2XmlUtil {
/**
* md5签名
*
* @return
*/
public static String map2Xml(Map<String, Object> signParam) {
StringBuilder sb = new StringBuilder("" );
for(String key : signParam.keySet()) {
sb.append("<" + key + ">");
sb.append(signParam.get(key).toString());
sb.append(" + key + ">");
}
sb.append("");
System.out.println("map转xml后的数据[" + sb.toString() + "]");
return sb.toString();
}
}
public class OkHttp3Util {
/**
* 交易客户端
*/
public static OkHttpClient httpClient = new OkHttpClient.Builder()
//忽略hostname验证
.hostnameVerifier((s, sslSession) -> true)
.connectTimeout(60, TimeUnit.SECONDS)
.readTimeout(60, TimeUnit.SECONDS)
.build();
/**
* 退款客户端
*
* @return
*/
public static OkHttpClient sslHttpClient = new OkHttpClient.Builder()
//忽略hostname验证
.hostnameVerifier((s, sslSession) -> true)
.connectTimeout(60, TimeUnit.SECONDS)
.readTimeout(60, TimeUnit.SECONDS)
//退款需要api证书
.sslSocketFactory(SslFactoryUtil.createSSLSocketFactory(), SslFactoryUtil.createNoTrustManager())
.build();
}
@Slf4j
public class SslFactoryUtil {
/**
* 文件位置：/resources/cert/wx_isv.p12
*/
private static final String wxIsvCertPath = "/cert/wx_isv.p12";
/**
* mchId值
*/
private static final String wxIsvCertPassword = "mchId";
/**
* 初始化证书容器
*
* @return
*/
public static SSLSocketFactory createSSLSocketFactory() {
try {
KeyStore keyStore = KeyStore.getInstance("PKCS12");
keyStore.load(SslFactoryUtil.class.getResourceAsStream(wxIsvCertPath), wxIsvCertPassword.toCharArray());
KeyManagerFactory keyManagerFactory = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());
keyManagerFactory.init(keyStore, wxIsvCertPassword.toCharArray());
SSLContext serverContext = SSLContext.getInstance("TLS");
serverContext.init(keyManagerFactory.getKeyManagers(), null, new SecureRandom());
return serverContext.getSocketFactory();
} catch (Exception e) {
log.error("初始化证书失败!");
throw new RuntimeException("初始化SSLContext失败", e);
}
}
/**
* 证书管理器
*
* @return
*/
public static X509TrustManager createNoTrustManager() {
try {
TrustManagerFactory trustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
trustManagerFactory.init((KeyStore) null);
TrustManager[] trustManagers = trustManagerFactory.getTrustManagers();
if (trustManagers.length != 1 || !(trustManagers[0] instanceof X509TrustManager)) {
throw new IllegalStateException("非默认管理器:" + Arrays.toString(trustManagers));
}
return (X509TrustManager) trustManagers[0];
} catch (Exception e) {
log.error("初始化证书失败", e);
throw new RuntimeException("初始化证书失败", e);
}
}
}
更多文章请关注我的微信公众号
