me.chanjar.weixin.mp.api

接口 WxMpPayService

所有已知实现类:

WxMpPayServiceImpl

public interface WxMpPayService

微信支付相关接口 Created by Binary Wang on 2016/7/28.

作者:

binarywang (https://github.com/binarywang)

方法概要

方法

限定符和类型	方法和说明
boolean	checkJSSDKCallbackDataSignature(Map<String,String> kvm, String signature) 计算Map键值对是否和签名相符, 按照字段名的 ASCII 码从小到大排序(字典序)后,使用 URL 键值对的 格式(即 key1=value1&key2=value2...)拼接成字符串
WxPayOrderCloseResult	closeOrder(String outTradeNo) 关闭订单 应用场景 以下情况需要调用关单接口： 1.
WxEntPayResult	entPay(WxEntPayRequest request, File keyFile) 企业付款业务是基于微信支付商户平台的资金管理能力，为了协助商户方便地实现企业向个人付款，针对部分有开发能力的商户，提供通过API完成企业付款的功能。
WxPayJsSDKCallback	getJSSDKCallbackData(String xmlData) 读取支付结果通知 详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?
Map<String,String>	getPayInfo(WxPayUnifiedOrderRequest request) 该接口调用“统一下单”接口，并拼装发起支付请求需要的参数 详见http://mp.weixin.qq.com/wiki?
WxEntPayQueryResult	queryEntPay(String partnerTradeNo, File keyFile) 查询企业付款API 用于商户的企业付款操作进行结果查询，返回付款操作详细结果。
WxPayOrderQueryResult	queryOrder(String transactionId, String outTradeNo) 查询订单(详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?
WxPayRefundResult	refund(WxPayRefundRequest request, File keyFile) 微信支付-申请退款 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?
WxPaySendRedpackResult	sendRedpack(WxPaySendRedpackRequest request, File keyFile) 发送微信红包给个人用户 文档详见: 发送普通红包 https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?
WxPayUnifiedOrderResult	unifiedOrder(WxPayUnifiedOrderRequest request) 统一下单(详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?

方法详细资料

queryOrder

WxPayOrderQueryResult queryOrder(String transactionId,
                               String outTradeNo)
                                 throws WxErrorException

 查询订单(详见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 - 商户系统内部的订单号，当没提供transaction_id时需要传这个。

抛出:

WxErrorException

closeOrder

WxPayOrderCloseResult closeOrder(String outTradeNo)
                                 throws WxErrorException

 关闭订单
 应用场景
 以下情况需要调用关单接口：
 1. 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；
 2. 系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。
 注意：订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。
 接口地址：https://api.mch.weixin.qq.com/pay/closeorder
 是否需要证书：   不需要。
 

参数:

outTradeNo - 商户系统内部的订单号，当没提供transaction_id时需要传这个。

抛出:

WxErrorException

unifiedOrder

WxPayUnifiedOrderResult unifiedOrder(WxPayUnifiedOrderRequest request)
                                     throws WxErrorException

统一下单(详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1) 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识" 接口地址：https://api.mch.weixin.qq.com/pay/unifiedorder

参数:

request - 请求对象

抛出:

WxErrorException

getPayInfo

Map<String,String> getPayInfo(WxPayUnifiedOrderRequest request)
                              throws WxErrorException

该接口调用“统一下单”接口，并拼装发起支付请求需要的参数 详见http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115&token=&lang=zh_CN

参数:

request - 请求对象

抛出:

WxErrorException

refund

WxPayRefundResult refund(WxPayRefundRequest request,
                       File keyFile)
                         throws WxErrorException

 微信支付-申请退款
 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4
 接口链接：https://api.mch.weixin.qq.com/secapi/pay/refund
 

参数:

request - 请求对象

keyFile - 证书文件对象

返回:

退款操作结果

抛出:

WxErrorException

getJSSDKCallbackData

WxPayJsSDKCallback getJSSDKCallbackData(String xmlData)
                                        throws WxErrorException

读取支付结果通知 详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_7

抛出:

WxErrorException

checkJSSDKCallbackDataSignature

boolean checkJSSDKCallbackDataSignature(Map<String,String> kvm,
                                      String signature)

 计算Map键值对是否和签名相符,
 按照字段名的 ASCII 码从小到大排序(字典序)后,使用 URL 键值对的 格式(即 key1=value1&key2=value2...)拼接成字符串
 

sendRedpack

WxPaySendRedpackResult sendRedpack(WxPaySendRedpackRequest request,
                                 File keyFile)
                                   throws WxErrorException

发送微信红包给个人用户

 文档详见:
 发送普通红包 https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3
 发送裂变红包 https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_5&index=4
 

参数:

request - 请求对象

keyFile - 证书文件对象

抛出:

WxErrorException

entPay

WxEntPayResult entPay(WxEntPayRequest request,
                    File keyFile)
                      throws WxErrorException

 企业付款业务是基于微信支付商户平台的资金管理能力，为了协助商户方便地实现企业向个人付款，针对部分有开发能力的商户，提供通过API完成企业付款的功能。
 比如目前的保险行业向客户退保、给付、理赔。
 企业付款将使用商户的可用余额，需确保可用余额充足。查看可用余额、充值、提现请登录商户平台“资金管理”https://pay.weixin.qq.com/进行操作。
 注意：与商户微信支付收款资金并非同一账户，需要单独充值。
 文档详见:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_2
 接口链接：https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers
 

参数:

request - 请求对象

keyFile - 证书文件对象

抛出:

WxErrorException

queryEntPay

WxEntPayQueryResult queryEntPay(String partnerTradeNo,
                              File keyFile)
                                throws WxErrorException

 查询企业付款API
 用于商户的企业付款操作进行结果查询，返回付款操作详细结果。
 文档详见:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_3
 接口链接：https://api.mch.weixin.qq.com/mmpaymkttransfers/gettransferinfo
 

参数:

partnerTradeNo - 商户订单号

keyFile - 证书文件对象

抛出:

WxErrorException