com.github.binarywang.wxpay.service.PartnerPayScoreSignPlanService 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.ecommerce.SignatureHeader;
import com.github.binarywang.wxpay.bean.payscore.PartnerUserSignPlanEntity;
import com.github.binarywang.wxpay.bean.payscore.WxPartnerPayScoreSignPlanRequest;
import com.github.binarywang.wxpay.bean.payscore.WxPartnerPayScoreSignPlanResult;
import com.github.binarywang.wxpay.bean.payscore.WxPartnerPayScoreUserSignPlanResult;
import com.github.binarywang.wxpay.exception.WxPayException;
import org.checkerframework.checker.nullness.qual.NonNull;

/**
 * @author UltramanNoa
 * @className PartnerPayScoreSignPlanService
 * @description 微信支付分签约计划接口
 * @createTime 2023/11/3 09:16
 *
 *  * @apiNote 微信支付分签约计划
 * 

 * 文档更新时间：2023.10.13
 * 

 * 微信支付分签约计划是不同模式的支付分接口（随着国家大力推广教培行业先享后付政策,微信支付也紧跟政策于2023.07.25上线第一版签约计划接口以适用教培行业先享后付。于2023.10.13文档推至官网文档中心）
 * 

 * 免确认/需确认 用服务商创单接口 {@link PartnerPayScoreService} 需要用户授权
 * 

 * 签约计划，用单独创单接口 {@link PartnerPayScoreSignPlanService} 不需要用户授权
 * 
 **/
public interface PartnerPayScoreSignPlanService {

  /**
   * description：创建支付分计划  
   * author：UltramanNoa  
   * create Time： 2023/11/3 11:58   
   * version： v.1.0  
   *
   * @param request {@link WxPartnerPayScoreSignPlanRequest}
   *
   * @return {@link WxPartnerPayScoreSignPlanResult}
   * @apiNote 创建支付分计划
   **/
  WxPartnerPayScoreSignPlanResult createPlans(WxPartnerPayScoreSignPlanRequest request) throws WxPayException;

  /**
   * description： 查询支付分计划   
   * author：UltramanNoa  
   * create Time： 2023/11/3 14:03   
   * version： v.1.0  
   *
   * @param merchantPlanNo 路径参数：支付分计划商户侧单号
   * @param subMchid       子商户号
   *
   * @return {@link WxPartnerPayScoreSignPlanResult}
   * @apiNote 查询支付分计划
   **/
  WxPartnerPayScoreSignPlanResult queryPlans(@NonNull String merchantPlanNo, @NonNull String subMchid) throws WxPayException;

  /**
   * description： 停止支付分计划  
   * author：UltramanNoa  
   * create Time： 2023/11/3 14:24   
   * version： v.1.0  
   *
   * @param merchantPlanNo 路径参数：支付分计划商户侧单号
   * @param subMchid       子商户号
   *
   * @return {@link WxPartnerPayScoreSignPlanResult}
   * @apiNote 停止支付分计划
   **/
  WxPartnerPayScoreSignPlanResult stopPlans(@NonNull String merchantPlanNo, @NonNull String subMchid) throws WxPayException;

  /**
   * description： 创建用户的签约计划详情对应的服务订单  
   * author：UltramanNoa  
   * create Time： 2023/11/3 14:53   
   * version： v.1.0  
   *
   * @param request {@link WxPartnerPayScoreSignPlanRequest}
   *
   * @return {@link WxPartnerPayScoreSignPlanResult}
   * @apiNote 创建用户的签约计划详情对应的服务订单
   **/
  WxPartnerPayScoreSignPlanResult signPlanServiceOrder(WxPartnerPayScoreSignPlanRequest request) throws WxPayException;

  /**
   * description： 创建用户的签约计划  
   * author：UltramanNoa  
   * create Time： 2023/11/3 17:48   
   * version： v.1.0  
   *
   * @param request {@link WxPartnerPayScoreSignPlanRequest}
   *
   * @return {@link WxPartnerPayScoreUserSignPlanResult}
   * @apiNote 创建用户的签约计划
   **/
  WxPartnerPayScoreUserSignPlanResult createUserSignPlans(WxPartnerPayScoreSignPlanRequest request) throws WxPayException;

  /**
   * description： 查询用户的签约计划 
   * author：UltramanNoa  
   * create Time： 2023/11/3 18:01   
   * version： v.1.0  
   *
   * @param merchantSignPlanNo 路径参数  商户签约计划号
   * @param subMchid           子商户号
   *
   * @return {@link PartnerUserSignPlanEntity}
   * @apiNote 查询用户的签约计划
   **/
  PartnerUserSignPlanEntity queryUserSignPlans(@NonNull String merchantSignPlanNo, @NonNull String subMchid) throws WxPayException;

  /**
   * description： 取消用户的签约计划   
   * author：UltramanNoa  
   * create Time： 2023/11/3 18:01   
   * version： v.1.0  
   *
   * @param merchantSignPlanNo 路径参数 商户签约计划号 subMchid – 子商户号
   * @param subMchid           子商户号
   * @param stopReason         停止签约计划原因
   *
   * @return {@link PartnerUserSignPlanEntity}
   * @apiNote 取消用户的签约计划
   **/
  PartnerUserSignPlanEntity stopUserSignPlans(@NonNull String merchantSignPlanNo, @NonNull String subMchid, @NonNull String stopReason) throws WxPayException;

  /**
   * description： 回调通知校验解密  
   * author：UltramanNoa  
   * create Time： 2023/11/6 10:27   
   * version： v.1.0  
   * @param
   * @param notifyData
   * @param header
   * @return {@link PartnerUserSignPlanEntity}
   **/
  PartnerUserSignPlanEntity parseSignPlanNotifyResult(String notifyData, SignatureHeader header) throws WxPayException;
}