WechatPayCore (payment-thl 1.0.0 API)

java.lang.Object
- org.thlws.payment.wechat.core.WechatPayCore

所有已实现的接口:

WechatPayApi
```
public class WechatPayCore
extends Object
implements WechatPayApi
```
微信支付核心处理

版本:

1.0

作者:

Hanley | hanley@thlws.com

另请参阅:

https://pay.weixin.qq.com/guide/index.shtml, https://pay.weixin.qq.com/wiki/doc/api/sl.html, https://pay.weixin.qq.com/wiki/doc/api/index.html

字段概要
- 从接口继承的字段 org.thlws.payment.wechat.api.WechatPayApi
  close_order, micro_mch_add, micro_mch_qry, pay_micropay, pay_openidquery, pay_orderquery, pay_refund, pay_reverse, pay_unifiedorder

构造器概要

构造器
构造器和说明

WechatPayCore()

构造器
构造器和说明
`WechatPayCore()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static CloseOrderResponse`	`closeOrder(CloseOrderRequest request, String apiKey)` 微信订单关闭,商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口.
`static WechatPayResponse`	`microPay(WechatPayRequest request, String apiKey)` 微信刷卡支付,商户使用扫描枪扫用户微信支付码,消费者为被扫码对象,此方式与扫码支付扫码方式相反.
`static OpenidQueryResponse`	`openidQuery(OpenidQueryRequest request, String apiKey)` 根据用户支付码查询用户在该账户的openid.
`static OrderQueryResponse`	`orderQuery(OrderQueryRequest request, String apiKey)` 微信订单查询,除核心参数外(appid,mch_id等为核心参数)业务参数 transaction_id ,out_trade_no 二选一即可需要调用查询接口的情况当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；调用支付接口后，返回系统错误或未知交易状态情况；调用刷卡支付API，返回USERPAYING的状态；调用关单或撤销接口API之前，需确认支付状态；
`static MicroMchResponse`	`postMicroMch(MicroMchRequest request, String apiKey, String p12FilePath)` 申请小微收款识别码
`static MicroMchResponse`	`queryMicroMch(MicroMchRequest request, String apiKey, String p12FilePath)` 查询小微收款人信息
`static WechatRefundResponse`	`refund(WechatRefundRequest request, String apiKey, String p12FilePath)` 微信退款,必须指定p12文件路径,否则无法完成退款动作,目前已知退款和撤销接口需要提供p12文件使用该接口注意事项交易时间超过一年的订单无法提交退款; 微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。
`static WechatReverseResponse`	`reverse(WechatReverseRequest request, String apiKey, String p12FilePath)` 微信撤销订单使用情境支付交易返回失败或支付系统超时，调用该接口撤销交易。
`static UnifiedOrderResponse`	`unifiedOrder(UnifiedOrderRequest request, String apiKey)` 微信统一下单，同时支援扫码支付统一下单和微信公众号统一下单

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - WechatPayCore
```
public WechatPayCore()
```
- 方法详细资料
  - unifiedOrder
```
public static UnifiedOrderResponse unifiedOrder(UnifiedOrderRequest request,
                                                String apiKey)
                                         throws Exception
```
    微信统一下单，同时支援扫码支付统一下单和微信公众号统一下单
    
    参数:
    
    request - 统一下单参数对象 UnifiedOrderRequest
    
    apiKey - 微信API秘钥
    
    返回:
    
    统一下单结果对象 UnifiedOrderResponse
    
    抛出:
    
    Exception - the exception
    
    另请参阅:
    
    https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_1, https://pay.weixin.qq.com/wiki/doc/api/native_sl.php?chapter=9_1
  - refund
```
public static WechatRefundResponse refund(WechatRefundRequest request,
                                          String apiKey,
                                          String p12FilePath)
                                   throws Exception
```
    微信退款,必须指定p12文件路径,否则无法完成退款动作,目前已知退款和撤销接口需要提供p12文件
    使用该接口注意事项
    1. 交易时间超过一年的订单无法提交退款;
    2. 微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号;
    3. 请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款申请请求不超过6次;
    4. 每个支付订单的部分退款次数不能超过50次;
    参数:
    
    request - 退款参数对象 WechatRefundRequest
    
    apiKey - 微信API秘钥
    
    p12FilePath - 微信p12文件路径
    
    返回:
    
    微信退款结果对象 WechatRefundResponse
    
    抛出:
    
    Exception - the exception
    
    另请参阅:
    
    https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_4, https://pay.weixin.qq.com/wiki/doc/api/native_sl.php?chapter=9_4
  - orderQuery
