微信支付 SDK 文档 (V3.0.9)

微信支付 Java SDK

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

方法名	说明
microPay	刷卡支付
unifiedOrder	统一下单
orderQuery	查询订单
reverse	撤销订单
closeOrder	关闭订单
refund	申请退款
refundQuery	查询退款
downloadBill	下载对账单
report	交易保障
shortUrl	转换短链接
authCodeToOpenid	授权码查询 openid

注意:
证书文件不能放在 web 服务器虚拟目录，应放在有访问权限控制的目录中，防止被他人下载
建议将证书文件名改为复杂且不容易猜测的文件名
商户服务器要做好病毒和木马防护工作，不被非法侵入者窃取证书文件
请妥善保管商户支付密钥、公众帐号 SECRET，避免密钥泄露
参数为 Map<String, String> 对象，返回类型也是 Map<String, String>
方法内部会将参数会转换成含有 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 java.io.ByteArrayInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

public class MyConfig extends WXPayConfig {
	
	private byte[] certData;
	
	private String appid = "wxxsxxxxxxxxxxx";
	private String mch_id = "xxxxxxxxx";
	private String key = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
	
	public MyConfig() {
		String certPath = "/path/to/apiclient_cert.p12";
		File file = new File(certPath);
		try(InputStream certStream = new FileInputStream(file)) {
		   this.certData = new byte[(int) file.length()];
		   certStream.read(this.certData);
		   certStream.close();
		} catch (Exception e) {
		}
	}
	
	public String getAppid() {
		return appid;
	}

	public void setAppid(String appid) {
		this.appid = appid;
	}

	public String getMch_id() {
		return mch_id;
	}

	public void setMch_id(String mch_id) {
		this.mch_id = mch_id;
	}

	public void setKey(String key) {
		this.key = key;
	}

	@Override
	String getAppID() {
		return this.appid;
	}

	@Override
	String getMchID() {
		return this.mch_id;
	}

	@Override
	String getKey() {
		return this.key;
	}

	@Override
	InputStream getCertStream() {
		ByteArrayInputStream certBis = new ByteArrayInputStream(this.certData);
        return certBis;
	}

	@Override
	IWXPayDomain getWXPayDomain() {
		return new IWXPayDomain() {
			
			@Override
			public void report(String domain, long elapsedTimeMillis, Exception ex) {
			}
			
			@Override
			public DomainInfo getDomain(WXPayConfig config) {
				return new DomainInfo("api.mch.weixin.qq.com", true);
			}
		};
	}
	
	@Override
	public boolean shouldAutoReport() {
		return false;
	}
	
}

统一下单：


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<String, String> data = new HashMap<String, String>();
        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<String, String> 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<String, String> data = new HashMap<String, String>();
        data.put("out_trade_no", "2016090910595900000012");

        try {
            Map<String, String> 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<String, String> data = new HashMap<String, String>();
        data.put("out_trade_no", "2016090910595900000012");

        try {
            Map<String, String> 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<String, String> data = new HashMap<String, String>();
        data.put("bill_date", "20140603");
        data.put("bill_type", "ALL");

        try {
            Map<String, String> 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<String, String> data = new HashMap<String, String>();
        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<String, String> 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);
        // ......
    }

}

资源下载

WxPayAPI_JAVAzip

接入微信支付流程

接入微信支付流程在正式编写微信支付代码前，需要对微信公众平台，微信商户平台的进行配置。本文是对接公众号支付接入流程配置的笔记一、注册微信商户号根据登录商户平台页面接入指引，选择自己需要接入的支付方式，准备好注册商户号的资料（这里以公众号支付为例），根据该接入指引完成微信商户号注册。 [图片] 二、准备微信支付所需 ..

微信支付问题一案例

[图片] 微信支付开发的微信支付，对接小程序在价格变动, 商品名等改动的时候, 如果还是原来的商户号, 微信会返回 'err_code_des', '201 商户订单号重复' 解决方式是对微信的 req 做一个 check, 如果没有正确响应，则生成一个新的订单。支付示例 def weixin_pay(open ..

个人支付接口现状分析——帮助个人开发者实现在线收款

本篇文章的目的，是向正在寻求个人支付方案的开发者朋友们提供一些信息，希望能给他们一定的帮助，结合自己的使用环境、业务领域和应用场景自行选择。对提到的所有第三方支付工具、第四方聚合支付工具绝无恶意贬低。如何选择一个靠谱的个人支付服务方？选择标准 1.var 标准 = 安全性 && 稳定性 && ..

快捷支付 / 协议支付交易流程设计

[图片] 背景（本文所站的角度是第三方支付机构）之前做过的支付类的快捷交易，各个银行开出的接口都不尽相同（包括签约和支付），有的需要 1 支完成（我们称之为签约确认/支付确认），有的需要 2 支完成（签约申请 + 签约确认/支付申请 + 支付确认），有的则需要 3 支完成（签约申请 + 签约短信 + 签约确认/支付 ..

目前市面个人支付收款环境及解决办法

背景：最初想分享一些资源类的东西，搭建了博客，随着附件和访问量过大，小博客变成臃肿的网站了，没办法想着收费，恰巧赶上知识付费这么个环境，也算还好。但是随之，最终核心问题来了，收款。对的，没看错，我也没很无奈，个人支付收款竟然成了最困难最无法解决的环节。市场解决办法就目前来看，大多数都是通过绕路或者歪门邪道达到目的 ..

关于微信支付 XML 回调 XXE 漏洞

最近正在写小程序，刚刚把支付功能写完就曝出了这个漏洞解决方法如下： /** * 防XXE注入实体攻击 * 过滤关键词：SYSTEM、DOCTYPE、ENTITY、PUBLIC。 */ public static String filterXXE(String xmlStr){ xmlStr = xmlStr.repl ..

欢迎来到这里！

我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。

关于

微信支付 SDK 文档 (V3.0.9)

微信支付 Java SDK

示例

相关帖子

接入微信支付流程

微信支付问题一案例

个人支付接口现状分析——帮助个人开发者实现在线收款

快捷支付 / 协议支付交易流程设计

目前市面个人支付收款环境及解决办法

关于微信支付 XML 回调 XXE 漏洞

发币，炒币，割韭菜，一茬又一茬

欢迎来到这里！

近期热议

推荐标签标签

最新标签

微信支付 SDK 文档 (V3.0.9)

微信支付 Java SDK

示例

相关帖子

接入微信支付流程

微信支付问题一案例

个人支付接口现状分析——帮助个人开发者实现在线收款

快捷支付 / 协议支付 交易流程设计

目前市面个人支付收款环境及解决办法

关于微信支付 XML 回调 XXE 漏洞

发币，炒币，割韭菜，一茬又一茬

欢迎来到这里！

近期热议

推荐标签 标签

最新标签

快捷支付 / 协议支付交易流程设计

推荐标签标签