org.thlws.payment.wechat.core

类 WechatCore

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()

方法概要

方法

限定符和类型	方法和说明
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

另请参阅:

普通商户刷卡支付接口, 服务商刷卡支付接口 提醒事项

1. 提交支付请求后微信会同步返回支付结果。当返回结果为“系统错误”时，商户系统等待5秒后调用【查询订单API】，查询支付实际交易结果；当返回结果为“USERPAYING”时，商户系统可设置间隔时间(建议10秒)重新查询支付结果，直到支付成功或超时(建议30秒)；
2. 在调用查询接口返回后，如果交易状况不明晰，请调用【撤销订单API】，此时如果交易失败则关闭订单，该单不能再支付成功；如果交易成功，则将扣款退回到用户账户。当撤销无返回或错误时，请再次调用。注意：请勿扣款后立即调用【撤销订单API】,建议至少15秒后再调用。撤销订单API需要双向证书。