com.kdayun.wechat.sdk

类 WXPay

java.lang.Object

com.kdayun.wechat.sdk.WXPay

public class WXPay
extends java.lang.Object

构造器概要

构造器

构造器和说明
WXPay(WXPayConfig config)
WXPay(WXPayConfig config, boolean autoReport)
WXPay(WXPayConfig config, boolean autoReport, boolean useSandbox)
WXPay(WXPayConfig config, java.lang.String notifyUrl)
WXPay(WXPayConfig config, java.lang.String notifyUrl, boolean autoReport)
WXPay(WXPayConfig config, java.lang.String notifyUrl, boolean autoReport, boolean useSandbox)

方法概要

限定符和类型	方法和说明
java.util.Map<java.lang.String,java.lang.String>	authCodeToOpenid(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：授权码查询OPENID接口 场景：刷卡支付
java.util.Map<java.lang.String,java.lang.String>	authCodeToOpenid(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：授权码查询OPENID接口 场景：刷卡支付
java.util.Map<java.lang.String,java.lang.String>	closeOrder(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：关闭订单 场景：公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	closeOrder(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：关闭订单 场景：公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	downloadBill(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：对账单下载（成功时返回对账单数据，失败时返回XML格式数据） 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	downloadBill(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：对账单下载 场景：刷卡支付、公共号支付、扫码支付、APP支付 其他：无论是否成功都返回Map。
java.util.Map<java.lang.String,java.lang.String>	fillRequestData(java.util.Map<java.lang.String,java.lang.String> reqData) 向 Map 中添加 appid、mch_id、nonce_str、sign_type、sign 该函数适用于商户适用于统一下单等接口，不适用于红包、代金券接口
boolean	isPayResultNotifySignatureValid(java.util.Map<java.lang.String,java.lang.String> reqData) 判断支付结果通知中的sign是否有效
boolean	isResponseSignatureValid(java.util.Map<java.lang.String,java.lang.String> reqData) 判断xml数据的sign是否有效，必须包含sign字段，否则返回false。
java.util.Map<java.lang.String,java.lang.String>	microPay(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：提交刷卡支付 场景：刷卡支付
java.util.Map<java.lang.String,java.lang.String>	microPay(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：提交刷卡支付 场景：刷卡支付
java.util.Map<java.lang.String,java.lang.String>	microPayWithPos(java.util.Map<java.lang.String,java.lang.String> reqData) 提交刷卡支付，针对软POS，尽可能做成功 内置重试机制，最多60s
java.util.Map<java.lang.String,java.lang.String>	microPayWithPos(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs) 提交刷卡支付，针对软POS，尽可能做成功 内置重试机制，最多60s
java.util.Map<java.lang.String,java.lang.String>	orderQuery(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：查询订单 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	orderQuery(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：查询订单 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	processResponseXml(java.lang.String xmlStr) 处理 HTTPS API返回数据，转换成Map对象。
java.util.Map<java.lang.String,java.lang.String>	refund(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：申请退款 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	refund(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：申请退款 场景：刷卡支付、公共号支付、扫码支付、APP支付 其他：需要证书
java.util.Map<java.lang.String,java.lang.String>	refundQuery(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：退款查询 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	refundQuery(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：退款查询 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	report(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：交易保障 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	report(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：交易保障 场景：刷卡支付、公共号支付、扫码支付、APP支付
java.lang.String	requestWithCert(java.lang.String urlSuffix, java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 需要证书的请求
java.lang.String	requestWithoutCert(java.lang.String urlSuffix, java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 不需要证书的请求
java.util.Map<java.lang.String,java.lang.String>	reverse(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：撤销订单 场景：刷卡支付
java.util.Map<java.lang.String,java.lang.String>	reverse(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：撤销订单 场景：刷卡支付 其他：需要证书
java.util.Map<java.lang.String,java.lang.String>	shortUrl(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：转换短链接 场景：刷卡支付、扫码支付
java.util.Map<java.lang.String,java.lang.String>	shortUrl(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：转换短链接 场景：刷卡支付、扫码支付
java.util.Map<java.lang.String,java.lang.String>	unifiedOrder(java.util.Map<java.lang.String,java.lang.String> reqData) 作用：统一下单 场景：公共号支付、扫码支付、APP支付
java.util.Map<java.lang.String,java.lang.String>	unifiedOrder(java.util.Map<java.lang.String,java.lang.String> reqData, int connectTimeoutMs, int readTimeoutMs) 作用：统一下单 场景：公共号支付、扫码支付、APP支付

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

WXPay

public WXPay(WXPayConfig config)
      throws java.lang.Exception

抛出:

java.lang.Exception

WXPay

public WXPay(WXPayConfig config,
             boolean autoReport)
      throws java.lang.Exception

抛出:

java.lang.Exception

WXPay

public WXPay(WXPayConfig config,
             boolean autoReport,
             boolean useSandbox)
      throws java.lang.Exception

抛出:

java.lang.Exception

WXPay

public WXPay(WXPayConfig config,
             java.lang.String notifyUrl)
      throws java.lang.Exception

抛出:

java.lang.Exception

WXPay

public WXPay(WXPayConfig config,
             java.lang.String notifyUrl,
             boolean autoReport)
      throws java.lang.Exception

抛出:

java.lang.Exception

WXPay

public WXPay(WXPayConfig config,
             java.lang.String notifyUrl,
             boolean autoReport,
             boolean useSandbox)
      throws java.lang.Exception

抛出:

java.lang.Exception

方法详细资料

fillRequestData

public java.util.Map<java.lang.String,java.lang.String> fillRequestData(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                                 throws java.lang.Exception

向 Map 中添加 appid、mch_id、nonce_str、sign_type、sign
该函数适用于商户适用于统一下单等接口，不适用于红包、代金券接口

参数:

reqData - 请求的数据

返回:

返回数据

抛出:

java.lang.Exception - 出错会抛出异常

isResponseSignatureValid

public boolean isResponseSignatureValid(java.util.Map<java.lang.String,java.lang.String> reqData)
                                 throws java.lang.Exception

判断xml数据的sign是否有效，必须包含sign字段，否则返回false。

参数:

reqData - 向wxpay post的请求数据

返回:

签名是否有效

抛出:

java.lang.Exception - 出错会抛出异常

isPayResultNotifySignatureValid

public boolean isPayResultNotifySignatureValid(java.util.Map<java.lang.String,java.lang.String> reqData)
                                        throws java.lang.Exception

判断支付结果通知中的sign是否有效

参数:

reqData - 向wxpay post的请求数据

返回:

签名是否有效

抛出:

java.lang.Exception - 出错会抛出异常

requestWithoutCert

public java.lang.String requestWithoutCert(java.lang.String urlSuffix,
                                           java.util.Map<java.lang.String,java.lang.String> reqData,
                                           int connectTimeoutMs,
                                           int readTimeoutMs)
                                    throws java.lang.Exception

不需要证书的请求

参数:

urlSuffix - String

reqData - 向wxpay post的请求数据

connectTimeoutMs - 超时时间，单位是毫秒

readTimeoutMs - 超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

requestWithCert

public java.lang.String requestWithCert(java.lang.String urlSuffix,
                                        java.util.Map<java.lang.String,java.lang.String> reqData,
                                        int connectTimeoutMs,
                                        int readTimeoutMs)
                                 throws java.lang.Exception

需要证书的请求

参数:

urlSuffix - String

reqData - 向wxpay post的请求数据 Map

connectTimeoutMs - 超时时间，单位是毫秒

readTimeoutMs - 超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

processResponseXml

public java.util.Map<java.lang.String,java.lang.String> processResponseXml(java.lang.String xmlStr)
                                                                    throws java.lang.Exception

处理 HTTPS API返回数据，转换成Map对象。return_code为SUCCESS时，验证签名。

参数:

xmlStr - API返回的XML格式数据

返回:

Map类型数据

抛出:

java.lang.Exception - 出错会抛出异常

microPay

public java.util.Map<java.lang.String,java.lang.String> microPay(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                          throws java.lang.Exception

作用：提交刷卡支付
场景：刷卡支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

microPay

public java.util.Map<java.lang.String,java.lang.String> microPay(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                 int connectTimeoutMs,
                                                                 int readTimeoutMs)
                                                          throws java.lang.Exception

作用：提交刷卡支付
场景：刷卡支付

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

microPayWithPos

public java.util.Map<java.lang.String,java.lang.String> microPayWithPos(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                                 throws java.lang.Exception

提交刷卡支付，针对软POS，尽可能做成功 内置重试机制，最多60s

参数:

reqData - 请求数据

返回:

数据map

抛出:

java.lang.Exception - 出错会抛出异常

microPayWithPos

public java.util.Map<java.lang.String,java.lang.String> microPayWithPos(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                        int connectTimeoutMs)
                                                                 throws java.lang.Exception

提交刷卡支付，针对软POS，尽可能做成功 内置重试机制，最多60s

参数:

reqData - 请求数据

connectTimeoutMs - 连接超时(毫秒)

返回:

数据Map

抛出:

java.lang.Exception - 出错会抛出异常

unifiedOrder

public java.util.Map<java.lang.String,java.lang.String> unifiedOrder(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                              throws java.lang.Exception

作用：统一下单
场景：公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

unifiedOrder

public java.util.Map<java.lang.String,java.lang.String> unifiedOrder(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                     int connectTimeoutMs,
                                                                     int readTimeoutMs)
                                                              throws java.lang.Exception

作用：统一下单
场景：公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

orderQuery

public java.util.Map<java.lang.String,java.lang.String> orderQuery(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                            throws java.lang.Exception

作用：查询订单
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

orderQuery

public java.util.Map<java.lang.String,java.lang.String> orderQuery(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                   int connectTimeoutMs,
                                                                   int readTimeoutMs)
                                                            throws java.lang.Exception

作用：查询订单
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据 int

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

reverse

public java.util.Map<java.lang.String,java.lang.String> reverse(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                         throws java.lang.Exception

作用：撤销订单
场景：刷卡支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

reverse

public java.util.Map<java.lang.String,java.lang.String> reverse(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                int connectTimeoutMs,
                                                                int readTimeoutMs)
                                                         throws java.lang.Exception

作用：撤销订单
场景：刷卡支付
其他：需要证书

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

closeOrder

public java.util.Map<java.lang.String,java.lang.String> closeOrder(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                            throws java.lang.Exception

作用：关闭订单
场景：公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

closeOrder

public java.util.Map<java.lang.String,java.lang.String> closeOrder(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                   int connectTimeoutMs,
                                                                   int readTimeoutMs)
                                                            throws java.lang.Exception

作用：关闭订单
场景：公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

refund

public java.util.Map<java.lang.String,java.lang.String> refund(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                        throws java.lang.Exception

作用：申请退款
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

refund

public java.util.Map<java.lang.String,java.lang.String> refund(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                               int connectTimeoutMs,
                                                               int readTimeoutMs)
                                                        throws java.lang.Exception

作用：申请退款
场景：刷卡支付、公共号支付、扫码支付、APP支付
其他：需要证书

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

refundQuery

public java.util.Map<java.lang.String,java.lang.String> refundQuery(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                             throws java.lang.Exception

作用：退款查询
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

refundQuery

public java.util.Map<java.lang.String,java.lang.String> refundQuery(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                    int connectTimeoutMs,
                                                                    int readTimeoutMs)
                                                             throws java.lang.Exception

作用：退款查询
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

downloadBill

public java.util.Map<java.lang.String,java.lang.String> downloadBill(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                              throws java.lang.Exception

作用：对账单下载（成功时返回对账单数据，失败时返回XML格式数据）
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

downloadBill

public java.util.Map<java.lang.String,java.lang.String> downloadBill(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                     int connectTimeoutMs,
                                                                     int readTimeoutMs)
                                                              throws java.lang.Exception

作用：对账单下载
场景：刷卡支付、公共号支付、扫码支付、APP支付
其他：无论是否成功都返回Map。若成功，返回的Map中含有return_code、return_msg、data， 其中return_code为`SUCCESS`，data为对账单数据。

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

经过封装的API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

report

public java.util.Map<java.lang.String,java.lang.String> report(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                        throws java.lang.Exception

作用：交易保障
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

report

public java.util.Map<java.lang.String,java.lang.String> report(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                               int connectTimeoutMs,
                                                               int readTimeoutMs)
                                                        throws java.lang.Exception

作用：交易保障
场景：刷卡支付、公共号支付、扫码支付、APP支付

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

shortUrl

public java.util.Map<java.lang.String,java.lang.String> shortUrl(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                          throws java.lang.Exception

作用：转换短链接
场景：刷卡支付、扫码支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

shortUrl

public java.util.Map<java.lang.String,java.lang.String> shortUrl(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                 int connectTimeoutMs,
                                                                 int readTimeoutMs)
                                                          throws java.lang.Exception

作用：转换短链接
场景：刷卡支付、扫码支付

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时(毫秒)

readTimeoutMs - 读取超时(毫秒)

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

authCodeToOpenid

public java.util.Map<java.lang.String,java.lang.String> authCodeToOpenid(java.util.Map<java.lang.String,java.lang.String> reqData)
                                                                  throws java.lang.Exception

作用：授权码查询OPENID接口
场景：刷卡支付

参数:

reqData - 向wxpay post的请求数据

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常

authCodeToOpenid

public java.util.Map<java.lang.String,java.lang.String> authCodeToOpenid(java.util.Map<java.lang.String,java.lang.String> reqData,
                                                                         int connectTimeoutMs,
                                                                         int readTimeoutMs)
                                                                  throws java.lang.Exception

作用：授权码查询OPENID接口
场景：刷卡支付

参数:

reqData - 向wxpay post的请求数据

connectTimeoutMs - 连接超时时间，单位是毫秒

readTimeoutMs - 读超时时间，单位是毫秒

返回:

API返回数据

抛出:

java.lang.Exception - 出错会抛出异常