com.github.binarywang.wxpay.service.impl

类 ProfitSharingV3ServiceImpl

java.lang.Object

com.github.binarywang.wxpay.service.impl.ProfitSharingV3ServiceImpl

所有已实现的接口:

ProfitSharingV3Service

public class ProfitSharingV3ServiceImpl
extends Object
implements ProfitSharingV3Service

微信支付V3-资金应用-分账Service

版本:

1.0

作者:

pg 2021-6-23

构造器概要

构造器

构造器和说明
ProfitSharingV3ServiceImpl()

方法概要

限定符和类型	方法和说明
ProfitSharingReceiver	addProfitSharingReceiver(ProfitSharingReceiver request) 添加分账接收方API 商户发起添加分账接收方请求，建立分账接收方列表。
ProfitSharingReceiver	deleteProfitSharingReceiver(ProfitSharingReceiver request) 删除分账接收方API 商户发起删除分账接收方请求。
ProfitSharingNotifyData	getProfitSharingNotifyData(String notifyData, SignatureHeader header) 分账动账通知 分账或分账回退成功后，微信会把相关变动结果发送给分账接收方（只支持商户）。
ProfitSharingResult	getProfitSharingResult(String outOrderNo, String transactionId) 查询分账结果API 发起分账请求后，可调用此接口查询分账结果 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_2.shtml 接口链接：https://api.mch.weixin.qq.com/v3/profitsharing/orders/{out_order_no} 注意： • 发起解冻剩余资金请求后，可调用此接口查询解冻剩余资金的结果
ProfitSharingReturnResult	getProfitSharingReturnResult(String outOrderNo, String outReturnNo) 查询分账回退结果API 商户需要核实回退结果，可调用此接口查询回退结果 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_4.shtml 接口链接：https://api.mch.weixin.qq.com/v3/profitsharing/return-orders/{out_return_no} 注意： • 如果分账回退接口返回状态为处理中，可调用此接口查询回退结果
ProfitSharingUnsplitResult	getProfitSharingUnsplitAmount(String transactionId) 查询剩余待分金额API 可调用此接口查询订单剩余待分金额 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_6.shtml 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/transactions/{transaction_id}/amounts
ProfitSharingResult	profitSharing(ProfitSharingRequest request) 请求分账API 微信订单支付成功后，商户发起分账请求，将结算后的资金分到分账接收方 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_1.shtml 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/orders 注意： 对同一笔订单最多能发起20次分账请求，每次请求最多分给50个接收方 此接口采用异步处理模式，即在接收到商户请求后，优先受理请求再异步处理，最终的分账结果可以通过查询分账接口获取
ProfitSharingReturnResult	profitSharingReturn(ProfitSharingReturnRequest request) 请求分账回退API 如果订单已经分账，在退款时，可以先调此接口，将已分账的资金从分账接收方的账户回退给分账方，再发起退款 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_3.shtml 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/return-orders 注意： • 分账回退以原分账单为依据，支持多次回退，申请回退总金额不能超过原分账单分给该接收方的金额 • 此接口采用同步处理模式，即在接收到商户请求后，会实时返回处理结果 • 对同一笔分账单最多能发起20次分账回退请求 • 退款和分账回退没有耦合，分账回退可以先于退款请求，也可以后于退款请求 • 此功能需要接收方在商户平台-交易中心-分账-分账接收设置下，开启同意分账回退后，才能使用
ProfitSharingUnfreezeResult	profitSharingUnfreeze(ProfitSharingUnfreezeRequest request) 解冻剩余资金API 不需要进行分账的订单，可直接调用本接口将订单的金额全部解冻给特约商户 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_5.shtml 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/orders/unfreeze 注意： • 调用分账接口后，需要解冻剩余资金时，调用本接口将剩余的分账金额全部解冻给特约商户 • 此接口采用异步处理模式，即在接收到商户请求后，优先受理请求再异步处理，最终的分账结果可以通过查询分账接口获取

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ProfitSharingV3ServiceImpl

public ProfitSharingV3ServiceImpl()

方法详细资料

profitSharing

public ProfitSharingResult profitSharing(ProfitSharingRequest request)
                                  throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 请求分账API

 微信订单支付成功后，商户发起分账请求，将结算后的资金分到分账接收方
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_1.shtml
 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/orders

 注意：
 对同一笔订单最多能发起20次分账请求，每次请求最多分给50个接收方
 此接口采用异步处理模式，即在接收到商户请求后，优先受理请求再异步处理，最终的分账结果可以通过查询分账接口获取
 

指定者:

profitSharing 在接口中 ProfitSharingV3Service

参数:

request - ProfitSharingRequest 针对某一笔支付订单的分账方法

返回:

ProfitSharingResult 微信返回的分账结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

getProfitSharingResult

public ProfitSharingResult getProfitSharingResult(String outOrderNo,
                                                  String transactionId)
                                           throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 查询分账结果API

 发起分账请求后，可调用此接口查询分账结果
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_2.shtml
 接口链接：https://api.mch.weixin.qq.com/v3/profitsharing/orders/{out_order_no}

 注意：
 • 发起解冻剩余资金请求后，可调用此接口查询解冻剩余资金的结果
 

指定者:

getProfitSharingResult 在接口中 ProfitSharingV3Service

参数:

outOrderNo - 商户系统内部的分账单号，在商户系统内部唯一，同一分账单号多次请求等同一次。只能是数字、大小写字母_-|*@ 。

