|
@@ -15,31 +15,31 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public string AdvancePaymentType { get; set; }
|
|
public string AdvancePaymentType { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 代扣业务需要传入协议相关信息
|
|
|
|
|
|
+ /// 代扣信息。 代扣业务需要传入的协议相关信息,使用本参数传入协议号后scene和auth_code不需要再传值。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("agreement_params")]
|
|
[JsonPropertyName("agreement_params")]
|
|
public AgreementParams AgreementParams { get; set; }
|
|
public AgreementParams AgreementParams { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 支付宝的店铺编号
|
|
|
|
|
|
+ /// 支付宝店铺编号。 指商户创建门店后支付宝生成的门店ID。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("alipay_store_id")]
|
|
[JsonPropertyName("alipay_store_id")]
|
|
public string AlipayStoreId { get; set; }
|
|
public string AlipayStoreId { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 支付授权码,25~30开头的长度为16~24位的数字,实际字符串长度以开发者获取的付款码长度为准。 周期扣款(CYCLE_PAY_AUTH )场景必填,传入用户签约号 agreement_no。 支付宝预授权(PRE_AUTH_ONLINE)、新当面资金授权(PRE_AUTH)场景不填,需替换为 auth_no 传入资金授权订单号。
|
|
|
|
|
|
+ /// 支付授权码。 当面付场景传买家的付款码(25~30开头的长度为16~24位的数字,实际字符串长度以开发者获取的付款码长度为准)或者刷脸标识串(fp开头的35位字符串); 周期扣款或代扣场景无需传入,协议号通过agreement_params参数传递; 支付宝预授权和新当面资金授权场景无需传入,授权订单号通过 auth_no字段传入。 注:交易的买家与卖家不能相同。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("auth_code")]
|
|
[JsonPropertyName("auth_code")]
|
|
public string AuthCode { get; set; }
|
|
public string AuthCode { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 预授权确认模式,授权转交易请求中传入,适用于预授权转交易业务使用,目前只支持PRE_AUTH(预授权产品码) COMPLETE:转交易支付完成结束预授权,解冻剩余金额; NOT_COMPLETE:转交易支付完成不结束预授权,不解冻剩余金额
|
|
|
|
|
|
+ /// 预授权确认模式。 适用于支付宝预授权和新当面资金授权场景。枚举值: COMPLETE:转交易完成后解冻剩余冻结金额; NOT_COMPLETE:转交易完成后不解冻剩余冻结金额; 默认值为NOT_COMPLETE。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("auth_confirm_mode")]
|
|
[JsonPropertyName("auth_confirm_mode")]
|
|
public string AuthConfirmMode { get; set; }
|
|
public string AuthConfirmMode { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 支付宝的资金授权订单号,预授权转交易场景必填。目前仅支持 支付宝预授权(PRE_AUTH_ONLINE)、新当面资金授权(PRE_AUTH)场景使用。
|
|
|
|
|
|
+ /// 资金预授权单号。 支付宝预授权和新当面资金授权场景下必填。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("auth_no")]
|
|
[JsonPropertyName("auth_no")]
|
|
public string AuthNo { get; set; }
|
|
public string AuthNo { get; set; }
|
|
@@ -57,19 +57,19 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public BusinessParams BusinessParams { get; set; }
|
|
public BusinessParams BusinessParams { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 买家的支付宝用户 ID,若为空,则从传入的码值信息中获取用户 ID 新当面资金授权场景必填。
|
|
|
|
|
|
+ /// 买家支付宝用户ID。 支付宝预授权和新当面资金授权场景下必填,其它场景不需要传入。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("buyer_id")]
|
|
[JsonPropertyName("buyer_id")]
|
|
public string BuyerId { get; set; }
|
|
public string BuyerId { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 禁用支付渠道,多个渠道以逗号分割,如同时禁用信用支付类型和积分,则disable_pay_channels="credit_group,point"
|
|
|
|
|
|
+ /// 禁用支付渠道。 多个渠道以逗号分割,如同时禁用信用支付类型和积分,则传入:"credit_group,point"。 支持传入的值:<a target="_blank" href="https://docs.open.alipay.com/common/wifww7">渠道列表</a>
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("disable_pay_channels")]
|
|
[JsonPropertyName("disable_pay_channels")]
|
|
public string DisablePayChannels { get; set; }
|
|
public string DisablePayChannels { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。 如果该值未传入,但传入了【订单总金额】和【不可打折金额】,则该值默认为【订单总金额】-【不可打折金额】
|
|
|
|
|
|
+ /// 可打折金额。 参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。 如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】,则必须满足如下条件:【订单总金额】=【可打折金额】+【不可打折金额】。 如果订单金额全部参与优惠计算,则【可打折金额】和【不可打折金额】都无需传入。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("discountable_amount")]
|
|
[JsonPropertyName("discountable_amount")]
|
|
public string DiscountableAmount { get; set; }
|
|
public string DiscountableAmount { get; set; }
|
|
@@ -93,7 +93,7 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public List<GoodsDetail> GoodsDetail { get; set; }
|
|
public List<GoodsDetail> GoodsDetail { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 是否异步支付,传入true时,表明本次期望走异步支付,会先将支付请求受理下来,再异步推进。商户可以通过交易的异步通知或者轮询交易的状态来确定最终的交易结果
|
|
|
|
|
|
+ /// 是否异步支付,传入true时,表明本次期望走异步支付,会先将支付请求受理下来,再异步推进。商户可以通过交易的异步通知或者轮询交易的状态来确定最终的交易结果。 只在代扣场景下有效,其它场景无需传入。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("is_async_pay")]
|
|
[JsonPropertyName("is_async_pay")]
|
|
public bool IsAsyncPay { get; set; }
|
|
public bool IsAsyncPay { get; set; }
|
|
@@ -105,25 +105,31 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public string MerchantOrderNo { get; set; }
|
|
public string MerchantOrderNo { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 商户操作员编号。 新当面资金授权场景必填。
|
|
|
|
|
|
+ /// 商户操作员编号。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("operator_id")]
|
|
[JsonPropertyName("operator_id")]
|
|
public string OperatorId { get; set; }
|
|
public string OperatorId { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 商户订单号,由商家自定义,64个字符以内,仅支持字母、数字、下划线且需保证在商户端不重复。
|
|
|
|
|
|
+ /// 商户订单号。 由商家自定义,64个字符以内,仅支持字母、数字、下划线且需保证在商户端不重复。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("out_trade_no")]
|
|
[JsonPropertyName("out_trade_no")]
|
|
public string OutTradeNo { get; set; }
|
|
public string OutTradeNo { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 公用回传参数,如果请求时传递了该参数,则返回给商户时会回传该参数。支付宝只会在同步返回(包括跳转回商户网站)和异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝。
|
|
|
|
|
|
+ /// 公用回传参数。 如果请求时传递了该参数,支付宝会在异步通知时将该参数原样返回。 本参数必须进行UrlEncode之后才可以发送给支付宝。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("passback_params")]
|
|
[JsonPropertyName("passback_params")]
|
|
public string PassbackParams { get; set; }
|
|
public string PassbackParams { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 产品码,默认 FACE_TO_FACE_PAYMENT(当面付),枚举支持: PRE_AUTH_ONLINE:支付宝预授权。 PRE_AUTH:新当面资金授权。 CYCLE_PAY_AUTH :周期扣款。
|
|
|
|
|
|
+ /// 支付相关参数
|
|
|
|
+ /// </summary>
|
|
|
|
+ [JsonPropertyName("pay_params")]
|
|
|
|
+ public PayParams PayParams { get; set; }
|
|
|
|
+
|
|
|
|
+ /// <summary>
|
|
|
|
+ /// 产品码。 商家和支付宝签约的产品码。 枚举值(点击查看签约情况): <a target="_blank" href="https://opensupport.alipay.com/support/codelab/detail/486/487">FACE_TO_FACE_PAYMENT</a>:当面付产品; <a target="_blank" href="https://opensupport.alipay.com/support/codelab/detail/807/1419">CYCLE_PAY_AUTH</a>:周期扣款产品; GENERAL_WITHHOLDING:代扣产品; <a target="_blank" href="https://opensupport.alipay.com/support/codelab/detail/712/1471">PRE_AUTH_ONLINE</a>:支付宝预授权产品; PRE_AUTH:新当面资金授权产品; 默认值为FACE_TO_FACE_PAYMENT。 注意:非当面付产品使用本接口时,本参数必填。请传入对应产品码。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("product_code")]
|
|
[JsonPropertyName("product_code")]
|
|
public string ProductCode { get; set; }
|
|
public string ProductCode { get; set; }
|
|
@@ -135,7 +141,7 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public PromoParam PromoParams { get; set; }
|
|
public PromoParam PromoParams { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 返回查询选项,商户通过上送该参数来定制同步需要额外返回的信息字段,数组格式。如:["fund_bill_list","voucher_detail_list","discount_goods_detail"]
|
|
|
|
|
|
+ /// 返回参数选项。 商户通过传递该参数来定制同步需要额外返回的信息字段,数组格式。如:["fund_bill_list","voucher_detail_list","discount_goods_detail"]
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("query_options")]
|
|
[JsonPropertyName("query_options")]
|
|
public List<string> QueryOptions { get; set; }
|
|
public List<string> QueryOptions { get; set; }
|
|
@@ -147,19 +153,19 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public string RequestOrgPid { get; set; }
|
|
public string RequestOrgPid { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 描述分账信息,json格式,其它说明详见分账说明
|
|
|
|
|
|
+ /// 分账信息。 json格式,其它说明详见分账说明
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("royalty_info")]
|
|
[JsonPropertyName("royalty_info")]
|
|
public RoyaltyInfo RoyaltyInfo { get; set; }
|
|
public RoyaltyInfo RoyaltyInfo { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 支付场景。条码支付场景固定为:bar_code。 周期扣款后续代扣时必填,固定为 deduct_pay; 新当面资金授权场景固定为 bar_code。 支付宝预授权景无需传入。
|
|
|
|
|
|
+ /// 支付场景。枚举值: bar_code:当面付条码支付场景; security_code:当面付刷脸支付场景,对应的auth_code为fp开头的刷脸标识串; 周期扣款或代扣场景无需传入,协议号通过agreement_params参数传递; 支付宝预授权和新当面资金授权场景无需传入,授权订单号通过 auth_no字段传入。 默认值为bar_code。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("scene")]
|
|
[JsonPropertyName("scene")]
|
|
public string Scene { get; set; }
|
|
public string Scene { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 如果该值为空,则默认为商户签约账号对应的支付宝用户ID。 新当面资金授权场景必填。
|
|
|
|
|
|
+ /// 卖家支付宝用户ID。 当需要指定收款账号时,通过该参数传入,如果该值为空,则默认为商户签约账号对应的支付宝用户ID。 收款账号优先级规则:门店绑定的收款账户>请求传入的seller_id>商户签约账号对应的支付宝用户ID; 注:直付通和机构间联场景下seller_id无需传入或者保持跟pid一致; 如果传入的seller_id与pid不一致,需要联系支付宝小二配置收款关系; 支付宝预授权和新当面资金授权场景下必填。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("seller_id")]
|
|
[JsonPropertyName("seller_id")]
|
|
public string SellerId { get; set; }
|
|
public string SellerId { get; set; }
|
|
@@ -171,49 +177,49 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public string SettleCurrency { get; set; }
|
|
public string SettleCurrency { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 描述结算信息,json格式,详见结算参数说明
|
|
|
|
|
|
+ /// 结算信息、 json格式,详见结算参数说明。 直付通模式下必传。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("settle_info")]
|
|
[JsonPropertyName("settle_info")]
|
|
public SettleInfo SettleInfo { get; set; }
|
|
public SettleInfo SettleInfo { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 商户门店编号。 新当面资金授权场景必填。
|
|
|
|
|
|
+ /// 商户门店编号。 指商户创建门店时输入的门店编号。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("store_id")]
|
|
[JsonPropertyName("store_id")]
|
|
public string StoreId { get; set; }
|
|
public string StoreId { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 间连受理商户信息体,当前只对特殊银行机构特定场景下使用此字段
|
|
|
|
|
|
+ /// 二级商户信息。 直付通模式和机构间连模式下必传,其它场景下不需要传入。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("sub_merchant")]
|
|
[JsonPropertyName("sub_merchant")]
|
|
public SubMerchant SubMerchant { get; set; }
|
|
public SubMerchant SubMerchant { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 商品标题/交易标题/订单标题/订单关键字等。 注意:不可使用特殊字符,如 /,=,& 等。
|
|
|
|
|
|
+ /// 订单标题。 注意:不可使用特殊字符,如 /,=,& 等。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("subject")]
|
|
[JsonPropertyName("subject")]
|
|
public string Subject { get; set; }
|
|
public string Subject { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 商户机具终端编号
|
|
|
|
|
|
+ /// 商户机具终端编号。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("terminal_id")]
|
|
[JsonPropertyName("terminal_id")]
|
|
public string TerminalId { get; set; }
|
|
public string TerminalId { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 商户传入终端设备相关信息,具体值要和支付宝约定
|
|
|
|
|
|
+ /// IOT设备信息。 通过集成IOTSDK的机具发起的交易时传入,取值为IOTSDK生成的业务签名值。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("terminal_params")]
|
|
[JsonPropertyName("terminal_params")]
|
|
public string TerminalParams { get; set; }
|
|
public string TerminalParams { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点, 如 1.5h,可转换为 90m。 当面付场景默认超时时间为3h,且最大时间不超过 3h。若当面付场景设置timeout_express>3h,接口不报错,但是订单将在3小时关闭。
|
|
|
|
|
|
+ /// 订单相对超时时间。 该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点, 如 1.5h,可转换为 90m。 当面付场景默认值为3h; 其它场景默认值为15d;
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("timeout_express")]
|
|
[JsonPropertyName("timeout_express")]
|
|
public string TimeoutExpress { get; set; }
|
|
public string TimeoutExpress { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000] 如果同时传入【可打折金额】和【不可打折金额】,该参数可以不用传入; 如果同时传入了【可打折金额】,【不可打折金额】,【订单总金额】三者,则必须满足如下条件:【订单总金额】=【可打折金额】+【不可打折金额】
|
|
|
|
|
|
+ /// 订单总金额。 单位为元,精确到小数点后两位,取值范围:[0.01,100000000] 。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("total_amount")]
|
|
[JsonPropertyName("total_amount")]
|
|
public string TotalAmount { get; set; }
|
|
public string TotalAmount { get; set; }
|
|
@@ -225,7 +231,7 @@ namespace Essensoft.Paylink.Alipay.Domain
|
|
public string TransCurrency { get; set; }
|
|
public string TransCurrency { get; set; }
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
- /// 不参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。如果该值未传入,但传入了【订单总金额】和【可打折金额】,则该值默认为【订单总金额】-【可打折金额】
|
|
|
|
|
|
+ /// 不可打折金额。 不参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。 如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】,则必须满足如下条件:【订单总金额】=【可打折金额】+【不可打折金额】。 如果订单金额全部参与优惠计算,则【可打折金额】和【不可打折金额】都无需传入。
|
|
/// </summary>
|
|
/// </summary>
|
|
[JsonPropertyName("undiscountable_amount")]
|
|
[JsonPropertyName("undiscountable_amount")]
|
|
public string UndiscountableAmount { get; set; }
|
|
public string UndiscountableAmount { get; set; }
|