#region Apache License Version 2.0
/*----------------------------------------------------------------
Copyright 2023 Jeffrey Su & Suzhou Senparc Network Technology Co.,Ltd.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the
License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing permissions
and limitations under the License.
Detail: https://github.com/JeffreySu/WeiXinMPSDK/blob/master/license.md
----------------------------------------------------------------*/
#endregion Apache License Version 2.0
/*----------------------------------------------------------------
Copyright (C) 2023 Senparc
文件名:PayParkingRequestData.cs
文件功能描述:扣费受理接口请求数据
创建标识:Senparc - 20210925
----------------------------------------------------------------*/
using Senparc.Weixin.TenPayV3.Entities;
using Senparc.Weixin.TenPayV3.Helpers;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace Senparc.Weixin.TenPayV3.Apis.VehicleParking
{
///
/// 扣费受理接口请求数据
/// 详细请参考微信支付官方文档 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter8_8_3.shtml
///
public class PayParkingRequestData
{
///
/// 含参构造函数
///
/// 应用ID bodyappid是商户在微信申请公众号或移动应用成功后分配的账号ID,登录平台为mp.weixin.qq.com或open.weixin.qq.com示例值:wxcbda96de0b165486
/// 服务描述 body商户自定义字段,用于交易账单中对扣费服务的描述。示例值:停车场扣费
/// 附加数据 body附加数据,在查询API和支付通知中原样返回,可作为自定义参数使用示例值:深圳分店可为null
/// 商户订单号 body商户系统内部订单号,只能是数字、大小写字母,且在同一个商户号下唯一示例值:20150806125346
/// 交易场景 body交易场景值,目前支持PARKING:车场停车场景示例值:PARKING
/// 订单优惠标记 body代金券或立减优惠功能的参数,说明详见代金券或立减优惠示例值:WXG可为null
/// 回调通知url body接受扣款结果异步回调通知的url,注意回调url只接受https示例值:https://yoursite.com/wxpay.html
/// 分账标识 body枚举值:Y:是,需要分账N:否,不分账字母要求大写,不传默认不分账,分账详细说明见直连分账API、服务商分账API文档示例值:Y可为null
/// 订单金额 body订单金额信息
/// 停车场景信息 body当交易场景为PARKING时,需要在该字段添加停车场景信息可为null
public PayParkingRequestData(string appid, string description, string attach, string out_trade_no, string trade_scene, string goods_tag, string notify_url, string profit_sharing, Amount amount, Parking_Info parking_info)
{
this.appid = appid;
this.description = description;
this.attach = attach;
this.out_trade_no = out_trade_no;
this.trade_scene = trade_scene;
this.goods_tag = goods_tag;
this.notify_url = notify_url;
this.profit_sharing = profit_sharing;
this.amount = amount;
this.parking_info = parking_info;
}
///
/// 无参构造函数
///
public PayParkingRequestData()
{
}
///
/// 应用ID
/// bodyappid是商户在微信申请公众号或移动应用成功后分配的账号ID,登录平台为mp.weixin.qq.com或open.weixin.qq.com
/// 示例值:wxcbda96de0b165486
///
public string appid { get; set; }
///
/// 服务描述
/// body商户自定义字段,用于交易账单中对扣费服务的描述。
/// 示例值:停车场扣费
///
public string description { get; set; }
///
/// 附加数据
/// body附加数据,在查询API和支付通知中原样返回,可作为自定义参数使用
/// 示例值:深圳分店
/// 可为null
///
public string attach { get; set; }
///
/// 商户订单号
/// body商户系统内部订单号,只能是数字、大小写字母,且在同一个商户号下唯一
/// 示例值:20150806125346
///
public string out_trade_no { get; set; }
///
/// 交易场景
/// body交易场景值,目前支持 PARKING:车场停车场景
/// 示例值:PARKING
///
public string trade_scene { get; set; }
///
/// 订单优惠标记
/// body代金券或立减优惠功能的参数,说明详见 代金券或立减优惠
/// 示例值:WXG
/// 可为null
///
public string goods_tag { get; set; }
///
/// 回调通知url
/// body接受扣款结果异步回调通知的url,注意回调url只接受https
/// 示例值:https://yoursite.com/wxpay.html
///
public string notify_url { get; set; }
///
/// 分账标识
/// body枚举值: Y:是,需要分账 N:否,不分账 字母要求大写,不传默认不分账,分账详细说明见直连分账API、服务商分账API文档
/// 示例值:Y
/// 可为null
///
public string profit_sharing { get; set; }
///
/// 订单金额
/// body订单金额信息
///
public Amount amount { get; set; }
///
/// 停车场景信息
/// body当交易场景为PARKING时,需要在该字段添加停车场景信息
/// 可为null
///
public Parking_Info parking_info { get; set; }
#region 子数据类型
public class Amount
{
///
/// 含参构造函数
///
/// 订单金额 订单总金额,单位为分,只能为整数示例值:888
/// 货币类型 符合ISO4217标准的三位字母代码,目前只支持人民币:CNY示例值:CNY
public Amount(int total, string currency)
{
this.total = total;
this.currency = currency;
}
///
/// 无参构造函数
///
public Amount()
{
}
///
/// 订单金额
/// 订单总金额,单位为分,只能为整数
/// 示例值:888
///
public int total { get; set; }
///
/// 货币类型
/// 符合ISO 4217标准的三位字母代码,目前只支持人民币:CNY
/// 示例值:CNY
///
public string currency { get; set; }
}
public class Parking_Info
{
///
/// 含参构造函数
///
/// 停车入场id 微信支付分停车服务为商户分配的入场id,商户通过入场通知接口获取入场id示例值:5K8264ILTKCH16CQ250
/// 车牌号 车牌号,仅包括省份+车牌,不包括特殊字符。示例值:粤B888888
/// 车牌颜色 车牌颜色,枚举值:BLUE:蓝色GREEN:绿色YELLOW:黄色BLACK:黑色WHITE:白色LIMEGREEN:黄绿色示例值:BLUE
/// 入场时间 用户入场时间,遵循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秒。示例值:2017-08-26T10:43:39+08:00
/// 出场时间 用户出场时间,遵循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秒。示例值:2017-08-26T10:43:39+08:00
/// 停车场名称 所在停车位车场的名称示例值:欢乐海岸停车场
/// 计费时长 计费的时间长,单位为秒示例值:3600
/// 停车场设备id 停车场设备id示例值:12313
public Parking_Info(string parking_id, string plate_number, string plate_color, string start_time, string end_time, string parking_name, int charging_duration, string device_id)
{
this.parking_id = parking_id;
this.plate_number = plate_number;
this.plate_color = plate_color;
this.start_time = start_time;
this.end_time = end_time;
this.parking_name = parking_name;
this.charging_duration = charging_duration;
this.device_id = device_id;
}
///
/// 由CreateParkingReturnJson类型生成结算停车数据 并且自动计算计费时长
///
///
public Parking_Info(CreateParkingReturnJson createParkingReturnJson)
{
this.parking_id = createParkingReturnJson.id;
this.plate_number = createParkingReturnJson.plate_number;
this.plate_color = createParkingReturnJson.plate_color;
this.start_time = createParkingReturnJson.start_time;
this.parking_name = createParkingReturnJson.parking_name;
// 记录出场时间并计算收费时长
this.end_time = DateTime.Now.ToString();
this.charging_duration = (new TimeSpan(TenPayDateTimeHelper.PraseDateTimeFromString(end_time).Ticks) - new TimeSpan(TenPayDateTimeHelper.PraseDateTimeFromString(start_time).Ticks)).Seconds - createParkingReturnJson.free_duration;
}
///
/// 无参构造函数
///
public Parking_Info()
{
}
///
/// 停车入场id
/// 微信支付分停车服务为商户分配的入场id,商户通过入场通知接口获取入场id
/// 示例值:5K8264ILTKCH16CQ250
///
public string parking_id { get; set; }
///
/// 车牌号
/// 车牌号,仅包括省份+车牌,不包括特殊字符。
/// 示例值:粤B888888
///
public string plate_number { get; set; }
///
/// 车牌颜色
/// 车牌颜色,枚举值: BLUE:蓝色 GREEN:绿色 YELLOW:黄色 BLACK:黑色 WHITE:白色 LIMEGREEN:黄绿色
/// 示例值:BLUE
///
public string plate_color { get; set; }
///
/// 入场时间
/// 用户入场时间,遵循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秒。
/// 示例值:2017-08-26T10:43:39+08:00
///
public string start_time { get; set; }
///
/// 出场时间
/// 用户出场时间,遵循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秒。
/// 示例值:2017-08-26T10:43:39+08:00
///
public string end_time { get; set; }
///
/// 停车场名称
/// 所在停车位车场的名称
/// 示例值:欢乐海岸停车场
///
public string parking_name { get; set; }
///
/// 计费时长
/// 计费的时间长,单位为秒
/// 示例值:3600
///
public int charging_duration { get; set; }
///
/// 停车场设备id
/// 停车场设备id
/// 示例值:12313
///
public string device_id { get; set; }
}
#endregion
}
}