com.github.binarywang.wxpay.service.impl

类 TransferServiceImpl

java.lang.Object

com.github.binarywang.wxpay.service.impl.TransferServiceImpl

所有已实现的接口:

TransferService

public class TransferServiceImpl
extends Object
implements TransferService

商家转账到零钱

作者:

zhongjun created on 2022/6/17

构造器概要

构造器

构造器和说明
TransferServiceImpl()

方法概要

限定符和类型	方法和说明
void	closeReservationTransferBatch(String outBatchNo) 关闭预约商家转账批次接口 商户可以通过此接口关闭预约商家转账批次单。
TransferBillsGetResult	getBillsByOutBillNo(String outBillNo) 2025.1.15 开始新接口 发起商家转账API 请求方式：GET（HTTPS） 请求地址：请求地址 文档地址：商户单号查询转账单API
TransferBillsGetResult	getBillsByTransferBillNo(String transferBillNo) 2025.1.15 开始新接口 微信单号查询转账单API 请求方式：GET（HTTPS） 请求地址：请求地址 文档地址：商户单号查询转账单API
ReservationTransferBatchGetResult	getReservationTransferBatchByOutBatchNo(String outBatchNo, Boolean needQueryDetail, Integer offset, Integer limit, String detailState) 商户预约批次单号查询批次单接口 通过商户预约批次单号查询批量预约商家转账批次单基本信息。
ReservationTransferBatchGetResult	getReservationTransferBatchByReservationBatchNo(String reservationBatchNo, Boolean needQueryDetail, Integer offset, Integer limit, String detailState) 微信预约批次单号查询批次单接口 通过微信预约批次单号查询批量预约商家转账批次单基本信息。
UserAuthorizationStatusResult	getUserAuthorizationStatus(String openid, String transferSceneId) 商户查询用户授权信息接口 商户通过此接口可查询用户是否对商户的商家转账场景进行了授权。
ReservationTransferNotifyResult	parseReservationTransferNotifyResult(String notifyData, SignatureHeader header) 解析预约商家转账通知回调结果 预约批次单中的明细单在转账成功或转账失败时，微信会把相关结果信息发送给商户。
TransferBillsNotifyResult	parseTransferBillsNotifyResult(String notifyData, SignatureHeader header) 2025.1.15 开始新接口 解析商家转账结果 详见
TransferNotifyResult	parseTransferNotifyResult(String notifyData, SignatureHeader header) 解析商家转账结果 详见
ReservationTransferBatchResult	reservationTransferBatch(ReservationTransferBatchRequest request) 批量预约商家转账接口 商户可以通过批量预约接口一次发起批量转账请求，最多可以同时向50个用户发起转账。
TransferBatchesResult	transferBatches(TransferBatchesRequest request) 发起商家转账API 请求方式：POST（HTTPS） 请求地址：请求地址 文档地址：发起商家转账API
QueryTransferBatchesResult	transferBatchesBatchId(QueryTransferBatchesRequest request) 微信批次单号查询批次单API 请求方式：GET（HTTPS） 请求地址：请求地址 文档地址：微信批次单号查询批次单API
TransferBatchDetailResult	transferBatchesBatchIdDetail(String batchId, String detailId) 微信明细单号查询明细单API 请求方式：GET（HTTPS） 请求地址：请求地址 文档地址：微信明细单号查询明细单API
QueryTransferBatchesResult	transferBatchesOutBatchNo(QueryTransferBatchesRequest request) 商家批次单号查询批次单API 请求方式：GET（HTTPS） 请求地址：请求地址 文档地址：商家批次单号查询批次单API
TransferBatchDetailResult	transferBatchesOutBatchNoDetail(String outBatchNo, String outDetailNo) 商家明细单号查询明细单API 请求方式：GET（HTTPS） 请求地址：请求地址 文档地址：商家明细单号查询明细单API
TransferBillsResult	transferBills(TransferBillsRequest request) 2025.1.15 开始新接口 发起商家转账API 请求方式：POST（HTTPS） 请求地址：请求地址 文档地址：发起商家转账API
TransferBillsCancelResult	transformBillsCancel(String outBillNo) 2025.1.15 开始新接口 撤销转账API 请求方式：POST（HTTPS） 请求地址：请求地址 文档地址：商户撤销转账API

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

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

构造器详细资料

TransferServiceImpl

public TransferServiceImpl()

方法详细资料

transferBatches

public TransferBatchesResult transferBatches(TransferBatchesRequest request)
                                      throws WxPayException

从接口复制的说明: TransferService

 发起商家转账API

 请求方式：POST（HTTPS）
 请求地址：请求地址

 文档地址：发起商家转账API
 

指定者:

transferBatches 在接口中 TransferService

参数:

request - 转账请求参数

返回:

TransferBatchesResult 转账结果

抛出:

WxPayException - .

parseTransferNotifyResult

