com.github.binarywang.wxpay.service.TransferService Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weixin-java-pay Show documentation
微信支付 Java SDK
The newest version!
package com.github.binarywang.wxpay.service;

import com.github.binarywang.wxpay.bean.notify.SignatureHeader;
import com.github.binarywang.wxpay.bean.transfer.*;
import com.github.binarywang.wxpay.exception.WxPayException;

/**
 * 商家转账到零钱
 *
 * @author zhongjun
 * created on  2022/6/17
 **/
public interface TransferService {

  /**
   *    *
   * 发起商家转账API
   *
   * 请求方式：POST（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：发起商家转账API
   * 
   *
   * @param request 转账请求参数
   * @return TransferBatchesResult 转账结果
   * @throws WxPayException .
   */
  TransferBatchesResult transferBatches(TransferBatchesRequest request) throws WxPayException;

  /**
   * 解析商家转账结果
   * 详见
   *
   * @param notifyData 通知数据
   * @param header     通知头部数据，不传则表示不校验头
   * @return the wx transfer notify result
   * @throws WxPayException the wx pay exception
   */
  TransferNotifyResult parseTransferNotifyResult(String notifyData, SignatureHeader header) throws WxPayException;

  /**
   *    *
   * 微信批次单号查询批次单API
   *
   * 请求方式：GET（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：微信批次单号查询批次单API
   * 
   *
   * @param request 查询请求参数
   * @return TransferBatchesResult 查询结果
   * @throws WxPayException .
   */
  QueryTransferBatchesResult transferBatchesBatchId(QueryTransferBatchesRequest request) throws WxPayException;

  /**
   *    *
   * 微信明细单号查询明细单API
   *
   * 请求方式：GET（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：微信明细单号查询明细单API
   * 
   *
   * @param batchId  微信批次单号
   * @param detailId 微信明细单号
   * @return TransferBatchDetailResult 查询结果
   * @throws WxPayException .
   */
  TransferBatchDetailResult transferBatchesBatchIdDetail(String batchId, String detailId) throws WxPayException;

  /**
   *    *
   * 商家批次单号查询批次单API
   *
   * 请求方式：GET（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：商家批次单号查询批次单API
   * 
   *
   * @param request 查询请求参数
   * @return TransferBatchesResult 查询结果
   * @throws WxPayException .
   * @throws WxPayException .
   */
  QueryTransferBatchesResult transferBatchesOutBatchNo(QueryTransferBatchesRequest request) throws WxPayException;

  /**
   *    *
   * 商家明细单号查询明细单API
   *
   * 请求方式：GET（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：商家明细单号查询明细单API
   * 
   *
   * @param outBatchNo  商家明细单号
   * @param outDetailNo 商家批次单号
   * @return TransferBatchDetailResult 查询结果
   * @throws WxPayException .
   */
  TransferBatchDetailResult transferBatchesOutBatchNoDetail(String outBatchNo, String outDetailNo) throws WxPayException;

  /**
   *    *
   * 2025.1.15 开始新接口 发起商家转账API
   *
   * 请求方式：POST（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：发起商家转账API
   * 
   *
   * @param request 转账请求参数
   * @return TransferBillsResult 转账结果
   * @throws WxPayException .
   */
  TransferBillsResult transferBills(TransferBillsRequest request) throws WxPayException;

  /**
   *    *
   * 2025.1.15 开始新接口 撤销转账API
   *
   * 请求方式：POST（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：商户撤销转账API
   * 
   *
   * @param outBillNo 【商户单号】 商户系统内部的商家单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一
   * @return TransformBillsGetResult 转账单
   * @throws WxPayException .
   */
  TransferBillsCancelResult transformBillsCancel(String outBillNo) throws WxPayException;

  /**
   *    *
   * 2025.1.15 开始新接口 发起商家转账API
   *
   * 请求方式：GET（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：商户单号查询转账单API
   * 
   *
   * @param outBillNo 【商户单号】 商户系统内部的商家单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一
   * @return TransformBillsGetResult 转账单
   * @throws WxPayException .
   */
  TransferBillsGetResult getBillsByOutBillNo(String outBillNo) throws WxPayException;

  /**
   *    *
   * 2025.1.15 开始新接口 微信单号查询转账单API
   *
   * 请求方式：GET（HTTPS）
   * 请求地址：请求地址
   *
   * 文档地址：商户单号查询转账单API
   * 
   *
   * @param transferBillNo 【微信转账单号】 微信转账单号，微信商家转账系统返回的唯一标识
   * @return TransformBillsGetResult 转账单
   * @throws WxPayException .
   */
  TransferBillsGetResult getBillsByTransferBillNo(String transferBillNo) throws WxPayException;

  /**
   * 2025.1.15 开始新接口 解析商家转账结果
   * 详见
   *
   * @param notifyData 通知数据
   * @param header     通知头部数据，不传则表示不校验头
   * @return the wx transfer notify result
   * @throws WxPayException the wx pay exception
   */
  TransferBillsNotifyResult parseTransferBillsNotifyResult(String notifyData, SignatureHeader header) throws WxPayException;
}