```
public static OrderQueryResponse orderQuery(OrderQueryRequest request,
                                            String apiKey)
                                     throws Exception
```
    微信订单查询,除核心参数外(appid,mch_id等为核心参数)业务参数 transaction_id ,out_trade_no 二选一即可
    
    需要调用查询接口的情况
    1. 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
    2. 调用支付接口后，返回系统错误或未知交易状态情况；
    3. 调用刷卡支付API，返回USERPAYING的状态；
    4. 调用关单或撤销接口API之前，需确认支付状态；
    参数:
    
    request - 查询参数对象 OrderQueryRequest
    
    apiKey - API秘钥
    
    返回:
    
    订单查询结果对象 OrderQueryResponse
    
    抛出:
    
    Exception - the exception
    
    另请参阅:
    
    https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_2, https://pay.weixin.qq.com/wiki/doc/api/native_sl.php?chapter=9_2
  - reverse
```
public static WechatReverseResponse reverse(WechatReverseRequest request,
                                            String apiKey,
                                            String p12FilePath)
                                     throws Exception
```
    微信撤销订单
    使用情境
    
    支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，微信支付系统会将此订单关闭；如果用户支付成功，微信支付系统会将此订单资金退还给用户。
    注意
    
    7天以内的交易单可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】
    
    参数:
    
    request - 撤销参数对象 WechatReverseRequest
    
    apiKey - API秘钥
    
    p12FilePath - p12文件路径
    
    返回:
    
    撤销结果对象 WechatReverseResponse
    
    抛出:
    
    Exception - the exception
    
    另请参阅:
    
    普通商户撤销接口, 服务商撤销接口
  - closeOrder
```
public static CloseOrderResponse closeOrder(CloseOrderRequest request,
                                            String apiKey)
                                     throws Exception
```
    微信订单关闭,商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口.
    订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。
    
    参数:
    
    request - 参数对象 CloseOrderRequest
    
    apiKey - 微信API秘钥
    
    返回:
    
    订单关闭结果对象 CloseOrderResponse
    
    抛出:
    
    Exception - the exception
    
    另请参阅:
    
    普通商户关闭订单接口
    , 服务商关闭订单接口
  - microPay
```
public static WechatPayResponse microPay(WechatPayRequest request,
                                         String apiKey)
                                  throws Exception
```
    微信刷卡支付,商户使用扫描枪扫用户微信支付码,消费者为被扫码对象,此方式与扫码支付扫码方式相反.
    参数:
    
    request - 支付参数对象 WechatPayRequest
    
    apiKey - 微信API秘钥
    
    返回:
    
    支付结果对象 WechatPayResponse
    
    抛出:
    
    Exception - the exception
    
    另请参阅:
    普通商户刷卡支付接口, 服务商刷卡支付接口提醒事项
    
    提交支付请求后微信会同步返回支付结果。当返回结果为“系统错误”时，商户系统等待5秒后调用【查询订单API】，查询支付实际交易结果；当返回结果为“USERPAYING”时，商户系统可设置间隔时间(建议10秒)重新查询支付结果，直到支付成功或超时(建议30秒)；
    
    在调用查询接口返回后，如果交易状况不明晰，请调用【撤销订单API】，此时如果交易失败则关闭订单，该单不能再支付成功；如果交易成功，则将扣款退回到用户账户。当撤销无返回或错误时，请再次调用。注意：请勿扣款后立即调用【撤销订单API】,建议至少15秒后再调用。撤销订单API需要双向证书。
  - openidQuery
```
public static OpenidQueryResponse openidQuery(OpenidQueryRequest request,
                                              String apiKey)
                                       throws Exception
```
    根据用户支付码查询用户在该账户的openid.
    
    参数:
    
    request - data 支付参数对象 OpenidQueryRequest
    
    apiKey - 微信API秘钥
    
    返回:
    
    查询结果对象 OpenidQueryResponse
    
    抛出:
    
    Exception - the exception
    
    另请参阅:
    
    授权码查询openid
  - postMicroMch
```
public static MicroMchResponse postMicroMch(MicroMchRequest request,
                                            String apiKey,
                                            String p12FilePath)
                                     throws Exception
```
    申请小微收款识别码
    
    参数:
    
    request - the request
    
    apiKey - the api key
    
    p12FilePath - the p 12 file path
    
    返回:
    
    the micro mch response
    
    抛出:
    
    Exception - the exception
  - queryMicroMch
```
public static MicroMchResponse queryMicroMch(MicroMchRequest request,
                                             String apiKey,
                                             String p12FilePath)
                                      throws Exception
```
    查询小微收款人信息
    
    参数:
    
    request - the request
    
    apiKey - the api key
    
    p12FilePath - the p 12 file path
    
    返回:
    
    string micro mch response
    
    抛出:
    
    Exception - the exception

类 WechatPayCore

字段概要

从接口继承的字段 org.thlws.payment.wechat.api.WechatPayApi

构造器概要

方法概要

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

构造器详细资料

WechatPayCore

方法详细资料

unifiedOrder

refund

orderQuery

reverse

closeOrder

microPay

openidQuery

postMicroMch

queryMicroMch