public TransferNotifyResult parseTransferNotifyResult(String notifyData,
                                                      SignatureHeader header)
                                               throws WxPayException

从接口复制的说明: TransferService

解析商家转账结果 详见

指定者:

parseTransferNotifyResult 在接口中 TransferService

参数:

notifyData - 通知数据

header - 通知头部数据，不传则表示不校验头

返回:

the wx transfer notify result

抛出:

WxPayException - the wx pay exception

transferBatchesBatchId

public QueryTransferBatchesResult transferBatchesBatchId(QueryTransferBatchesRequest request)
                                                  throws WxPayException

从接口复制的说明: TransferService

 微信批次单号查询批次单API

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：微信批次单号查询批次单API
 

指定者:

transferBatchesBatchId 在接口中 TransferService

参数:

request - 查询请求参数

返回:

TransferBatchesResult 查询结果

抛出:

WxPayException - .

transferBatchesBatchIdDetail

public TransferBatchDetailResult transferBatchesBatchIdDetail(String batchId,
                                                              String detailId)
                                                       throws WxPayException

从接口复制的说明: TransferService

 微信明细单号查询明细单API

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：微信明细单号查询明细单API
 

指定者:

transferBatchesBatchIdDetail 在接口中 TransferService

参数:

batchId - 微信批次单号

detailId - 微信明细单号

返回:

TransferBatchDetailResult 查询结果

抛出:

WxPayException - .

transferBatchesOutBatchNo

public QueryTransferBatchesResult transferBatchesOutBatchNo(QueryTransferBatchesRequest request)
                                                     throws WxPayException

从接口复制的说明: TransferService

 商家批次单号查询批次单API

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：商家批次单号查询批次单API
 

指定者:

transferBatchesOutBatchNo 在接口中 TransferService

参数:

request - 查询请求参数

返回:

TransferBatchesResult 查询结果

抛出:

WxPayException - .

transferBatchesOutBatchNoDetail

public TransferBatchDetailResult transferBatchesOutBatchNoDetail(String outBatchNo,
                                                                 String outDetailNo)
                                                          throws WxPayException

从接口复制的说明: TransferService

 商家明细单号查询明细单API

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：商家明细单号查询明细单API
 

指定者:

transferBatchesOutBatchNoDetail 在接口中 TransferService

参数:

outBatchNo - 商家明细单号

outDetailNo - 商家批次单号

返回:

TransferBatchDetailResult 查询结果

抛出:

WxPayException - .

transferBills

public TransferBillsResult transferBills(TransferBillsRequest request)
                                  throws WxPayException

从接口复制的说明: TransferService

 2025.1.15 开始新接口 发起商家转账API

 请求方式：POST（HTTPS）
 请求地址：请求地址

 文档地址：发起商家转账API
 

指定者:

transferBills 在接口中 TransferService

参数:

request - 转账请求参数

返回:

TransferBillsResult 转账结果

抛出:

WxPayException - .

transformBillsCancel

public TransferBillsCancelResult transformBillsCancel(String outBillNo)
                                               throws WxPayException

从接口复制的说明: TransferService

 2025.1.15 开始新接口 撤销转账API

 请求方式：POST（HTTPS）
 请求地址：请求地址

 文档地址：商户撤销转账API
 

指定者:

transformBillsCancel 在接口中 TransferService

参数:

outBillNo - 【商户单号】 商户系统内部的商家单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一

返回:

TransformBillsGetResult 转账单

抛出:

WxPayException - .

getBillsByOutBillNo

public TransferBillsGetResult getBillsByOutBillNo(String outBillNo)
                                           throws WxPayException

从接口复制的说明: TransferService

 2025.1.15 开始新接口 发起商家转账API

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：商户单号查询转账单API
 

指定者:

getBillsByOutBillNo 在接口中 TransferService

参数:

outBillNo - 【商户单号】 商户系统内部的商家单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一

返回:

TransformBillsGetResult 转账单

抛出:

WxPayException - .

getBillsByTransferBillNo

public TransferBillsGetResult getBillsByTransferBillNo(String transferBillNo)
                                                throws WxPayException

从接口复制的说明: TransferService

 2025.1.15 开始新接口 微信单号查询转账单API

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：商户单号查询转账单API
 

指定者:

getBillsByTransferBillNo 在接口中 TransferService

参数:

transferBillNo - 【微信转账单号】 微信转账单号，微信商家转账系统返回的唯一标识

返回:

TransformBillsGetResult 转账单

抛出:

WxPayException - .

parseTransferBillsNotifyResult

public TransferBillsNotifyResult parseTransferBillsNotifyResult(String notifyData,
                                                                SignatureHeader header)
                                                         throws WxPayException

从接口复制的说明: TransferService

2025.1.15 开始新接口 解析商家转账结果 详见

指定者:

parseTransferBillsNotifyResult 在接口中 TransferService

