com.github.binarywang.wxpay.service

接口 TransferService

所有已知实现类:

TransferServiceImpl

public interface TransferService

商家转账到零钱

作者:

zhongjun created on 2022/6/17

方法概要

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

方法详细资料

transferBatches

TransferBatchesResult transferBatches(TransferBatchesRequest request)
                               throws WxPayException

 发起商家转账API

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

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

参数:

request - 转账请求参数

返回:

TransferBatchesResult 转账结果

抛出:

WxPayException - .

parseTransferNotifyResult

TransferNotifyResult parseTransferNotifyResult(String notifyData,
                                               SignatureHeader header)
                                        throws WxPayException

解析商家转账结果 详见

参数:

notifyData - 通知数据

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

返回:

the wx transfer notify result

抛出:

WxPayException - the wx pay exception

transferBatchesBatchId

QueryTransferBatchesResult transferBatchesBatchId(QueryTransferBatchesRequest request)
                                           throws WxPayException

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

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

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

参数:

request - 查询请求参数

返回:

TransferBatchesResult 查询结果

抛出:

WxPayException - .

transferBatchesBatchIdDetail

TransferBatchDetailResult transferBatchesBatchIdDetail(String batchId,
                                                       String detailId)
                                                throws WxPayException

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

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

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

参数:

batchId - 微信批次单号

detailId - 微信明细单号

返回:

TransferBatchDetailResult 查询结果

抛出:

WxPayException - .

transferBatchesOutBatchNo

QueryTransferBatchesResult transferBatchesOutBatchNo(QueryTransferBatchesRequest request)
                                              throws WxPayException

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

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

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

参数:

request - 查询请求参数

返回:

TransferBatchesResult 查询结果

抛出:

WxPayException - .

WxPayException - .

transferBatchesOutBatchNoDetail

TransferBatchDetailResult transferBatchesOutBatchNoDetail(String outBatchNo,
                                                          String outDetailNo)
                                                   throws WxPayException

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

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

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

参数:

outBatchNo - 商家明细单号

outDetailNo - 商家批次单号

返回:

TransferBatchDetailResult 查询结果

抛出:

WxPayException - .

transferBills

TransferBillsResult transferBills(TransferBillsRequest request)
                           throws WxPayException

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

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

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

参数:

request - 转账请求参数

返回:

TransferBillsResult 转账结果

抛出:

WxPayException - .

transformBillsCancel

TransferBillsCancelResult transformBillsCancel(String outBillNo)
                                        throws WxPayException

 2025.1.15 开始新接口 撤销转账API

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

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

参数:

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

返回:

TransformBillsGetResult 转账单

抛出:

WxPayException - .

getBillsByOutBillNo

TransferBillsGetResult getBillsByOutBillNo(String outBillNo)
                                    throws WxPayException

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

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

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

参数:

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

返回:

TransformBillsGetResult 转账单

抛出:

WxPayException - .

getBillsByTransferBillNo

TransferBillsGetResult getBillsByTransferBillNo(String transferBillNo)
                                         throws WxPayException

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

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

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

参数:

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

返回:

TransformBillsGetResult 转账单

抛出:

WxPayException - .

parseTransferBillsNotifyResult

TransferBillsNotifyResult parseTransferBillsNotifyResult(String notifyData,
                                                         SignatureHeader header)
                                                  throws WxPayException

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

参数:

notifyData - 通知数据

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

返回:

the wx transfer notify result

抛出:

WxPayException - the wx pay exception

getUserAuthorizationStatus

UserAuthorizationStatusResult getUserAuthorizationStatus(String openid,
                                                         String transferSceneId)
                                                  throws WxPayException

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

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

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

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

参数:

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

transferSceneId - 转账场景ID

返回:

UserAuthorizationStatusResult 用户授权信息

抛出:

WxPayException - .

reservationTransferBatch

ReservationTransferBatchResult reservationTransferBatch(ReservationTransferBatchRequest request)
                                                 throws WxPayException

 批量预约商家转账接口

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

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

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

参数:

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

返回:

ReservationTransferBatchResult 批量预约商家转账结果

抛出:

WxPayException - .

getReservationTransferBatchByOutBatchNo

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

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

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

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

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

参数:

outBatchNo - 商户预约批次单号

needQueryDetail - 是否需要查询明细

offset - 分页偏移量

limit - 分页大小

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

返回:

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

抛出:

WxPayException - .

getReservationTransferBatchByReservationBatchNo

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

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

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

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

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

参数:

reservationBatchNo - 微信预约批次单号

needQueryDetail - 是否需要查询明细

offset - 分页偏移量

limit - 分页大小

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

返回:

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

抛出:

WxPayException - .

parseReservationTransferNotifyResult

ReservationTransferNotifyResult parseReservationTransferNotifyResult(String notifyData,
                                                                     SignatureHeader header)
                                                              throws WxPayException

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

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

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

参数:

notifyData - 通知数据

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

返回:

ReservationTransferNotifyResult 预约商家转账通知结果

抛出:

WxPayException - the wx pay exception

closeReservationTransferBatch

void closeReservationTransferBatch(String outBatchNo)
                            throws WxPayException

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

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

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

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

参数:

outBatchNo - 商户预约批次单号

抛出:

WxPayException - .