微信支付 Java SDK

对微信支付开发者文档中给出的API进行了封装。

com.github.wxpay.sdk.WXPay类下提供了对应的方法：

方法名

说明microPay

刷卡支付

unifiedOrder

统一下单

orderQuery

查询订单

reverse

撤销订单

closeOrder

关闭订单

refund

申请退款

refundQuery

查询退款

downloadBill

下载对账单

report

交易保障

shortUrl

转换短链接

authCodeToOpenid

授权码查询openid注意:

证书文件不能放在web服务器虚拟目录，应放在有访问权限控制的目录中，防止被他人下载

建议将证书文件名改为复杂且不容易猜测的文件名

商户服务器要做好病毒和木马防护工作，不被非法侵入者窃取证书文件

请妥善保管商户支付密钥、公众帐号SECRET，避免密钥泄露

参数为Map对象，返回类型也是Map

方法内部会将参数会转换成含有appid、mch_id、nonce_str、sign\_type和sign的XML

可选HMAC-SHA256算法和MD5算法签名

通过HTTPS请求得到返回数据后会对其做必要的处理(例如验证签名，签名错误则抛出异常)

对于downloadBill，无论是否成功都返回Map，且都含有return_code和return_msg，若成功，其中return_code为SUCCESS，另外data对应对账单数据

示例

配置类MyConfig:

import com.github.wxpay.sdk.WXPayConfig;

import java.io.*;

public class MyConfig implements WXPayConfig{

private byte[] certData;

public MyConfig() throws Exception {

String certPath = "/path/to/apiclient_cert.p12";

File file = new File(certPath);

InputStream certStream = new FileInputStream(file);

this.certData = new byte[(int) file.length()];

certStream.read(this.certData);

certStream.close();

}

public String getAppID() {

return "wx8888888888888888";

}

public String getMchID() {

return "12888888";

}

public String getKey() {

return "88888888888888888888888888888888";

}

public InputStream getCertStream() {

ByteArrayInputStream certBis = new ByteArrayInputStream(this.certData);

return certBis;

}

public int getHttpConnectTimeoutMs() {

return 8000;

}

public int getHttpReadTimeoutMs() {

return 10000;

}

}

统一下单：

import com.github.wxpay.sdk.WXPay;

import java.util.HashMap;

import java.util.Map;

public class WXPayExample {

public static void main(String[] args) throws Exception {

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config);

Map data = new HashMap();

data.put("body", "腾讯充值中心-QQ会员充值");

data.put("out_trade_no", "2016090910595900000012");

data.put("device_info", "");

data.put("fee_type", "CNY");

data.put("total_fee", "1");

data.put("spbill_create_ip", "123.12.12.123");

data.put("notify_url", "http://www.example.com/wxpay/notify");

data.put("trade_type", "NATIVE"); // 此处指定为扫码支付

data.put("product_id", "12");

try {

Map resp = wxpay.unifiedOrder(data);

System.out.println(resp);

} catch (Exception e) {

e.printStackTrace();

}

}

}

订单查询：

import com.github.wxpay.sdk.WXPay;

import java.util.HashMap;

import java.util.Map;

public class WXPayExample {

public static void main(String[] args) throws Exception {

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config);

Map data = new HashMap();

data.put("out_trade_no", "2016090910595900000012");

try {

Map resp = wxpay.orderQuery(data);

System.out.println(resp);

} catch (Exception e) {

e.printStackTrace();

}

}

}

退款查询：

import com.github.wxpay.sdk.WXPay;

import java.util.HashMap;

import java.util.Map;

public class WXPayExample {

public static void main(String[] args) throws Exception {

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config);

Map data = new HashMap();

data.put("out_trade_no", "2016090910595900000012");

try {

Map resp = wxpay.refundQuery(data);

System.out.println(resp);

} catch (Exception e) {

e.printStackTrace();

}

}

}

下载对账单：

import com.github.wxpay.sdk.WXPay;

import java.util.HashMap;

import java.util.Map;

public class WXPayExample {

public static void main(String[] args) throws Exception {

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config);

Map data = new HashMap();

data.put("bill_date", "20140603");

data.put("bill_type", "ALL");

try {

Map resp = wxpay.downloadBill(data);

System.out.println(resp);

} catch (Exception e) {

e.printStackTrace();

}

}

}

其他API的使用和上面类似。

暂时不支持下载压缩格式的对账单，但可以使用该SDK生成请求用的XML数据：

import com.github.wxpay.sdk.WXPay;

import com.github.wxpay.sdk.WXPayUtil;

import java.util.HashMap;

import java.util.Map;

public class WXPayExample {

public static void main(String[] args) throws Exception {

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config);

Map data = new HashMap();

data.put("bill_date", "20140603");

data.put("bill_type", "ALL");

data.put("tar_type", "GZIP");

try {

data = wxpay.fillRequestData(data);

System.out.println(WXPayUtil.mapToXml(data));

} catch (Exception e) {

e.printStackTrace();

}

}

}

收到支付结果通知时，需要验证签名，可以这样做：

import com.github.wxpay.sdk.WXPay;

import com.github.wxpay.sdk.WXPayUtil;

import java.util.Map;

public class WXPayExample {

public static void main(String[] args) throws Exception {

String notifyData = "...."; // 支付结果通知的xml格式数据

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config);

Map notifyMap = WXPayUtil.xmlToMap(notifyData); // 转换成map

if (wxpay.isPayResultNotifySignatureValid(notifyMap)) {

// 签名正确

// 进行处理。

// 注意特殊情况：订单已经退款，但收到了支付结果成功的通知，不应把商户侧订单状态从退款改成支付成功

}

else {

// 签名错误，如果数据里没有sign字段，也认为是签名错误

}

}

}

HTTPS请求可选HMAC-SHA256算法和MD5算法签名：

import com.github.wxpay.sdk.WXPay;

import com.github.wxpay.sdk.WXPayConstants;

public class WXPayExample {

public static void main(String[] args) throws Exception {

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config, WXPayConstants.SignType.HMACSHA256);

// ......

}

}

若需要使用sandbox环境：

import com.github.wxpay.sdk.WXPay;

import com.github.wxpay.sdk.WXPayConstants;

public class WXPayExample {

public static void main(String[] args) throws Exception {

MyConfig config = new MyConfig();

WXPay wxpay = new WXPay(config, WXPayConstants.SignType.MD5, true);

// ......

}

}