feat(api): add psd2_context field and types to three_ds_authentication

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 217
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-6acbf033ded2c03ed5d5c64b6bea9f3250323bf7879a11e9c545aa30e65b3cca.yml
-openapi_spec_hash: c6007083223ccff12c5c15bc9e531b41
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-e1085922e2d7ee4ce3122f1d9dfe675877f5551a591630592cfea38bd6fea9ed.yml
+openapi_spec_hash: e9ca63bde70f9e3953e0a135e7daf185
 config_hash: b314c3c5c82a483d1a7812b31b1d1fc4

src/lithic/types/three_ds_authentication.py

@@ -17,6 +17,7 @@
     "App",
     "Browser",
     "ChallengeMetadata",
+    "Psd2Context",
     "Transaction",
 ]
 
@@ -401,6 +402,61 @@ class ChallengeMetadata(BaseModel):
     """The phone number used for delivering the OTP. Relevant only for SMS_OTP method."""
 
 
+class Psd2Context(BaseModel):
+    """PSD2/SCA context for EEA and UK transactions.
+
+    Present when Lithic determines the transaction is in scope for PSD2 Strong Customer Authentication. Absent for out-of-scope transactions.
+    """
+
+    acquirer_exemption: Optional[
+        Literal[
+            "NONE",
+            "TRANSACTION_RISK_ANALYSIS",
+            "LOW_VALUE",
+            "RECURRING_PAYMENT",
+            "MERCHANT_INITIATED_TRANSACTION",
+            "TRUSTED_BENEFICIARY",
+            "STRONG_CUSTOMER_AUTHENTICATION_DELEGATION",
+            "SECURE_CORPORATE_PAYMENT",
+            "AUTHENTICATION_OUTAGE_EXCEPTION",
+            "BUNDLED",
+        ]
+    ] = None
+    """SCA exemption declared by the acquirer in the 3DS authentication request.
+
+    - `NONE` - No exemption claimed
+    - `TRANSACTION_RISK_ANALYSIS` - Transaction Risk Analysis (TRA) exemption;
+      acquirer asserts low fraud risk
+    - `LOW_VALUE` - Low-value payment exemption; transaction is below the EUR 30
+      threshold
+    - `RECURRING_PAYMENT` - Recurring payment with a fixed amount to the same payee
+    - `MERCHANT_INITIATED_TRANSACTION` - Merchant-initiated transaction (MIT);
+      cardholder not present
+    - `TRUSTED_BENEFICIARY` - Trusted beneficiary; merchant is on cardholder's
+      whitelist
+    - `STRONG_CUSTOMER_AUTHENTICATION_DELEGATION` - SCA already performed by a
+      delegated third-party authenticator
+    - `SECURE_CORPORATE_PAYMENT` - Secure corporate payment using a dedicated
+      corporate card or process
+    - `AUTHENTICATION_OUTAGE_EXCEPTION` - Authentication outage exception;
+      scheme-level fallback during ACS downtime
+    - `BUNDLED` - Mastercard only; bundled exemption code where the exact exemption
+      type cannot be distinguished
+    """
+
+    lithic_exemption_validation: Optional[Literal["ACCEPTED", "REJECTED", "NOT_VALIDATED"]] = None
+    """Lithic's validation of the acquirer-declared exemption.
+
+    Absent when no acquirer exemption was declared.
+
+    - `ACCEPTED` - Lithic signals support the acquirer's claim
+    - `REJECTED` - Lithic signals contradict the claim, or a required signal is
+      missing
+    - `NOT_VALIDATED` - Exemption was declared but Lithic has no basis to evaluate
+      it; treated as `REJECTED` for challenge purposes
+    """
+
+
 class Transaction(BaseModel):
     """
     Object containing data about the e-commerce transaction for which the merchant is requesting authentication.
@@ -593,6 +649,13 @@ class ThreeDSAuthentication(BaseModel):
     (e.g. in-flight customer decisioning request).
     """
 
+    psd2_context: Optional[Psd2Context] = None
+    """PSD2/SCA context for EEA and UK transactions.
+
+    Present when Lithic determines the transaction is in scope for PSD2 Strong
+    Customer Authentication. Absent for out-of-scope transactions.
+    """
+
     three_ri_request_type: Optional[
         Literal[
             "ACCOUNT_VERIFICATION",