参数:

notifyData - 通知数据

header - 通知头部数据，不传则表示不校验头

返回:

the wx transfer notify result

抛出:

WxPayException - the wx pay exception

getUserAuthorizationStatus

public UserAuthorizationStatusResult getUserAuthorizationStatus(String openid,
                                                                String transferSceneId)
                                                         throws WxPayException

从接口复制的说明: TransferService

 商户查询用户授权信息接口

 商户通过此接口可查询用户是否对商户的商家转账场景进行了授权。

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：商户查询用户授权信息
 

指定者:

getUserAuthorizationStatus 在接口中 TransferService

参数:

openid - 用户在直连商户应用下的用户标识

transferSceneId - 转账场景ID

返回:

UserAuthorizationStatusResult 用户授权信息

抛出:

WxPayException - .

reservationTransferBatch

public ReservationTransferBatchResult reservationTransferBatch(ReservationTransferBatchRequest request)
                                                        throws WxPayException

从接口复制的说明: TransferService

 批量预约商家转账接口

 商户可以通过批量预约接口一次发起批量转账请求，最多可以同时向50个用户发起转账。
 批量预约接口适用于用户已授权免确认的场景，在转账时无需用户确认即可完成转账。

 请求方式：POST（HTTPS）
 请求地址：请求地址

 文档地址：批量预约商家转账
 

指定者:

reservationTransferBatch 在接口中 TransferService

参数:

request - 批量预约商家转账请求参数

返回:

ReservationTransferBatchResult 批量预约商家转账结果

抛出:

WxPayException - .

getReservationTransferBatchByOutBatchNo

public ReservationTransferBatchGetResult getReservationTransferBatchByOutBatchNo(String outBatchNo,
                                                                                 Boolean needQueryDetail,
                                                                                 Integer offset,
                                                                                 Integer limit,
                                                                                 String detailState)
                                                                          throws WxPayException

从接口复制的说明: TransferService

 商户预约批次单号查询批次单接口

 通过商户预约批次单号查询批量预约商家转账批次单基本信息。

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：商户预约批次单号查询批次单
 

指定者:

getReservationTransferBatchByOutBatchNo 在接口中 TransferService

参数:

outBatchNo - 商户预约批次单号

needQueryDetail - 是否需要查询明细

offset - 分页偏移量

limit - 分页大小

detailState - 明细状态（PROCESSING/SUCCESS/FAIL）

返回:

ReservationTransferBatchGetResult 批量预约商家转账批次查询结果

抛出:

WxPayException - .

getReservationTransferBatchByReservationBatchNo

public ReservationTransferBatchGetResult getReservationTransferBatchByReservationBatchNo(String reservationBatchNo,
                                                                                         Boolean needQueryDetail,
                                                                                         Integer offset,
                                                                                         Integer limit,
                                                                                         String detailState)
                                                                                  throws WxPayException

从接口复制的说明: TransferService

 微信预约批次单号查询批次单接口

 通过微信预约批次单号查询批量预约商家转账批次单基本信息。

 请求方式：GET（HTTPS）
 请求地址：请求地址

 文档地址：微信预约批次单号查询批次单
 

指定者:

getReservationTransferBatchByReservationBatchNo 在接口中 TransferService

参数:

reservationBatchNo - 微信预约批次单号

needQueryDetail - 是否需要查询明细

offset - 分页偏移量

limit - 分页大小

detailState - 明细状态（PROCESSING/SUCCESS/FAIL）

返回:

ReservationTransferBatchGetResult 批量预约商家转账批次查询结果

抛出:

WxPayException - .

parseReservationTransferNotifyResult

public ReservationTransferNotifyResult parseReservationTransferNotifyResult(String notifyData,
                                                                            SignatureHeader header)
                                                                     throws WxPayException

从接口复制的说明: TransferService

 解析预约商家转账通知回调结果

 预约批次单中的明细单在转账成功或转账失败时，微信会把相关结果信息发送给商户。

 文档地址：预约商家转账通知
 

指定者:

parseReservationTransferNotifyResult 在接口中 TransferService

参数:

notifyData - 通知数据

header - 通知头部数据，不传则表示不校验头

返回:

ReservationTransferNotifyResult 预约商家转账通知结果

抛出:

WxPayException - the wx pay exception

closeReservationTransferBatch

public void closeReservationTransferBatch(String outBatchNo)
                                   throws WxPayException

从接口复制的说明: TransferService

 关闭预约商家转账批次接口

 商户可以通过此接口关闭预约商家转账批次单。关闭后，该批次内所有未成功的转账将被取消。

 请求方式：POST（HTTPS）
 请求地址：请求地址

 文档地址：关闭预约商家转账批次
 

指定者:

closeReservationTransferBatch 在接口中 TransferService

参数:

outBatchNo - 商户预约批次单号

抛出:

WxPayException - .