微信刷卡 sdk java_微信支付 Java SDK

微信支付 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);

// ......

}

}