feat(api): add models for merchant_lock_parameters and conditional_3ds_action_parameters

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 164
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-80f2056989855259782c8e23b9b95530b708b87669d2ba82594ecfee843b4db3.yml
 openapi_spec_hash: 160aa2f0e95a7be3ad9d68390ae9aa7c
-config_hash: 1a83dceb58f6f525b19a5775018db7e8
+config_hash: a5d12cd64a37624cbe350cd7b2380693

api.md

@@ -81,8 +81,10 @@ Types:
 from lithic.types.auth_rules import (
     AuthRule,
     AuthRuleCondition,
+    Conditional3DSActionParameters,
     ConditionalAttribute,
     ConditionalBlockParameters,
+    MerchantLockParameters,
     RuleStats,
     VelocityLimitParams,
     VelocityLimitParamsPeriodWindow,

src/lithic/types/auth_rules/__init__.py

@@ -19,10 +19,16 @@
 from .v2_retrieve_response import V2RetrieveResponse as V2RetrieveResponse
 from .conditional_attribute import ConditionalAttribute as ConditionalAttribute
 from .velocity_limit_params import VelocityLimitParams as VelocityLimitParams
+from .merchant_lock_parameters import MerchantLockParameters as MerchantLockParameters
 from .auth_rule_condition_param import AuthRuleConditionParam as AuthRuleConditionParam
 from .v2_retrieve_report_params import V2RetrieveReportParams as V2RetrieveReportParams
 from .v2_retrieve_report_response import V2RetrieveReportResponse as V2RetrieveReportResponse
 from .velocity_limit_params_param import VelocityLimitParamsParam as VelocityLimitParamsParam
 from .conditional_block_parameters import ConditionalBlockParameters as ConditionalBlockParameters
+from .merchant_lock_parameters_param import MerchantLockParametersParam as MerchantLockParametersParam
+from .conditional_3ds_action_parameters import Conditional3DSActionParameters as Conditional3DSActionParameters
 from .conditional_block_parameters_param import ConditionalBlockParametersParam as ConditionalBlockParametersParam
 from .velocity_limit_params_period_window import VelocityLimitParamsPeriodWindow as VelocityLimitParamsPeriodWindow
+from .conditional_3ds_action_parameters_param import (
+    Conditional3DSActionParametersParam as Conditional3DSActionParametersParam,
+)

src/lithic/types/auth_rules/conditional_3ds_action_parameters.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["Conditional3DSActionParameters", "Condition"]
+
+
+class Condition(BaseModel):
+    attribute: Optional[
+        Literal[
+            "MCC",
+            "COUNTRY",
+            "CURRENCY",
+            "MERCHANT_ID",
+            "DESCRIPTOR",
+            "TRANSACTION_AMOUNT",
+            "RISK_SCORE",
+            "MESSAGE_CATEGORY",
+        ]
+    ] = None
+    """The attribute to target.
+
+    The following attributes may be targeted:
+
+    - `MCC`: A four-digit number listed in ISO 18245. An MCC is used to classify a
+      business by the types of goods or services it provides.
+    - `COUNTRY`: Country of entity of card acceptor. Possible values are: (1) all
+      ISO 3166-1 alpha-3 country codes, (2) QZZ for Kosovo, and (3) ANT for
+      Netherlands Antilles.
+    - `CURRENCY`: 3-character alphabetic ISO 4217 code for the merchant currency of
+      the transaction.
+    - `MERCHANT_ID`: Unique alphanumeric identifier for the payment card acceptor
+      (merchant).
+    - `DESCRIPTOR`: Short description of card acceptor.
+    - `TRANSACTION_AMOUNT`: The base transaction amount (in cents) plus the acquirer
+      fee field in the settlement/cardholder billing currency. This is the amount
+      the issuer should authorize against unless the issuer is paying the acquirer
+      fee on behalf of the cardholder.
+    - `RISK_SCORE`: Network-provided score assessing risk level associated with a
+      given authentication. Scores are on a range of 0-999, with 0 representing the
+      lowest risk and 999 representing the highest risk. For Visa transactions,
+      where the raw score has a range of 0-99, Lithic will normalize the score by
+      multiplying the raw score by 10x.
+    - `MESSAGE_CATEGORY`: The category of the authentication being processed.
+    """
+
+    operation: Optional[
+        Literal["IS_ONE_OF", "IS_NOT_ONE_OF", "MATCHES", "DOES_NOT_MATCH", "IS_GREATER_THAN", "IS_LESS_THAN"]
+    ] = None
+    """The operation to apply to the attribute"""
+
+    value: Union[str, int, List[str], None] = None
+    """A regex string, to be used with `MATCHES` or `DOES_NOT_MATCH`"""
+
+
+class Conditional3DSActionParameters(BaseModel):
+    action: Literal["DECLINE", "CHALLENGE"]
+    """The action to take if the conditions are met."""
+
+    conditions: List[Condition]

src/lithic/types/auth_rules/conditional_3ds_action_parameters_param.py

@@ -0,0 +1,59 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Union, Iterable
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["Conditional3DSActionParametersParam", "Condition"]
+
+
+class Condition(TypedDict, total=False):
+    attribute: Literal[
+        "MCC",
+        "COUNTRY",
+        "CURRENCY",
+        "MERCHANT_ID",
+        "DESCRIPTOR",
+        "TRANSACTION_AMOUNT",
+        "RISK_SCORE",
+        "MESSAGE_CATEGORY",
+    ]
+    """The attribute to target.
+
+    The following attributes may be targeted:
+
+    - `MCC`: A four-digit number listed in ISO 18245. An MCC is used to classify a
+      business by the types of goods or services it provides.
+    - `COUNTRY`: Country of entity of card acceptor. Possible values are: (1) all
+      ISO 3166-1 alpha-3 country codes, (2) QZZ for Kosovo, and (3) ANT for
+      Netherlands Antilles.
+    - `CURRENCY`: 3-character alphabetic ISO 4217 code for the merchant currency of
+      the transaction.
+    - `MERCHANT_ID`: Unique alphanumeric identifier for the payment card acceptor
+      (merchant).
+    - `DESCRIPTOR`: Short description of card acceptor.
+    - `TRANSACTION_AMOUNT`: The base transaction amount (in cents) plus the acquirer
+      fee field in the settlement/cardholder billing currency. This is the amount
+      the issuer should authorize against unless the issuer is paying the acquirer
+      fee on behalf of the cardholder.
+    - `RISK_SCORE`: Network-provided score assessing risk level associated with a
+      given authentication. Scores are on a range of 0-999, with 0 representing the
+      lowest risk and 999 representing the highest risk. For Visa transactions,
+      where the raw score has a range of 0-99, Lithic will normalize the score by
+      multiplying the raw score by 10x.
+    - `MESSAGE_CATEGORY`: The category of the authentication being processed.
+    """
+
+    operation: Literal["IS_ONE_OF", "IS_NOT_ONE_OF", "MATCHES", "DOES_NOT_MATCH", "IS_GREATER_THAN", "IS_LESS_THAN"]
+    """The operation to apply to the attribute"""
+
+    value: Union[str, int, List[str]]
+    """A regex string, to be used with `MATCHES` or `DOES_NOT_MATCH`"""
+
+
+class Conditional3DSActionParametersParam(TypedDict, total=False):
+    action: Required[Literal["DECLINE", "CHALLENGE"]]
+    """The action to take if the conditions are met."""
+
+    conditions: Required[Iterable[Condition]]

src/lithic/types/auth_rules/merchant_lock_parameters.py

@@ -0,0 +1,37 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from ..._models import BaseModel
+
+__all__ = ["MerchantLockParameters", "Merchant"]
+
+
+class Merchant(BaseModel):
+    comment: Optional[str] = None
+    """
+    A comment or explanation about the merchant, used internally for rule management
+    purposes.
+    """
+
+    descriptor: Optional[str] = None
+    """
+    Short description of the merchant, often used to provide more human-readable
+    context about the transaction merchant. This is typically the name or label
+    shown on transaction summaries.
+    """
+
+    merchant_id: Optional[str] = None
+    """Unique alphanumeric identifier for the payment card acceptor (merchant).
+
+    This attribute specifies the merchant entity that will be locked or referenced
+    for authorization rules.
+    """
+
+
+class MerchantLockParameters(BaseModel):
+    merchants: List[Merchant]
+    """
+    A list of merchant locks defining specific merchants or groups of merchants
+    (based on descriptors or IDs) that the lock applies to.
+    """

src/lithic/types/auth_rules/merchant_lock_parameters_param.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Required, TypedDict
+
+__all__ = ["MerchantLockParametersParam", "Merchant"]
+
+
+class Merchant(TypedDict, total=False):
+    comment: str
+    """
+    A comment or explanation about the merchant, used internally for rule management
+    purposes.
+    """
+
+    descriptor: str
+    """
+    Short description of the merchant, often used to provide more human-readable
+    context about the transaction merchant. This is typically the name or label
+    shown on transaction summaries.
+    """
+
+    merchant_id: str
+    """Unique alphanumeric identifier for the payment card acceptor (merchant).
+
+    This attribute specifies the merchant entity that will be locked or referenced
+    for authorization rules.
+    """
+
+
+class MerchantLockParametersParam(TypedDict, total=False):
+    merchants: Required[Iterable[Merchant]]
+    """
+    A list of merchant locks defining specific merchants or groups of merchants
+    (based on descriptors or IDs) that the lock applies to.
+    """