transactionId - 微信支付订单号

返回:

ProfitSharingResult 微信返回的分账结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

profitSharingReturn

public ProfitSharingReturnResult profitSharingReturn(ProfitSharingReturnRequest request)
                                              throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 请求分账回退API

 如果订单已经分账，在退款时，可以先调此接口，将已分账的资金从分账接收方的账户回退给分账方，再发起退款
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_3.shtml
 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/return-orders

 注意：
 • 分账回退以原分账单为依据，支持多次回退，申请回退总金额不能超过原分账单分给该接收方的金额
 • 此接口采用同步处理模式，即在接收到商户请求后，会实时返回处理结果
 • 对同一笔分账单最多能发起20次分账回退请求
 • 退款和分账回退没有耦合，分账回退可以先于退款请求，也可以后于退款请求
 • 此功能需要接收方在商户平台-交易中心-分账-分账接收设置下，开启同意分账回退后，才能使用
 

指定者:

profitSharingReturn 在接口中 ProfitSharingV3Service

参数:

request - ProfitSharingReturnRequest 针对某一笔支付订单的分账方法

返回:

ProfitSharingReturnResult 微信返回的分账回退结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

getProfitSharingReturnResult

public ProfitSharingReturnResult getProfitSharingReturnResult(String outOrderNo,
                                                              String outReturnNo)
                                                       throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 查询分账回退结果API

 商户需要核实回退结果，可调用此接口查询回退结果
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_4.shtml
 接口链接：https://api.mch.weixin.qq.com/v3/profitsharing/return-orders/{out_return_no}

 注意：
 • 如果分账回退接口返回状态为处理中，可调用此接口查询回退结果
 

指定者:

getProfitSharingReturnResult 在接口中 ProfitSharingV3Service

参数:

outOrderNo - 原发起分账请求时使用的商户系统内部的分账单号

outReturnNo - 调用回退接口提供的商户系统内部的回退单号

返回:

ProfitSharingReturnResult 微信返回的分账回退结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

profitSharingUnfreeze

public ProfitSharingUnfreezeResult profitSharingUnfreeze(ProfitSharingUnfreezeRequest request)
                                                  throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 解冻剩余资金API

 不需要进行分账的订单，可直接调用本接口将订单的金额全部解冻给特约商户
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_5.shtml
 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/orders/unfreeze

 注意：
 • 调用分账接口后，需要解冻剩余资金时，调用本接口将剩余的分账金额全部解冻给特约商户
 • 此接口采用异步处理模式，即在接收到商户请求后，优先受理请求再异步处理，最终的分账结果可以通过查询分账接口获取
 

指定者:

profitSharingUnfreeze 在接口中 ProfitSharingV3Service

参数:

request - 解冻剩余资金请求实体 ProfitSharingUnfreezeRequest

返回:

ProfitSharingReturnResult 微信返回的解冻剩余资金结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

getProfitSharingUnsplitAmount

public ProfitSharingUnsplitResult getProfitSharingUnsplitAmount(String transactionId)
                                                         throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 查询剩余待分金额API

 可调用此接口查询订单剩余待分金额
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_6.shtml
 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/transactions/{transaction_id}/amounts
 

指定者:

getProfitSharingUnsplitAmount 在接口中 ProfitSharingV3Service

参数:

transactionId - 微信订单号，微信支付订单号

返回:

ProfitSharingUnsplitResult 微信返回的订单剩余待分金额结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

addProfitSharingReceiver

public ProfitSharingReceiver addProfitSharingReceiver(ProfitSharingReceiver request)
                                               throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 添加分账接收方API

 商户发起添加分账接收方请求，建立分账接收方列表。后续可通过发起分账请求，将分账方商户结算后的资金，分到该分账接收方
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_8.shtml
 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/receivers/add
 

指定者:

addProfitSharingReceiver 在接口中 ProfitSharingV3Service

参数:

request - 分账接收方实体 ProfitSharingReceiver

返回:

ProfitSharingReceiver 微信返回的分账接收方结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

deleteProfitSharingReceiver

public ProfitSharingReceiver deleteProfitSharingReceiver(ProfitSharingReceiver request)
                                                  throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 删除分账接收方API

 商户发起删除分账接收方请求。删除后，不支持将分账方商户结算后的资金，分到该分账接收方
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_9.shtml
 接口链接: https://api.mch.weixin.qq.com/v3/profitsharing/receivers/delete
 

指定者:

deleteProfitSharingReceiver 在接口中 ProfitSharingV3Service

参数:

request - 分账接收方实体 ProfitSharingReceiver

返回:

ProfitSharingReceiver 微信返回的删除的分账接收方结果

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档

getProfitSharingNotifyData

public ProfitSharingNotifyData getProfitSharingNotifyData(String notifyData,
                                                          SignatureHeader header)
                                                   throws WxPayException

从接口复制的说明: ProfitSharingV3Service

 分账动账通知

 分账或分账回退成功后，微信会把相关变动结果发送给分账接收方（只支持商户）。
 对后台通知交互时，如果微信收到应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。
 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_1_10.shtml
 

指定者:

getProfitSharingNotifyData 在接口中 ProfitSharingV3Service

参数:

notifyData - 分账通知实体

header - 分账通知头 SignatureHeader

返回:

ProfitSharingNotifyData 资源对象

抛出:

WxPayException - the wx pay exception

另请参阅:

微信文档