微信支付 - 簡書

微信支付 Java SDK

com.github.wxpay.sdk.WXPay類下提供了對應的方法：

方法名	說明
microPay	刷卡支付
unifiedOrder	統(tǒng)一下單
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 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;
    }
}

統(tǒng)一下單：

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)) {
            // 簽名正確
            // 進行處理咧织。
            // 注意特殊情況：訂單已經退款，但收到了支付結果成功的通知籍救，不應把商戶側訂單狀態(tài)從退款改成支付成功
        }
        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環(huán)境：

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);
        // ......
    }

}