DotNetCore.SKIT.FlurlHttpClient.Wechat/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/WechatTenpayClientOptions.cs

namespace SKIT.FlurlHttpClient.Wechat.TenpayV3
{
    /// <summary>
    /// 一个用于构造 <see cref="WechatTenpayClient"/> 时使用的配置项。
    /// </summary>
    public class WechatTenpayClientOptions
    {
        /// <summary>
        /// 获取或设置请求超时时间（单位：毫秒）。
        /// <para>
        /// 默认值：30000
        /// </para>
        /// </summary>
        public int Timeout { get; set; } = 30 * 1000;

        /// <summary>
        /// 获取或设置微信支付 API 入口点。
        /// <para>
        /// 默认值：<see cref="WechatTenpayEndpoints.DEFAULT"/>
        /// </para>
        /// </summary>
        public string Endpoint { get; set; } = WechatTenpayEndpoints.DEFAULT;

        /// <summary>
        /// 获取或设置声明应答中的错误描述使用的自然语言语种。
        /// <para>
        /// 默认值："zh-CN"
        /// </para>
        /// </summary>
        public string AcceptLanguage { get; set; } = "zh-CN";

        /// <summary>
        /// 获取或设置微信支付 API 签名认证方式。
        /// <para>
        /// 默认值：<see cref="Constants.SignSchemes.WECHATPAY2_RSA_2048_WITH_SHA256"/>
        /// </para>
        /// </summary>
        public string SignScheme { get; set; } = Constants.SignSchemes.WECHATPAY2_RSA_2048_WITH_SHA256;

        /// <summary>
        /// 获取或设置微信支付商户号。
        /// </summary>
        public string MerchantId { get; set; } = default!;

        /// <summary>
        /// 获取或设置微信支付商户 API v3 密钥（注意与 API 密钥相区分）。
        /// </summary>
        public string MerchantV3Secret { get; set; } = default!;

        /// <summary>
        /// 获取或设置微信支付商户 API 证书序列号。
        /// </summary>
        public string MerchantCertificateSerialNumber { get; set; } = default!;

        /// <summary>
        /// 获取或设置微信支付商户 API 证书私钥（通常为 `apiclient_key.pem` 文件内容）。
        /// </summary>
        public string MerchantCertificatePrivateKey { get; set; } = default!;

        /// <summary>
        /// 获取或设置是否自动加密请求中的敏感字段数据。
        /// <para>
        /// 注意：启用该功能需配合 <see cref="PlatformCertificateManager"/> 使用。
        /// </para>
        /// </summary>
        public bool AutoEncryptRequestSensitiveProperty { get; set; }

        /// <summary>
        /// 获取或设置是否自动解密响应中的敏感字段数据。
        /// <para>
        /// 注意：启用该功能需配合 <see cref="PlatformCertificateManager"/> 使用。
        /// </para>
        /// </summary>
        public bool AutoDecryptResponseSensitiveProperty { get; set; }

        /// <summary>
        /// 获取或设置微信支付平台 API 认证方案回退开关。<br/>
        /// 开启后会在验证签名时根据响应或回调中接收到的序列号自动推测使用哪种认证方案。<br/>
        /// 开启后会有一定的性能损失，建议仅在灰度切换期间时开启，待切换进度为百分之百后请关闭。
        /// <para>
        /// 默认值：false
        /// </para>
        /// </summary>
        public bool PlatformAuthFallbackSwitch { get; set; }

        /// <summary>
        /// 获取或设置微信支付平台 API 认证方案。
        /// <para>默认值：<see cref="Settings.PlatformAuthScheme.Certificate"/></para>
        /// </summary>
        public Settings.PlatformAuthScheme PlatformAuthScheme { get; set; } = Settings.PlatformAuthScheme.Certificate;

        /// <summary>
        /// 获取或设置微信支付平台证书管理器。
        /// <para>
        /// 仅当 <see cref="PlatformAuthScheme"/> 的值为 <see cref="Settings.PlatformAuthScheme.Certificate"/>，或开启 <see cref="PlatformAuthSchemaFallback"/> 开关时有效。
        /// </para>
        /// <para>
        /// 默认值：<see cref="Settings.InMemoryCertificateManager"/>
        /// </para>
        /// </summary>
        public Settings.ICertificateManager PlatformCertificateManager { get; set; } = new Settings.InMemoryCertificateManager();

        /// <summary>
        /// 获取或设置微信支付平台公钥管理器。
        /// <para>
        /// 仅当 <see cref="PlatformAuthScheme"/> 的值为 <see cref="Settings.PlatformAuthScheme.PublicKey"/>，或开启 <see cref="PlatformAuthSchemaFallback"/> 开关时有效。
        /// </para>
        /// <para>
        /// 默认值：<see cref="Settings.InMemoryPublicKeyManager"/>
        /// </para>
        /// </summary>
        public Settings.IPublicKeyManager PlatformPublicKeyManager { get; set; } = new Settings.InMemoryPublicKeyManager();
    }
}