WechatCore (payment-wechat 1.0.2 API)

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

所有已实现的接口:

WechatApi
```
public class WechatCore
extends Object
implements WechatApi
```
微信支付核心处理

版本:

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.WechatApi
  cgi_bin_ticket_getticket, cgibin_add_template, cgibin_send_data, cgibin_set_industry, cgibin_token, close_order, micro_mch_add, micro_mch_qry, oauth2_access_token, oauth2_refresh_token, pay_micropay, pay_orderquery, pay_refund, pay_reverse, pay_unifiedorder, sns_auth_token, sns_userinfo

构造器概要

构造器
构造器和说明

WechatCore()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static CloseOrderOutput`	`closeOrder(CloseOrderInput data, String apiKey)` 微信订单关闭,商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口.
`static WechatPayOutput`	`micropay(WechatPayInput data, String apiKey)` 微信刷卡支付,商户使用扫描枪扫用户微信支付码,消费者为被扫码对象,此方式与扫码支付扫码方式相反.
`static OrderQueryOutput`	`orderQuery(OrderQueryInput data, String apiKey)` 微信订单查询,除核心参数外(appid,mch_id等为核心参数)业务参数 transaction_id ,out_trade_no 二选一即可需要调用查询接口的情况当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；调用支付接口后，返回系统错误或未知交易状态情况；调用刷卡支付API，返回USERPAYING的状态；调用关单或撤销接口API之前，需确认支付状态；
`static WechatRefundOutput`	`refund(WechatRefundInput data, String apiKey, String p12FilePath)` 微信退款,必须指定p12文件路径,否则无法完成退款动作,目前已知退款和撤销接口需要提供p12文件使用该接口注意事项交易时间超过一年的订单无法提交退款; 微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。
`static WechatReverseOutput`	`reverse(WechatReverseInput data, String apiKey, String p12FilePath)` 微信撤销订单使用情境支付交易返回失败或支付系统超时，调用该接口撤销交易。
`static UnifiedOrderOutput`	`unifiedorder(UnifiedOrderInput data, String apiKey)` 微信统一下单，同时支援扫码支付统一下单和微信公众号统一下单

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

- 构造器详细资料
  - WechatCore
```
public WechatCore()
```
- 方法详细资料
  - unifiedorder
```
public static UnifiedOrderOutput unifiedorder(UnifiedOrderInput data,
                                              String apiKey)
```
    微信统一下单，同时支援扫码支付统一下单和微信公众号统一下单
    
    参数:
    
    data - 统一下单参数对象 UnifiedOrderInput
    
    apiKey - 微信API秘钥
    
    返回:
    
    统一下单结果对象 UnifiedOrderOutput
    
    另请参阅:
    
    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 WechatRefundOutput refund(WechatRefundInput data,
                                        String apiKey,
                                        String p12FilePath)
```
    微信退款,必须指定p12文件路径,否则无法完成退款动作,目前已知退款和撤销接口需要提供p12文件
    使用该接口注意事项
    1. 交易时间超过一年的订单无法提交退款;
    2. 微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号;
    3. 请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款申请请求不超过6次;
    4. 每个支付订单的部分退款次数不能超过50次;
    参数:
    
    data - 退款参数对象 WechatRefundInput
    
    apiKey - 微信API秘钥
    
    p12FilePath - 微信p12文件路径
    
    返回:
    
    微信退款结果对象 WechatRefundOutput
    
    另请参阅:
    
    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 OrderQueryOutput orderQuery(OrderQueryInput data,
                                          String apiKey)
```
    微信订单查询,除核心参数外(appid,mch_id等为核心参数)业务参数 transaction_id ,out_trade_no 二选一即可
    需要调用查询接口的情况
    1. 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
    2. 调用支付接口后，返回系统错误或未知交易状态情况；
    3. 调用刷卡支付API，返回USERPAYING的状态；
    4. 调用关单或撤销接口API之前，需确认支付状态；
    参数:
    
    data - 查询参数对象 OrderQueryInput
    
    apiKey - API秘钥
    
    返回:
    
    订单查询结果对象 OrderQueryOutput
    
    另请参阅:
    
    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 WechatReverseOutput reverse(WechatReverseInput data,
                                          String apiKey,
                                          String p12FilePath)
```
    微信撤销订单
    使用情境
    
    支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，微信支付系统会将此订单关闭；如果用户支付成功，微信支付系统会将此订单资金退还给用户。
    注意
    
    7天以内的交易单可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】
    
    参数:
    
    data - 撤销参数对象 WechatReverseInput
    
    apiKey - API秘钥
    
    p12FilePath - p12文件路径
    
    返回:
    
    撤销结果对象 WechatReverseOutput
    
    另请参阅:
    
    普通商户撤销接口, 服务商撤销接口
  - closeOrder
```
public static CloseOrderOutput closeOrder(CloseOrderInput data,
                                          String apiKey)
```
    微信订单关闭,商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口.
    订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。
    
    参数:
    
    data - 参数对象 CloseOrderInput
    
    apiKey - 微信API秘钥
    
    返回:
    
    订单关闭结果对象 CloseOrderOutput
    
    另请参阅:
    
    普通商户关闭订单接口
    , 服务商关闭订单接口
  - micropay
```
public static WechatPayOutput micropay(WechatPayInput data,
                                       String apiKey)
```
    微信刷卡支付,商户使用扫描枪扫用户微信支付码,消费者为被扫码对象,此方式与扫码支付扫码方式相反.
    参数:
    
    data - 支付参数对象 WechatPayInput
    
    apiKey - 微信API秘钥
    
    返回:
    
    支付结果对象 WechatPayOutput
    
    另请参阅:
    普通商户刷卡支付接口, 服务商刷卡支付接口提醒事项
    
    提交支付请求后微信会同步返回支付结果。当返回结果为“系统错误”时，商户系统等待5秒后调用【查询订单API】，查询支付实际交易结果；当返回结果为“USERPAYING”时，商户系统可设置间隔时间(建议10秒)重新查询支付结果，直到支付成功或超时(建议30秒)；
    
    在调用查询接口返回后，如果交易状况不明晰，请调用【撤销订单API】，此时如果交易失败则关闭订单，该单不能再支付成功；如果交易成功，则将扣款退回到用户账户。当撤销无返回或错误时，请再次调用。注意：请勿扣款后立即调用【撤销订单API】,建议至少15秒后再调用。撤销订单API需要双向证书。

类 WechatCore

字段概要

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

构造器概要

方法概要

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

构造器详细资料

WechatCore

方法详细资料

unifiedorder

refund

orderQuery

reverse

closeOrder

micropay