public interface WxPayService
微信支付相关接口. Created by Binary Wang on 2016/7/28.
String getPayBaseUrl()
void addConfig(String mchId, WxPayConfig wxPayConfig)
WxPayConfig，适用于动态添加新的微信商户配置.mchId - 商户idwxPayConfig - 新的微信配置void removeConfig(String mchId)
mchId 所对应的 WxPayConfig，适用于动态移除微信商户配置.mchId - 对应商户的标识void setMultiConfig(Map<String,WxPayConfig> wxPayConfigs)
wxPayConfigs - WxPayConfig mapvoid setMultiConfig(Map<String,WxPayConfig> wxPayConfigs, String defaultMchId)
wxPayConfigs - WxPayConfig mapdefaultMchId - 设置一个WxPayConfig 所对应的mchId进行Http初始化boolean switchover(String mchId)
mchId - 商户标识WxPayService switchoverTo(String mchId)
mchId - 商户标识byte[] postForBytes(String url, String requestStr, boolean useKey) throws WxPayException
url - 请求地址requestStr - 请求信息useKey - 是否使用证书WxPayException - the wx pay exceptionString post(String url, String requestStr, boolean useKey) throws WxPayException
url - 请求地址requestStr - 请求信息useKey - 是否使用证书WxPayException - the wx pay exceptionString postV3(String url, String requestStr) throws WxPayException
url - 请求地址requestStr - 请求信息WxPayException - the wx pay exceptionString patchV3(String url, String requestStr) throws WxPayException
url - 请求地址requestStr - 请求信息WxPayException - the wx pay exceptionString postV3WithWechatpaySerial(String url, String requestStr) throws WxPayException
部分字段会包含敏感信息，所以在提交前需要在请求头中会包含"Wechatpay-Serial"信息
url - 请求地址requestStr - 请求信息WxPayException - the wx pay exceptionString postV3(String url, org.apache.http.client.methods.HttpPost httpPost) throws WxPayException
url - 请求地址httpPost - 请求信息WxPayException - the wx pay exceptionString requestV3(String url, org.apache.http.client.methods.HttpRequestBase httpRequest) throws WxPayException
url - 请求地址httpRequest - 请求信息，可以是put，post，get，delete等请求WxPayException - the wx pay exceptionString getV3(String url) throws WxPayException
url - 请求地址WxPayException - the wx pay exceptionString getV3WithWechatPaySerial(String url) throws WxPayException
部分字段会包含敏感信息，所以在提交前需要在请求头中会包含"Wechatpay-Serial"信息
url - 请求地址WxPayException - the wx pay exceptionInputStream downloadV3(String url) throws WxPayException
url - 请求地址WxPayException - the wx pay exceptionString putV3(String url, String requestStr) throws WxPayException
url - 请求地址requestStr - 请求数据WxPayException - the wx pay exceptionString deleteV3(String url) throws WxPayException
url - 请求地址WxPayException - the wx pay exceptionWxEntrustPapService getWxEntrustPapService()
PartnerTransferService getPartnerTransferService()
PayrollService getPayrollService()
EntPayService getEntPayService()
RedpackService getRedpackService()
ProfitSharingService getProfitSharingService()
PayScoreService getPayScoreService()
EcommerceService getEcommerceService()
BusinessCircleService getBusinessCircleService()
MerchantMediaService getMerchantMediaService()
MarketingMediaService getMarketingMediaService()
MarketingFavorService getMarketingFavorService()
MarketingBusiFavorService getMarketingBusiFavorService()
MerchantTransferService getMerchantTransferService()
BrandMerchantTransferService getBrandMerchantTransferService()
void setEntPayService(EntPayService entPayService)
entPayService - the ent pay serviceWxPayOrderQueryResult queryOrder(String transactionId, String outTradeNo) throws WxPayException
查询订单. 详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2 该接口提供所有微信支付订单的查询，商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知； ◆ 调用支付接口后，返回系统错误或未知交易状态情况； ◆ 调用被扫支付API，返回USERPAYING的状态； ◆ 调用关单或撤销接口API之前，需确认支付状态； 接口地址：https://api.mch.weixin.qq.com/pay/orderquery
transactionId - 微信订单号outTradeNo - 商户系统内部的订单号，当没提供transactionId时需要传这个。WxPayException - the wx pay exceptionWxPayOrderQueryResult queryOrder(WxPayOrderQueryRequest request) throws WxPayException
查询订单（适合于需要自定义子商户号和子商户appid的情形）. 详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2 该接口提供所有微信支付订单的查询，商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知； ◆ 调用支付接口后，返回系统错误或未知交易状态情况； ◆ 调用被扫支付API，返回USERPAYING的状态； ◆ 调用关单或撤销接口API之前，需确认支付状态； 接口地址：https://api.mch.weixin.qq.com/pay/orderquery
request - 查询订单请求对象WxPayException - the wx pay exceptionWxPayOrderQueryV3Result queryOrderV3(String transactionId, String outTradeNo) throws WxPayException
查询订单 详见 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_2.shtml 商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询 注意： 查询订单可通过微信支付订单号和商户订单号两种方式查询，两种查询方式返回结果相同 需要调用查询接口的情况： ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知。 ◆ 调用支付接口后，返回系统错误或未知交易状态情况。 ◆ 调用付款码支付API，返回USERPAYING的状态。 ◆ 调用关单或撤销接口API之前，需确认支付状态。 接口地址： https://api.mch.weixin.qq.com/v3/pay/transactions/id/{transaction_id} https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/{out_trade_no}
transactionId - 微信订单号outTradeNo - 商户系统内部的订单号，当没提供transactionId时需要传这个。WxPayException - the wx pay exceptionWxPayOrderQueryV3Result queryOrderV3(WxPayOrderQueryV3Request request) throws WxPayException
查询订单 详见 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_2.shtml 商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询 注意： 查询订单可通过微信支付订单号和商户订单号两种方式查询，两种查询方式返回结果相同 需要调用查询接口的情况： ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知。 ◆ 调用支付接口后，返回系统错误或未知交易状态情况。 ◆ 调用付款码支付API，返回USERPAYING的状态。 ◆ 调用关单或撤销接口API之前，需确认支付状态。 接口地址： https://api.mch.weixin.qq.com/v3/pay/transactions/id/{transaction_id} https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/{out_trade_no}
request - 查询订单请求对象WxPayException - the wx pay exceptionWxPayPartnerOrderQueryV3Result queryPartnerOrderV3(String transactionId, String outTradeNo) throws WxPayException
服务商模式查询订单 详见 https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml 商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询 注意： 查询订单可通过微信支付订单号和商户订单号两种方式查询，两种查询方式返回结果相同 需要调用查询接口的情况： ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知。 ◆ 调用支付接口后，返回系统错误或未知交易状态情况。 ◆ 调用付款码支付API，返回USERPAYING的状态。 ◆ 调用关单或撤销接口API之前，需确认支付状态。 接口地址： https://api.mch.weixin.qq.com/v3/pay/partner/transactions/id/{transaction_id} https://api.mch.weixin.qq.com/v3/pay/partner/transactions/out-trade-no/{out_trade_no}
transactionId - 微信订单号outTradeNo - 商户系统内部的订单号，当没提供transactionId时需要传这个。WxPayException - the wx pay exceptionWxPayPartnerOrderQueryV3Result queryPartnerOrderV3(WxPayPartnerOrderQueryV3Request request) throws WxPayException
服务商模式查询订单 详见 https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml 商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询 注意： 查询订单可通过微信支付订单号和商户订单号两种方式查询，两种查询方式返回结果相同 需要调用查询接口的情况： ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知。 ◆ 调用支付接口后，返回系统错误或未知交易状态情况。 ◆ 调用付款码支付API，返回USERPAYING的状态。 ◆ 调用关单或撤销接口API之前，需确认支付状态。 接口地址： https://api.mch.weixin.qq.com/v3/pay/partner/transactions/id/{transaction_id} https://api.mch.weixin.qq.com/v3/pay/partner/transactions/out-trade-no/{out_trade_no}
request - 查询订单请求对象WxPayException - the wx pay exceptionCombineQueryResult queryCombine(String combineOutTradeNo) throws WxPayException
合单查询订单API
请求URL: https://api.mch.weixin.qq.com/v3/combine-transactions/out-trade-no/{combine_out_trade_no}
文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_11.shtml
combineOutTradeNo - 合单商户订单号WxPayException - the wx pay exceptionWxPayOrderCloseResult closeOrder(String outTradeNo) throws WxPayException
关闭订单. 应用场景 以下情况需要调用关单接口： 1. 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付； 2. 系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。 注意：订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。 接口地址：https://api.mch.weixin.qq.com/pay/closeorder 是否需要证书： 不需要。
outTradeNo - 商户系统内部的订单号WxPayException - the wx pay exceptionWxPayOrderCloseResult closeOrder(WxPayOrderCloseRequest request) throws WxPayException
关闭订单（适合于需要自定义子商户号和子商户appid的情形）. 应用场景 以下情况需要调用关单接口： 1. 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付； 2. 系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。 注意：订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。 接口地址：https://api.mch.weixin.qq.com/pay/closeorder 是否需要证书： 不需要。
request - 关闭订单请求对象WxPayException - the wx pay exceptionvoid closeOrderV3(String outTradeNo) throws WxPayException
关闭订单 应用场景 以下情况需要调用关单接口： 1、商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付； 2、系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。 注意：关单没有时间限制，建议在订单生成后间隔几分钟（最短5分钟）再调用关单接口，避免出现订单状态同步不及时导致关单失败。 接口地址：https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_3.shtml
outTradeNo - 商户系统内部的订单号WxPayException - the wx pay exceptionvoid closePartnerOrderV3(String outTradeNo) throws WxPayException
服务商关闭订单 应用场景 以下情况需要调用关单接口： 1、商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付； 2、系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。 注意：关单没有时间限制，建议在订单生成后间隔几分钟（最短5分钟）再调用关单接口，避免出现订单状态同步不及时导致关单失败。 接口地址：https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_3.shtml
outTradeNo - 商户系统内部的订单号WxPayException - the wx pay exceptionvoid closeOrderV3(WxPayOrderCloseV3Request request) throws WxPayException
关闭订单 应用场景 以下情况需要调用关单接口： 1、商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付； 2、系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。 注意：关单没有时间限制，建议在订单生成后间隔几分钟（最短5分钟）再调用关单接口，避免出现订单状态同步不及时导致关单失败。 接口地址：https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_3.shtml
request - 关闭订单请求对象WxPayException - the wx pay exceptionvoid closePartnerOrderV3(WxPayPartnerOrderCloseV3Request request) throws WxPayException
服务商关闭订单 应用场景 以下情况需要调用关单接口： 1、商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付； 2、系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。 注意：关单没有时间限制，建议在订单生成后间隔几分钟（最短5分钟）再调用关单接口，避免出现订单状态同步不及时导致关单失败。 接口地址：https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_3.shtml
request - 关闭订单请求对象WxPayException - the wx pay exceptionvoid closeCombine(CombineCloseRequest request) throws WxPayException
合单关闭订单API
请求URL: https://api.mch.weixin.qq.com/v3/combine-transactions/out-trade-no/{combine_out_trade_no}/close
文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_12.shtml
request - 请求对象WxPayException - the wx pay exception<T> T createOrder(WxPayUnifiedOrderRequest request) throws WxPayException
T - 请使用com.github.binarywang.wxpay.bean.order包下的类request - 统一下单请求参数com.github.binarywang.wxpay.bean.order包下的类对象WxPayException - the wx pay exception<T> T createOrder(WxPayConstants.TradeType.Specific<T> specificTradeType, WxPayUnifiedOrderRequest request) throws WxPayException
T - the type parameterspecificTradeType - 将使用的交易方式，不能为 nullrequest - 统一下单请求参数，设定的 tradeType 及配置里的 tradeType 将被忽略，转而使用 specificTradeTypeWxPayConstants.TradeType.Specific 指定的类WxPayException - the wx pay exceptionWxPayService#createOrder(WxPayUnifiedOrderRequest)WxPayService#createOrder(WxPayUnifiedOrderRequest)WxPayUnifiedOrderResult unifiedOrder(WxPayUnifiedOrderRequest request) throws WxPayException
request - 请求对象，注意一些参数如appid、mchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）WxPayException - the wx pay exception<T> T createOrderV3(TradeTypeEnum tradeType, WxPayUnifiedOrderV3Request request) throws WxPayException
T - 请使用WxPayUnifiedOrderV3Result里的内部类或字段tradeType - the trade typerequest - 统一下单请求参数WxPayUnifiedOrderV3Result里的内部类或字段WxPayException - the wx pay exception<T> T createPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException
T - 请使用WxPayUnifiedOrderV3Result里的内部类或字段tradeType - the trade typerequest - 统一下单请求参数WxPayUnifiedOrderV3Result里的内部类或字段WxPayException - the wx pay exceptionWxPayUnifiedOrderV3Result unifiedPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException
tradeType - the trade typerequest - 请求对象，注意一些参数如spAppid、spMchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）WxPayException - the wx pay exceptionWxPayUnifiedOrderV3Result unifiedOrderV3(TradeTypeEnum tradeType, WxPayUnifiedOrderV3Request request) throws WxPayException
tradeType - the trade typerequest - 请求对象，注意一些参数如appid、mchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）WxPayException - the wx pay exceptionCombineTransactionsResult combine(TradeTypeEnum tradeType, CombineTransactionsRequest request) throws WxPayException
合单支付API(APP支付、JSAPI支付、H5支付、NATIVE支付). 请求URL: https://api.mch.weixin.qq.com/v3/combine-transactions/app https://api.mch.weixin.qq.com/v3/combine-transactions/h5 https://api.mch.weixin.qq.com/v3/combine-transactions/jsapi https://api.mch.weixin.qq.com/v3/combine-transactions/native 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter2_9_3.shtml
tradeType - 支付方式request - 请求对象WxPayException - the wx pay exception<T> T combineTransactions(TradeTypeEnum tradeType, CombineTransactionsRequest request) throws WxPayException
合单支付API(APP支付、JSAPI支付、H5支付、NATIVE支付). 请求URL: https://api.mch.weixin.qq.com/v3/combine-transactions/app https://api.mch.weixin.qq.com/v3/combine-transactions/h5 https://api.mch.weixin.qq.com/v3/combine-transactions/jsapi https://api.mch.weixin.qq.com/v3/combine-transactions/native 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter2_9_3.shtml
T - the type parametertradeType - 支付方式request - 请求对象WxPayException - the wx pay exception@Deprecated Map<String,String> getPayInfo(WxPayUnifiedOrderRequest request) throws WxPayException
createOrder(WxPayUnifiedOrderRequest)request - 请求对象，注意一些参数如appid、mchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）WxPayException - the wx pay exceptionWxPayConfig getConfig()
void setConfig(WxPayConfig config)
config - the configWxPayRefundResult refund(WxPayRefundRequest request) throws WxPayException
微信支付-申请退款. 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4 接口链接：https://api.mch.weixin.qq.com/secapi/pay/refund
request - 请求对象WxPayException - the wx pay exceptionWxPayRefundResult refundV2(WxPayRefundRequest request) throws WxPayException
申请退款API（支持单品）. 详见 https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9_103&index=3 应用场景 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。 注意： 1、交易时间超过一年的订单无法提交退款； 2、微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号。 3、请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次 错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款申请请求不超过6次 4、每个支付订单的部分退款次数不能超过50次 5、本接口支持单品优惠订单全额退款和单品优惠订单部分退款，推荐使用本接口，如果使用不支持单品优惠部分退款的历史接口，请看https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=9_4 接口地址 https://api.mch.weixin.qq.com/secapi/pay/refundv2 https://api2.mch.weixin.qq.com/secapi/pay/refundv2(备用域名)见跨城冗灾方案
request - 请求对象WxPayException - the wx pay exceptionWxPayRefundV3Result refundV3(WxPayRefundV3Request request) throws WxPayException
申请退款API（支持单品）. 详见 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_9.shtml 应用场景 当交易发生之后一年内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付金额退还给买家，微信支付将在收到退款请求并且验证成功之后，将支付款按原路退还至买家账号上。 注意： 1、交易时间超过一年的订单无法提交退款 2、微信支付退款支持单笔交易分多次退款（不超50次），多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号 3、错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款申请请求不超过6次 4、每个支付订单的部分退款次数不能超过50次 5、如果同一个用户有多笔退款，建议分不同批次进行退款，避免并发退款导致退款失败 6、申请退款接口的返回仅代表业务的受理情况，具体退款是否成功，需要通过退款查询接口获取结果 7、一个月之前的订单申请退款频率限制为：5000/min 接口地址 https://api.mch.weixin.qq.com/v3/refund/domestic/refunds
request - 请求对象WxPayException - the wx pay exceptionWxPayRefundQueryResult refundQuery(String transactionId, String outTradeNo, String outRefundNo, String refundId) throws WxPayException
微信支付-查询退款. 应用场景： 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账， 银行卡支付的退款3个工作日后重新查询退款状态。 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_5 接口链接：https://api.mch.weixin.qq.com/pay/refundquery以下四个参数四选一
transactionId - 微信订单号outTradeNo - 商户订单号outRefundNo - 商户退款单号refundId - 微信退款单号WxPayException - the wx pay exceptionWxPayRefundQueryResult refundQuery(WxPayRefundQueryRequest request) throws WxPayException
微信支付-查询退款（适合于需要自定义子商户号和子商户appid的情形）. 应用场景： 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账， 银行卡支付的退款3个工作日后重新查询退款状态。 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_5 接口链接：https://api.mch.weixin.qq.com/pay/refundquery
request - 微信退款单号WxPayException - the wx pay exceptionWxPayRefundQueryResult refundQueryV2(WxPayRefundQueryRequest request) throws WxPayException
微信支付-查询退款API（支持单品）.
应用场景
提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。
注意：
1、本接口支持查询单品优惠相关退款信息，且仅支持按微信退款单号或商户退款单号查询，若继续调用老查询退款接口，
请见https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=9_5
2、请求频率限制：300qps，即每秒钟正常的退款查询请求次数不超过300次
3、错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款查询请求不超过6次
接口地址
https://api.mch.weixin.qq.com/pay/refundqueryv2
https://api2.mch.weixin.qq.com/pay/refundqueryv2(备用域名)见跨城冗灾方案
详见 https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9_104&index=4
request - 微信退款单号WxPayException - the wx pay exceptionWxPayRefundQueryV3Result refundQueryV3(String outRefundNo) throws WxPayException
微信支付-查询退款 应用场景： 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，建议在提交退款申请后1分钟发起查询退款状态，一般来说零钱支付的退款5分钟内到账，银行卡支付的退款1-3个工作日到账。 详见 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_10.shtml 接口链接：https://api.mch.weixin.qq.com/v3/refund/domestic/refunds/{out_refund_no}
outRefundNo - 商户退款单号WxPayException - the wx pay exceptionWxPayRefundQueryV3Result refundQueryV3(WxPayRefundQueryV3Request request) throws WxPayException
微信支付-查询退款-直连商户 应用场景： 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，建议在提交退款申请后1分钟发起查询退款状态，一般来说零钱支付的退款5分钟内到账，银行卡支付的退款1-3个工作日到账。 详见 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_10.shtml 接口链接：https://api.mch.weixin.qq.com/v3/refund/domestic/refunds/{out_refund_no}
request - 微信退款单号WxPayException - the wx pay exceptionWxPayRefundQueryV3Result refundPartnerQueryV3(WxPayRefundQueryV3Request request) throws WxPayException
微信支付-查询退款-服务商 应用场景： 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，建议在提交退款申请后1分钟发起查询退款状态，一般来说零钱支付的退款5分钟内到账，银行卡支付的退款1-3个工作日到账。 详见 https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_10.shtml 接口链接：https://api.mch.weixin.qq.com/v3/refund/domestic/refunds/{out_refund_no}?sub_mchid={sub_mchid}
request - 微信退款单号WxPayException - the wx pay exceptionWxPayOrderNotifyResult parseOrderNotifyResult(String xmlData) throws WxPayException
xmlData - the xml dataWxPayException - the wx pay exceptionWxPayOrderNotifyResult parseOrderNotifyResult(String xmlData, String signType) throws WxPayException
xmlData - the xml datasignType - 签名类型WxPayException - the wx pay exceptionWxPayNotifyV3Result parseOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException
notifyData - 通知数据header - 通知头部数据，不传则表示不校验头WxPayException - the wx pay exceptionWxPayPartnerNotifyV3Result parsePartnerOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException
notifyData - 通知数据header - 通知头部数据，不传则表示不校验头WxPayException - the wx pay exception<T extends WxPayBaseNotifyV3Result<E>,E> T baseParseOrderNotifyV3Result(String notifyData, SignatureHeader header, Class<T> resultType, Class<E> dataType) throws WxPayException
notifyData - 通知数据header - 通知头部数据，不传则表示不校验头resultType - 结果类型dataType - 结果数据类型WxPayException - the wx pay exceptionCombineNotifyResult parseCombineNotifyResult(String notifyData, SignatureHeader header) throws WxPayException
合单支付通知回调数据处理 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_13.shtml
notifyData - 通知数据header - 通知头部数据，不传则表示不校验头WxPayException - the wx pay exceptionWxPayRefundNotifyResult parseRefundNotifyResult(String xmlData) throws WxPayException
xmlData - the xml dataWxPayException - the wx pay exceptionWxPayRefundNotifyV3Result parseRefundNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException
notifyData - 通知数据header - 通知头部数据，不传则表示不校验头WxPayException - the wx pay exceptionWxPayPartnerRefundNotifyV3Result parsePartnerRefundNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException
notifyData - 通知数据header - 通知头部数据，不传则表示不校验头WxPayException - the wx pay exceptionWxScanPayNotifyResult parseScanPayNotifyResult(String xmlData, String signType) throws WxPayException
xmlData - the xml datasignType - 签名类型WxPayException - the wx pay exceptionWxScanPayNotifyResult parseScanPayNotifyResult(String xmlData) throws WxPayException
xmlData - the xml dataWxPayException - the wx pay exceptionbyte[] createScanPayQrcodeMode1(String productId, File logoFile, Integer sideLength) throws Exception
扫码支付模式一生成二维码的方法。 二维码中的内容为链接，形式为： weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX 其中XXXXX为商户需要填写的内容，商户将该链接生成二维码，如需要打印发布二维码，需要采用此格式。商户可调用第三方库生成二维码图片。 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4
productId - 产品IdlogoFile - 商户logo图片的文件对象，可以为空sideLength - 要生成的二维码的边长，如果为空，则取默认值400ExceptionString createScanPayQrcodeMode1(String productId)
扫码支付模式一生成二维码的方法. 二维码中的内容为链接，形式为： weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX 其中XXXXX为商户需要填写的内容，商户将该链接生成二维码，如需要打印发布二维码，需要采用此格式。商户可调用第三方库生成二维码图片。 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4
productId - 产品Idbyte[] createScanPayQrcodeMode2(String codeUrl, File logoFile, Integer sideLength) throws Exception
扫码支付模式二生成二维码的方法. 对应链接格式：weixin：//wxpay/bizpayurl?sr=XXXXX。请商户调用第三方库将code_url生成二维码图片。 该模式链接较短，生成的二维码打印到结账小票上的识别率较高。 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_5
codeUrl - 微信返回的交易会话的二维码链接logoFile - 商户logo图片的文件对象，可以为空sideLength - 要生成的二维码的边长，如果为空，则取默认值400Exceptionvoid report(WxPayReportRequest request) throws WxPayException
交易保障. 应用场景： 商户在调用微信支付提供的相关接口时，会得到微信支付返回的相关信息以及获得整个接口的响应时间。 为提高整体的服务水平，协助商户一起提高服务质量，微信支付提供了相关接口调用耗时和返回信息的主动上报接口， 微信支付可以根据商户侧上报的数据进一步优化网络部署，完善服务监控，和商户更好的协作为用户提供更好的业务体验。 接口地址： https://api.mch.weixin.qq.com/payitil/report 是否需要证书：不需要
request - the requestWxPayException - the wx pay exceptionString downloadRawBill(String billDate, String billType, String tarType, String deviceInfo) throws WxPayException
下载对账单. 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。 注意： 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致，bill_type为REVOKED； 2、微信在次日9点启动生成前一天的对账单，建议商户10点后再获取； 3、对账单中涉及金额的字段单位为“元”。 4、对账单接口只能下载三个月以内的账单。 接口链接：https://api.mch.weixin.qq.com/pay/downloadbill 详情请见: 下载对账单
billDate - 对账单日期 bill_date 下载对账单的日期，格式：20140603billType - 账单类型 bill_type ALL，返回当日所有订单信息，默认值，SUCCESS，返回当日成功支付的订单，REFUND，返回当日退款订单tarType - 压缩账单 tar_type 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。deviceInfo - 设备号 device_info 非必传参数，终端设备号WxPayException - the wx pay exceptionString downloadRawBill(WxPayDownloadBillRequest request) throws WxPayException
下载对账单（适合于需要自定义子商户号和子商户appid的情形）. 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。 注意： 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致，bill_type为REVOKED； 2、微信在次日9点启动生成前一天的对账单，建议商户10点后再获取； 3、对账单中涉及金额的字段单位为“元”。 4、对账单接口只能下载三个月以内的账单。 接口链接：https://api.mch.weixin.qq.com/pay/downloadbill 详情请见: 下载对账单
request - 下载对账单请求WxPayException - the wx pay exceptionWxPayBillResult downloadBill(String billDate, String billType, String tarType, String deviceInfo) throws WxPayException
下载对账单. 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。 注意： 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致，bill_type为REVOKED； 2、微信在次日9点启动生成前一天的对账单，建议商户10点后再获取； 3、对账单中涉及金额的字段单位为“元”。 4、对账单接口只能下载三个月以内的账单。 接口链接：https://api.mch.weixin.qq.com/pay/downloadbill 详情请见: 下载对账单
billDate - 对账单日期 bill_date 下载对账单的日期，格式：20140603billType - 账单类型 bill_type ALL，返回当日所有订单信息，默认值，SUCCESS，返回当日成功支付的订单，REFUND，返回当日退款订单tarType - 压缩账单 tar_type 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。deviceInfo - 设备号 device_info 非必传参数，终端设备号WxPayException - the wx pay exceptionWxPayBillResult downloadBill(WxPayDownloadBillRequest request) throws WxPayException
下载对账单（适合于需要自定义子商户号和子商户appid的情形）. 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。 注意： 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致，bill_type为REVOKED； 2、微信在次日9点启动生成前一天的对账单，建议商户10点后再获取； 3、对账单中涉及金额的字段单位为“元”。 4、对账单接口只能下载三个月以内的账单。 接口链接：https://api.mch.weixin.qq.com/pay/downloadbill 详情请见: 下载对账单
request - 下载对账单请求WxPayException - the wx pay exceptionWxPayFundFlowResult downloadFundFlow(String billDate, String accountType, String tarType) throws WxPayException
下载资金账单. 商户可以通过该接口下载自2017年6月1日起 的历史资金流水账单。 注意： 1、资金账单中的数据反映的是商户微信账户资金变动情况； 2、当日账单在次日上午9点开始生成，建议商户在上午10点以后获取； 3、资金账单中涉及金额的字段单位为“元”。 接口链接：https://api.mch.weixin.qq.com/pay/downloadfundflow 详情请见: 下载对账单
billDate - 资金账单日期 bill_date 下载对账单的日期，格式：20140603accountType - 资金账户类型 account_type Basic，基本账户，Operation，运营账户，Fees，手续费账户tarType - 压缩账单 tar_type 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。WxPayException - the wx pay exceptionWxPayFundFlowResult downloadFundFlow(WxPayDownloadFundFlowRequest request) throws WxPayException
下载资金账单. 商户可以通过该接口下载自2017年6月1日起 的历史资金流水账单。 注意： 1、资金账单中的数据反映的是商户微信账户资金变动情况； 2、当日账单在次日上午9点开始生成，建议商户在上午10点以后获取； 3、资金账单中涉及金额的字段单位为“元”。 接口链接：https://api.mch.weixin.qq.com/pay/downloadfundflow 详情请见: 下载对账单
request - 下载资金流水请求WxPayException - the wx pay exceptionWxPayApplyBillV3Result applyTradeBill(WxPayApplyTradeBillV3Request request) throws WxPayException
申请交易账单API 微信支付按天提供交易账单文件，商户可以通过该接口获取账单文件的下载地址。文件内包含交易相关的金额、时间、营销等信息，供商户核对订单、退款、银行到账等情况。 注意： • 微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致； • 对账单中涉及金额的字段单位为“元”； • 对账单接口只能下载三个月以内的账单。 接口链接：https://api.mch.weixin.qq.com/v3/bill/tradebill 详情请见: 申请交易账单
request - 申请账单请求WxPayException - the wx pay exceptionWxPayApplyBillV3Result applyFundFlowBill(WxPayApplyFundFlowBillV3Request request) throws WxPayException
申请资金账单API 微信支付按天提供微信支付账户的资金流水账单文件，商户可以通过该接口获取账单文件的下载地址。文件内包含该账户资金操作相关的业务单号、收支金额、记账时间等信息，供商户进行核对。 注意： • 资金账单中的数据反映的是商户微信支付账户资金变动情况； • 对账单中涉及金额的字段单位为“元”。 接口链接：https://api.mch.weixin.qq.com/v3/bill/fundflowbill 详情请见: 申请资金账单
request - 申请账单请求WxPayException - the wx pay exceptionInputStream downloadBill(String url) throws WxPayException
下载账单API 下载账单API为通用接口，交易/资金账单都可以通过该接口获取到对应的账单。 注意： • 账单文件的下载地址的有效时间为30s。 • 强烈建议商户将实际账单文件的哈希值和之前从接口获取到的哈希值进行比对，以确认数据的完整性。 • 该接口响应的信息请求头中不包含微信接口响应的签名值，因此需要跳过验签的流程 接口链接：通过申请账单接口获取到“download_url”，URL有效期30s 详情请见: 下载账单
url - 微信返回的账单地址。WxPayException - the wx pay exceptionWxPayMicropayResult micropay(WxPayMicropayRequest request) throws WxPayException
提交付款码支付. 文档地址：https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_10&index=1 应用场景： 收银员使用扫码设备读取微信用户刷卡授权码以后，二维码或条码信息传送至商户收银台，由商户收银台或者商户后台调用该接口发起支付。 提醒1：提交支付请求后微信会同步返回支付结果。当返回结果为“系统错误”时，商户系统等待5秒后调用【查询订单API】，查询支付实际交易结果；当返回结果为“USERPAYING”时，商户系统可设置间隔时间(建议10秒)重新查询支付结果，直到支付成功或超时(建议30秒)； 提醒2：在调用查询接口返回后，如果交易状况不明晰，请调用【撤销订单API】，此时如果交易失败则关闭订单，该单不能再支付成功；如果交易成功，则将扣款退回到用户账户。当撤销无返回或错误时，请再次调用。注意：请勿扣款后立即调用【撤销订单API】,建议至少15秒后再调用。撤销订单API需要双向证书。 接口地址： https://api.mch.weixin.qq.com/pay/micropay 是否需要证书：不需要。
request - the requestWxPayException - the wx pay exceptionWxPayOrderReverseResult reverseOrder(WxPayOrderReverseRequest request) throws WxPayException
撤销订单API. 文档地址：https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_11&index=3 应用场景： 支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，微信支付系统会将此订单关闭； 如果用户支付成功，微信支付系统会将此订单资金退还给用户。 注意：7天以内的交易单可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。 提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】。 调用支付接口后请勿立即调用撤销订单API，建议支付后至少15s后再调用撤销订单接口。 接口链接 ：https://api.mch.weixin.qq.com/secapi/pay/reverse 是否需要证书：请求需要双向证书。
request - the requestWxPayException - the wx pay exceptionString shorturl(WxPayShorturlRequest request) throws WxPayException
转换短链接.
文档地址：
https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_9&index=8
应用场景：
该接口主要用于扫码原生支付模式一中的二维码链接转成短链接(weixin://wxpay/s/XXXXXX)，减小二维码数据量，提升扫描速度和精确度。
接口地址：https://api.mch.weixin.qq.com/tools/shorturl
是否需要证书：否
request - 请求对象WxPayException - the wx pay exceptionString shorturl(String longUrl) throws WxPayException
转换短链接.
longUrl - 需要被压缩的网址WxPayException - the wx pay exceptionWxPayService#shorturl(WxPayShorturlRequest)WxPayService#shorturl(WxPayShorturlRequest)WxPayService#shorturl(WxPayShorturlRequest)String authcode2Openid(WxPayAuthcode2OpenidRequest request) throws WxPayException
授权码查询OPENID接口.
通过授权码查询公众号Openid，调用查询后，该授权码只能由此商户号发起扣款，直至授权码更新。
文档地址：
https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_13&index=9
接口链接:
https://api.mch.weixin.qq.com/tools/authcodetoopenid
request - 请求对象WxPayException - the wx pay exceptionString authcode2Openid(String authCode) throws WxPayException
授权码查询OPENID接口.
authCode - 授权码WxPayException - the wx pay exceptionWxPayService#authcode2Openid(WxPayAuthcode2OpenidRequest)WxPayService#authcode2Openid(WxPayAuthcode2OpenidRequest)WxPayService#authcode2Openid(WxPayAuthcode2OpenidRequest)String getSandboxSignKey() throws WxPayException
获取仿真测试系统的验签密钥. 请求Url： https://api.mch.weixin.qq.com/xdc/apiv2getsignkey/sign/getsignkey 是否需要证书： 否 请求方式： POST 文档地址：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=23_1
WxPayException - the wx pay exceptionWxPayCouponSendResult sendCoupon(WxPayCouponSendRequest request) throws WxPayException
发放代金券 接口请求链接：https://api.mch.weixin.qq.com/mmpaymkttransfers/send_coupon 是否需要证书：请求需要双向证书。 文档地址：https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_3
request - the requestWxPayException - the wx pay exceptionWxPayCouponStockQueryResult queryCouponStock(WxPayCouponStockQueryRequest request) throws WxPayException
查询代金券批次. 接口请求链接：https://api.mch.weixin.qq.com/mmpaymkttransfers/query_coupon_stock 文档地址：https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_4
request - the requestWxPayException - the wx pay exceptionWxPayCouponInfoQueryResult queryCouponInfo(WxPayCouponInfoQueryRequest request) throws WxPayException
查询代金券信息. 接口请求链接：https://api.mch.weixin.qq.com/mmpaymkttransfers/querycouponsinfo 文档地址：https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_5
request - the requestWxPayException - the wx pay exceptionWxPayApiData getWxApiData()
String queryComment(Date beginDate, Date endDate, Integer offset, Integer limit) throws WxPayException
拉取订单评价数据. 商户可以通过该接口拉取用户在微信支付交易记录中针对你的支付记录进行的评价内容。商户可结合商户系统逻辑对该内容数据进行存储、分析、展示、客服回访以及其他使用。如商户业务对评价内容有依赖，可主动引导用户进入微信支付交易记录进行评价。 注意： 1. 该内容所有权为提供内容的微信用户，商户在使用内容的过程中应遵从用户意愿 2. 一次最多拉取200条评价数据，可根据时间区间分批次拉取 3. 接口只能拉取最近三个月以内的评价数据 接口链接：https://api.mch.weixin.qq.com/billcommentsp/batchquerycomment 是否需要证书：需要 文档地址：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_17&index=10
beginDate - 开始时间endDate - 结束时间offset - 位移limit - 条数，建议填null，否则接口会报签名错误WxPayException - the wx pay exceptionString queryComment(WxPayQueryCommentRequest request) throws WxPayException
拉取订单评价数据. 商户可以通过该接口拉取用户在微信支付交易记录中针对你的支付记录进行的评价内容。商户可结合商户系统逻辑对该内容数据进行存储、分析、展示、客服回访以及其他使用。如商户业务对评价内容有依赖，可主动引导用户进入微信支付交易记录进行评价。 注意： 1. 该内容所有权为提供内容的微信用户，商户在使用内容的过程中应遵从用户意愿 2. 一次最多拉取200条评价数据，可根据时间区间分批次拉取 3. 接口只能拉取最近三个月以内的评价数据 接口链接：https://api.mch.weixin.qq.com/billcommentsp/batchquerycomment 是否需要证书：需要 文档地址：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_17&index=10
request - 查询请求WxPayException - the wx pay exceptionWxPayFaceAuthInfoResult getWxPayFaceAuthInfo(WxPayFaceAuthInfoRequest request) throws WxPayException
获取微信刷脸支付凭证. 接口请求链接：https://payapp.weixin.qq.com/face/get_wxpayface_authinfo 文档地址：https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_5
request - the requestWxPayException - the wx pay exceptionWxPayFacepayResult facepay(WxPayFacepayRequest request) throws WxPayException
提交刷脸支付. 文档地址：https://share.weiyun.com/5dxUgCw 应用场景： 用户在商超，便利店，餐饮等场景，在屏幕上通过刷脸完成支付。 步骤1：用户在自助收银机上点击“刷脸支付”； 步骤2：发起人脸识别，摄像头自动抓取识别用户人脸，提示用户输入11位手机号码； 步骤3：商户收银系统提交刷脸支付； 步骤4：微信支付后台收到支付请求，验证人脸信息，返回支付结果给商户收银系统。 是否需要证书：不需要。
request - the requestWxPayException - the wx pay exceptionWxPayQueryExchangeRateResult queryExchangeRate(String feeType, String date) throws WxPayException
应用场景：商户网站的商品以外币标价时，通过该接口可以实时查询到微信使用的转换汇率。汇率更新时间为北京时间上午10:00，一天更新一次。 文档地址：https://pay.weixin.qq.com/wiki/doc/api/app/app_jw.php?chapter=9_15&index=12 接口链接：https://api.mch.weixin.qq.com/pay/queryexchagerate
feeType - 外币币种date - 日期，格式为yyyyMMdd，如2009年12月25日表示为20091225。时区为GMT+8 beijingWxPayException - .ComplaintNotifyResult parseComplaintNotifyResult(String notifyData, SignatureHeader header) throws WxPayException
notifyData - 通知数据header - 通知头部数据，不传则表示不校验头WxPayException - the wx pay exceptionComplaintService getComplaintsService()
BankService getBankService()
TransferService getTransferService()
PartnerPayScoreService getPartnerPayScoreService()
PartnerPayScoreSignPlanService getPartnerPayScoreSignPlanService()
Copyright © 2023. All rights reserved.