/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="start_time">服务开始时间 <para>用户端展示用途。用户下单时确认的服务开始时间（比如用户今天下单，明天开始接受服务，这里指的是明天的服务开始时间）。支持三种格式：yyyyMMddHHmmss、yyyyMMdd和OnAccept●传入20091225091010表示2009年12月25日9点10分10秒。●传入20091225默认时间为2009年12月25日●传入OnAccept表示用户确认订单成功时间为【服务开始时间】。根据传入时间精准度进行校验1）若传入时间精准到秒，则校验精准到秒：【服务开始时间】>【商户调用创建订单接口时间2）若传入时间精准到日，则校验精准到日：【服务开始时间】>=【商户调用创建订单接口时间】</para><para>示例值：20091225091010</para></param>
/// <param name="start_time_remark">服务开始时间备注 <para>服务开始时间备注说明，服务开始时间有填时，可填写服务开始时间备注，不超过20个字符，超出报错处理。</para><para>示例值：开始租借日期</para><para>可为null</para></param>
/// <param name="end_time">预计服务结束时间 <para>用户端展示用途，支持两种格式：yyyyMMddHHmmss和yyyyMMdd</para><para>●传入20091225091010表示2009年12月25日9点10分10秒。</para><para>●传入20091225默认时间为2009年12月25日</para><para>根据传入时间精准度进行校验1、若传入时间精准到秒，则校验精准到秒：1）【预计服务结束时间】>【服务开始时间】2）【预计服务结束时间】>【商户调用接口时间+1分钟】2、若传入时间精准到日，则校验精准到日：1）【预计服务结束时间】>=【服务开始时间】2）【预计服务结束时间】>=【商户调用接口时间】【建议】 1、用户下单时【未确定】服务结束时间，不填写。 2、用户下单时【已确定】服务结束时间，填写。</para><para>示例值：20091225121010</para><para>可为null</para></param>
/// <param name="end_time_remark">预计服务结束时间备注 <para>预计服务结束时间备注说明，预计服务结束时间有填时，可填写预计服务结束时间备注，不超过20个字符，超出报错处理。</para><para>示例值：结束租借时间</para><para>可为null</para></param>
public Time_Range(TenpayDateTime start_time, string start_time_remark, TenpayDateTime end_time, string end_time_remark)
{
this.start_time = start_time.ToString();
this.start_time_remark = start_time_remark;
this.end_time = end_time.ToString();
this.end_time_remark = end_time_remark;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="card_id">消费卡ID <para>path消费卡ID，即card_id。card_id获取方法请参见《接入前准备》配置应用中的创建消费卡。</para><para>示例值：pIJMr5MMiIkO_93VtPyIiEk2DZ4w</para></param>
/// <param name="appid">消费卡归属appid <para>body消费卡card_id归属appid，需与api调用方商户号有M-A绑定关系，需和创建消费卡信息中填入的归属appid一致。入参中的用户openid也需用此appid生成。</para><para>示例值：wxc0b84a53ed8e8d29</para></param>
/// <param name="openid">用户openid <para>body待发卡用户的openid，需为消费卡归属appid生成的openid。</para><para>示例值：obLatjhnqgy2syxrXVM3MJirbkdI</para></param>
/// <param name="out_request_no">商户单据号 <para>body商户此次发放凭据号。推荐使用大小写字母和数字，不同添加请求发放凭据号不同，商户侧需保证同一发券请求的out_request_no和send_time的唯一性。</para><para>示例值：oTYhjfdsahnssddj_0136</para></param>
/// <param name="send_time">请求发卡时间 <para>body单次请求发卡时间，消费卡在商户系统的实际发放时间，为东八区标准时间（UTC+8）。商户需保证同一次请求的out_request_no和send_time唯一。由于系统限制，暂不支持传入早于当前时间24小时以上的时间进行发券请求。</para><para>示例值：2019-12-31T13:29:35.120+08:00</para></param>
public SendCardRequestData(string card_id, string appid, string openid, string out_request_no, TenpayDateTime send_time)
{
this.card_id = card_id;
this.appid = appid;
this.openid = openid;
this.out_request_no = out_request_no;
this.send_time = send_time.ToString();
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="available_begin_time">开始时间<para>批次开始时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。</para><para>注意：开始时间设置有效期最长为1年。</para><para>示例值：2015-05-20T13:29:35+08:00</para></param>
/// <param name="available_end_time">结束时间<para>批次结束时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。</para><para>注意：结束时间设置有效期最长为1年。</para><para>示例值：2015-05-20T13:29:35+08:00</para></param>
/// <param name="available_day_after_receive">生效后N天内有效 <para>日期区间内，券生效后x天内有效。例如生效当天内有效填1，生效后2天内有效填2，以此类推。注意，用户在有效期开始前领取商家券，则从有效期第1天开始计算天数，用户在有效期内领取商家券，则从领取当天开始计算天数，无论用户何时领取商家券，商家券在活动有效期结束后均不可用。可配合wait_days_after_receive一同填写，也可单独填写。单独填写时，有效期内领券后立即生效，生效后x天内有效。</para><para>示例值：3</para><para>可为null</para></param>
/// <param name="available_week">固定周期有效时间段 <para>可以设置多个星期下的多个可用时间段，比如每周二10点到18点，用户自定义字段。</para><para>可为null</para></param>
/// <param name="irregulary_avaliable_time">无规律的有效时间段 <para>无规律的有效时间，多个无规律时间段，用户自定义字段。</para><para>可为null</para></param>
/// <param name="wait_days_after_receive">领取后N天开始生效 <para>日期区间内，用户领券后需等待x天开始生效。例如领券后当天开始生效则无需填写，领券后第2天开始生效填1，以此类推。用户在有效期开始前领取商家券，则从有效期第1天开始计算天数，用户在有效期内领取商家券，则从领取当天开始计算天数。无论用户何时领取商家券，商家券在活动有效期结束后均不可用。需配合available_day_after_receive一同填写，不可单独填写。</para><para>示例值：7</para><para>可为null</para></param>
public Coupon_Available_Time(TenpayDateTime available_begin_time, TenpayDateTime available_end_time, int available_day_after_receive, Available_Week available_week, Irregulary_Avaliable_Time[] irregulary_avaliable_time, int?wait_days_after_receive)
{
this.available_begin_time = available_begin_time.ToString();
this.available_end_time = available_end_time.ToString();
this.available_day_after_receive = available_day_after_receive;
this.available_week = available_week;
this.irregulary_avaliable_time = irregulary_avaliable_time;
this.wait_days_after_receive = wait_days_after_receive;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="coupon_code">券code <para>body券的唯一标识。</para><para>示例值：sxxe34343434</para></param>
/// <param name="stock_id">批次号 <para>body微信为每个商家券批次分配的唯一ID，当你在创建商家券接口中的coupon_code_mode参数传值为MERCHANT_API或者MERCHANT_UPLOAD时，则核销接口中该字段必传，否则该字段可不传</para><para>示例值：100088</para><para>可为null</para></param>
/// <param name="appid">公众账号ID <para>body支持传入与当前调用接口商户号有绑定关系的appid。支持小程序appid与公众号appid。核销接口返回的openid会在该传入appid下进行计算获得。</para><para>校验规则：传入的APPID得是与调用方商户号（即请求头里面的商户号）有绑定关系的APPID或传入的APPID得是归属商户号有绑定关系的APPID</para><para>示例值：wx1234567889999</para></param>
/// <param name="use_time">请求核销时间 <para>body商户请求核销用户券的时间。遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35.+08:00表示，北京时间2015年5月20日13点29分35秒。</para><para>示例值：2015-05-20T13:29:35+08:00</para></param>
/// <param name="use_request_no">核销请求单据号 <para>body每次核销请求的唯一标识，商户需保证唯一。</para><para>示例值：1002600620019090123143254435</para></param>
/// <param name="openid">用户标识 <para>body用户的唯一标识，做安全校验使用，非必填。</para><para>校验规则：传入的openid得是调用方商户号（即请求头里面的商户号）有绑定关系的APPID获取的openid或传入的openid得是归属商户号有绑定关系的APPID获取的openid。获取openid文档</para><para>示例值：xsd3434454567676</para><para>可为null</para></param>
public UseBusifavorCouponRequestData(string coupon_code, string stock_id, string appid, TenpayDateTime use_time, string use_request_no, string openid)
{
this.coupon_code = coupon_code;
this.stock_id = stock_id;
this.appid = appid;
this.use_time = use_time.ToString();
this.use_request_no = use_request_no;
this.openid = openid;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="out_parking_no">商户入场id <para>body商户侧入场标识id，在同一个商户号下唯一</para><para>示例值：1231243</para></param>
/// <param name="plate_number">车牌号 <para>body车牌号，仅包括省份+车牌，不包括特殊字符。</para><para>示例值：粤B888888</para></param>
/// <param name="plate_color">车牌颜色 <para>body车牌颜色，枚举值BLUE：蓝色GREEN：绿色YELLOW：黄色BLACK：黑色WHITE：白色LIMEGREEN：黄绿色</para><para>示例值：BLUE</para></param>
/// <param name="notify_url">回调通知url <para>body接受入场状态变更回调通知的url，注意回调url只接受https</para><para>示例值：https://yoursite.com/wxpay.html</para></param>
/// <param name="start_time">入场时间 <para>body入场时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。</para><para>示例值：2017-08-26T10:43:39+08:00</para></param>
/// <param name="parking_name">停车场名称 <para>body所在停车位车场的名称</para><para>示例值：欢乐海岸停车场</para></param>
/// <param name="free_duration">免费时长 <para>body停车场的免费停车时长，单位为秒</para><para>示例值：3600</para></param>
public CreateParkingRequestData(string out_parking_no, string plate_number, string plate_color, string notify_url, TenpayDateTime start_time, string parking_name, int free_duration)
{
this.out_parking_no = out_parking_no;
this.plate_number = plate_number;
this.plate_color = plate_color;
this.notify_url = notify_url;
this.start_time = start_time.ToString();
this.parking_name = parking_name;
this.free_duration = free_duration;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="transaction_id">微信订单号 <para>body微信支付推送的商圈内交易通知里携带的微信订单号</para><para>示例值：1217752501201407033233368018</para></param>
/// <param name="appid">小程序appid <para>body顾客授权积分时使用的小程序的appid</para><para>示例值：wx1234567890abcdef</para></param>
/// <param name="openid">用户标识 <para>body顾客授权时使用的小程序上的openid</para><para>示例值：oWmnN4xxxxxxxxxxe92NHIGf1xd8</para></param>
/// <param name="earn_points">是否获得积分 <para>body用于标明此单是否获得积分，true为获得积分，false为未获得</para><para>示例值：true</para></param>
/// <param name="increased_points">订单新增积分值 <para>body顾客此笔交易新增的积分值</para><para>示例值：100</para></param>
/// <param name="points_update_time">积分更新时间 <para>body为顾客此笔交易成功积分的时间</para><para>示例值：2020-05-20T13:29:35.120+08:00</para></param>
/// <param name="no_points_remarks">未获得积分的备注信息 <para>body当未获得积分时，提供未获得积分的原因等备注信息</para><para>示例值：商品不参与积分活动</para><para>可为null</para></param>
/// <param name="total_points">顾客积分总额 <para>body当前顾客积分总额</para><para>示例值：888888</para><para>可为null</para></param>
public NotifyBusinessCirclePointsRequestData(string transaction_id, string appid, string openid, bool earn_points, int increased_points, TenpayDateTime points_update_time, string no_points_remarks, int?total_points)
{
this.transaction_id = transaction_id;
this.appid = appid;
this.openid = openid;
this.earn_points = earn_points;
this.increased_points = increased_points;
this.points_update_time = points_update_time.ToString();
this.no_points_remarks = no_points_remarks;
this.total_points = total_points;
}
/// <summary>
/// 构造函数
/// </summary>
/// <param name="combine_appid">合单商户appid</param>
/// <param name="combine_mchid">合单商户号</param>
/// <param name="combine_out_trade_no">合单商户订单号</param>
/// <param name="scene_info">支付场景描述，可为null</param>
/// <param name="sub_orders">子单信息 最多支持子单条数：10</param>
/// <param name="combine_payer_info">支付者信息</param>
/// <param name="time_start">订单生成时间 遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，可为null</param>
/// <param name="time_expire">订单失效时间 遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，可为null</param>
/// <param name="notify_url">通知URL 必须为直接可访问的URL，不允许携带查询串，要求必须为https地址。</param>
public CombineTransactionsRequestData(string combine_appid, string combine_mchid, string combine_out_trade_no, Scene_Info scene_info, IEnumerable <Sub_Order> sub_orders, Combine_Payer_Info combine_payer_info, TenpayDateTime time_start, TenpayDateTime time_expire, string notify_url)
{
this.combine_appid = combine_appid;
this.combine_mchid = combine_mchid;
this.combine_out_trade_no = combine_out_trade_no;
this.scene_info = scene_info;
this.sub_orders = sub_orders;
this.combine_payer_info = combine_payer_info;
this.time_start = time_start?.ToString();
this.time_expire = time_expire?.ToString();
this.notify_url = notify_url;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="stock_name">批次名称</param>
/// <param name="comment">批次备注 仅制券商户可见，用于自定义信息，可为null</param>
/// <param name="belong_merchant">批次归属商户号 本字段暂未开放生效，但入参时请设置为当前创建代金券商户号即不会报错，暂时不支持入参其他的商户号</param>
/// <param name="available_begin_time">可用时间-开始时间 批次开始时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE</param>
/// <param name="available_end_time">可用时间-结束时间 批次结束时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE</param>
/// <param name="stock_use_rule">发放规则</param>
/// <param name="pattern_info">样式设置，可为null</param>
/// <param name="coupon_use_rule">核销规则</param>
/// <param name="no_cash">营销经费</param>
/// <param name="stock_type">批次类型，仅支持：NORMAL：固定面额满减券批次</param>
/// <param name="out_request_no">商户单据号</param>
public CreateStockRequsetData(string stock_name, string comment, string belong_merchant, TenpayDateTime available_begin_time, TenpayDateTime available_end_time, Stock_Use_Rule stock_use_rule, Pattern_Info pattern_info, Coupon_Use_Rule coupon_use_rule, bool no_cash, string stock_type, string out_request_no)
{
this.stock_name = stock_name;
this.comment = comment;
this.belong_merchant = belong_merchant;
this.available_begin_time = available_begin_time.ToString();
this.available_end_time = available_end_time.ToString();
this.stock_use_rule = stock_use_rule;
this.pattern_info = pattern_info;
this.coupon_use_rule = coupon_use_rule;
this.no_cash = no_cash;
this.stock_type = stock_type;
this.out_request_no = out_request_no;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="activity_name">活动名称 <para>活动名称</para><para>示例值：良品铺子回馈活动</para></param>
/// <param name="activity_second_title">活动副标题 <para>活动副标题</para><para>示例值：海飞丝的券</para></param>
/// <param name="merchant_logo_url">商户logo <para>商户logo，送出优惠券时展示，仅支持通过《图片上传API》接口获取的图片URL地址。</para><para>示例值：https://tool.oschina.net/regex.jpg</para></param>
/// <param name="background_color">背景颜色 <para>代金券的背景颜色，可设置10种颜色，颜色取值请参见色卡图，默认为微信支付绿色，颜色取值为颜色图中的颜色名称。</para><para>示例值：COLOR020</para><para>可为null</para></param>
/// <param name="begin_time">活动开始时间 <para>1、活动开始时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。2、最长可以配置1年内的活动，活动有效期最长90天。</para><para>示例值：2015-05-20T13:29:35+08:00</para></param>
/// <param name="end_time">活动结束时间 <para>1、活动结束时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。2、最长可以配置1年内的活动，活动有效期最长90天。</para><para>示例值：2015-05-20T13:29:35+08:00</para></param>
/// <param name="available_periods">可用时间段 <para>可自定义活动有效时间内可用的多个时间段以及每天可用的时间点。</para><para>可为null</para></param>
/// <param name="out_request_no">商户请求单号 <para>商户创建批次凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性，可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号。</para><para>示例值：100002322019090134234sfdf</para></param>
/// <param name="delivery_purpose">投放目的 <para>枚举值：OFF_LINE_PAY：拉用户回店消费JUMP_MINI_APP：引导用户前往小程序消费</para><para>示例值：OFF_LINE_PAY</para></param>
/// <param name="mini_programs_appid">商家小程序appid <para>投放目的为JUMP_MINI_APP时必填。</para><para>示例值：wx23232232323</para><para>可为null</para></param>
/// <param name="mini_programs_path">商家小程序path <para>如果传入此参数，则跳转至商家小程序；反之则跳转至券详情页面。</para><para>示例值：/path/index/index</para><para>可为null</para></param>
public Activity_Base_Info(string activity_name, string activity_second_title, string merchant_logo_url, string background_color, TenpayDateTime begin_time, TenpayDateTime end_time, Available_Periods available_periods, string out_request_no, string delivery_purpose, string mini_programs_appid, string mini_programs_path)
{
this.activity_name = activity_name;
this.activity_second_title = activity_second_title;
this.merchant_logo_url = merchant_logo_url;
this.background_color = background_color;
this.begin_time = begin_time.ToString();
this.end_time = end_time.ToString();
this.available_periods = available_periods;
this.out_request_no = out_request_no;
this.delivery_purpose = delivery_purpose;
this.mini_programs_appid = mini_programs_appid;
this.mini_programs_path = mini_programs_path;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="appid">由微信生成的应用ID，全局唯一</param>
/// <param name="mchid">直连商户的商户号，由微信支付生成并下发</param>
/// <param name="description">商品描述 示例值：Image形象店-深圳腾大-QQ公仔</param>
/// <param name="out_trade_no">商户系统内部订单号</param>
/// <param name="time_expire">订单失效时间 遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，可为null</param>
/// <param name="attach">附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用，可为null</param>
/// <param name="notify_url">通知URL 必须为直接可访问的URL，不允许携带查询串，要求必须为https地址</param>
/// <param name="goods_tag">订单优惠标记 示例值：WXG，可为null</param>
/// <param name="amount">订单金额</param>
/// <param name="payer">支付者，JSAPI下单必填，其它下单方式必须为null</param>
/// <param name="detail">优惠功能，可为null</param>
/// <param name="settle_info">结算信息，可为null</param>
/// <param name="scene_info">支付场景描述，H5下单必填，其它支付方式可为null</param>
public TransactionsRequestData(string appid, string mchid, string description,
string out_trade_no, TenpayDateTime time_expire, string attach,
string notify_url, string goods_tag, Amount amount, Payer payer = null,
Detail detail = null, Settle_Info settle_info = null, Scene_Info scene_info = null)
{
this.appid = appid;
this.mchid = mchid;
this.description = description;
this.out_trade_no = out_trade_no;
this.time_expire = time_expire.ToString();
this.attach = attach;
this.notify_url = notify_url;
this.goods_tag = goods_tag;
this.amount = amount;
this.payer = payer;
this.detail = detail;
this.settle_info = settle_info;
this.scene_info = scene_info;
}
/// <summary>
/// 含参构造函数
/// </summary>
/// <param name="paid_time">收款成功时间 <para>支付成功时间，支持两种格式：yyyyMMddHHmmss和yyyyMMdd</para><para></para><para>●传入20091225091010表示2009年12月25日9点10分10秒。</para><para>●传入20091225默认时间为2009年12月25日0点0分0秒。</para><para></para><para>用户通过其他方式付款成功的实际时间需满足条件：服务开始时间＜调用商户完结订单接口的时间＜用户通过其他方式付款成功的实际时间≤商户调用支付分订单同步接口的时间。【服务开始时间】1、当完结订单有填写【实际服务开始时间】时，【服务开始时间】=完结订单【实际服务开始时间】。2、当完结订单未填写【实际服务开始时间】时，【服务开始时间】=创建订单【服务开始时间】场景类型为Order_Paid时，必填。支持两种格式：yyyyMMddHHmmss和yyyyMMdd●传入20091225091010表示2009年12月25日9点10分10秒。●传入20091225表示时间为2009年12月25日23点59分59秒。</para><para>注意：微信支付分会根据此时间更新用户侧的守约记录、负面记录信息；因此请务必如实填写用户实际付款成功时间，以免造成不必要的客诉。</para><para>示例值：20091225091210</para></param>
public Detail(TenpayDateTime paid_time)
{
this.paid_time = paid_time.ToString();
}
/// <summary>
/// 查询投诉单列表接口
/// <para>商户可通过调用此接口，查询指定时间段的所有用户投诉信息，以分页输出查询结果。对于服务商、渠道商，可通过调用此接口，查询指定子商户号对应子商户的投诉信息，若不指定则查询所有子商户投诉信息。</para>
/// <para>注意：商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial，详见接口规则</para>
/// <para>更多详细请参考 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter10_2_11.shtml </para>
/// </summary>
/// <param name="begin_date">投诉发生的开始日期，格式为YYYY-MM-DD。注意，查询日期跨度不超过30天，当前查询为实时查询</param>
/// <param name="end_date">投诉发生的结束日期，格式为YYYY-MM-DD。注意，查询日期跨度不超过30天，当前查询为实时查询</param>
/// <param name="complainted_mchid">投诉单对应的被诉商户号, 可为null</param>
/// <param name="limit">设置该次请求返回的最大投诉条数，范围【1,50】,商户自定义字段，不传默认为10。注：如遇到提示“当前查询结果数据量过大”，是回包触发微信支付下行数据包大小限制，请缩小入参limit并重试。</param>
/// <param name="offset">该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回，不传默认为0 。</param>
/// <param name="timeOut">超时时间，单位为ms</param>
/// <returns></returns>
public async Task <QueryComplaintsReturnJson> QueryComplaintsAsync(TenpayDateTime begin_date, TenpayDateTime end_date, string complainted_mchid, int limit = 10, int offset = 0, int timeOut = Config.TIME_OUT)
{
var url = ReurnPayApiUrl($"https://api.mch.weixin.qq.com/{{0}}v3/merchant-service/complaints-v2?limit={limit}&offset={offset}&begin_date={begin_date?.ToString()}&end_date={end_date?.ToString()}");
url += complainted_mchid is not null ? $"&complainted_mchid={complainted_mchid}" : "";
TenPayApiRequest tenPayApiRequest = new(_tenpayV3Setting);
return(await tenPayApiRequest.RequestAsync <QueryComplaintsReturnJson>(url, null, timeOut, ApiRequestMethod.GET));
}