feat(api): add service location attributes to auth_rules, fields to merchant

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 189
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-5f3c4878ed085a0e8925abdf14ed250ba25b04d5a128e3edd81f28be5fd79b69.yml
-openapi_spec_hash: f2cc51f780daf0454712a4f73b9c8302
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-7fb459122adaf544433c3d5acd17566e642289b3eccb7ee25d7b7ce418967e32.yml
+openapi_spec_hash: fe69fbb129fa5b7d7b1e71d4f2a908f1
 config_hash: 400b9afe0f7f7b7d96177d05950775f9

src/lithic/types/auth_rules/conditional_authorization_action_parameters.py

@@ -31,6 +31,8 @@ class Condition(BaseModel):
         "WALLET_TYPE",
         "TRANSACTION_INITIATOR",
         "ADDRESS_MATCH",
+        "SERVICE_LOCATION_STATE",
+        "SERVICE_LOCATION_POSTAL_CODE",
         "CARD_AGE",
         "ACCOUNT_AGE",
     ]
@@ -88,6 +90,14 @@ class Condition(BaseModel):
     - `ADDRESS_MATCH`: Lithic's evaluation result comparing transaction's address
       data with the cardholder KYC data if it exists. Valid values are `MATCH`,
       `MATCH_ADDRESS_ONLY`, `MATCH_ZIP_ONLY`,`MISMATCH`,`NOT_PRESENT`.
+    - `SERVICE_LOCATION_STATE`: The state/province code (ISO 3166-2) where the
+      cardholder received the service, e.g. "NY". When a service location is present
+      in the network data, the service location state is used. Otherwise, falls back
+      to the card acceptor state.
+    - `SERVICE_LOCATION_POSTAL_CODE`: The postal code where the cardholder received
+      the service, e.g. "10001". When a service location is present in the network
+      data, the service location postal code is used. Otherwise, falls back to the
+      card acceptor postal code.
     - `CARD_AGE`: The age of the card in seconds at the time of the authorization.
     - `ACCOUNT_AGE`: The age of the account holder's account in seconds at the time
       of the authorization.

src/lithic/types/auth_rules/conditional_authorization_action_parameters_param.py

@@ -34,6 +34,8 @@ class Condition(TypedDict, total=False):
             "WALLET_TYPE",
             "TRANSACTION_INITIATOR",
             "ADDRESS_MATCH",
+            "SERVICE_LOCATION_STATE",
+            "SERVICE_LOCATION_POSTAL_CODE",
             "CARD_AGE",
             "ACCOUNT_AGE",
         ]
@@ -92,6 +94,14 @@ class Condition(TypedDict, total=False):
     - `ADDRESS_MATCH`: Lithic's evaluation result comparing transaction's address
       data with the cardholder KYC data if it exists. Valid values are `MATCH`,
       `MATCH_ADDRESS_ONLY`, `MATCH_ZIP_ONLY`,`MISMATCH`,`NOT_PRESENT`.
+    - `SERVICE_LOCATION_STATE`: The state/province code (ISO 3166-2) where the
+      cardholder received the service, e.g. "NY". When a service location is present
+      in the network data, the service location state is used. Otherwise, falls back
+      to the card acceptor state.
+    - `SERVICE_LOCATION_POSTAL_CODE`: The postal code where the cardholder received
+      the service, e.g. "10001". When a service location is present in the network
+      data, the service location postal code is used. Otherwise, falls back to the
+      card acceptor postal code.
     - `CARD_AGE`: The age of the card in seconds at the time of the authorization.
     - `ACCOUNT_AGE`: The age of the account holder's account in seconds at the time
       of the authorization.

src/lithic/types/card_authorization_approval_request_webhook_event.py

@@ -4,10 +4,10 @@
 from datetime import datetime
 from typing_extensions import Literal
 
+from .shared import merchant
 from .._models import BaseModel
 from .token_info import TokenInfo
 from .shared.currency import Currency
-from .shared.merchant import Merchant
 from .cardholder_authentication import CardholderAuthentication
 
 __all__ = [
@@ -19,6 +19,8 @@
     "AmountsSettlement",
     "Avs",
     "Card",
+    "Merchant",
+    "ServiceLocation",
     "FleetInfo",
     "LatestChallenge",
     "NetworkSpecificData",
@@ -141,6 +143,40 @@ class Card(BaseModel):
     type: Optional[Literal["SINGLE_USE", "MERCHANT_LOCKED", "UNLOCKED", "PHYSICAL", "DIGITAL_WALLET", "VIRTUAL"]] = None
 
 
+class Merchant(merchant.Merchant):
+    """Merchant information including full location details."""
+
+    phone_number: Optional[str] = None
+    """Phone number of card acceptor."""
+
+    postal_code: Optional[str] = None
+    """Postal code of card acceptor."""
+
+    street_address: Optional[str] = None
+    """Street address of card acceptor."""
+
+
+class ServiceLocation(BaseModel):
+    """
+    Where the cardholder received the service, when different from the card acceptor location. This is populated from network data elements such as Mastercard DE-122 SE1 SF9-14 and Visa F34 DS02.
+    """
+
+    city: Optional[str] = None
+    """City of service location."""
+
+    country: Optional[str] = None
+    """Country code of service location, ISO 3166-1 alpha-3."""
+
+    postal_code: Optional[str] = None
+    """Postal code of service location."""
+
+    state: Optional[str] = None
+    """State/province code of service location, ISO 3166-2."""
+
+    street_address: Optional[str] = None
+    """Street address of service location."""
+
+
 class FleetInfo(BaseModel):
     """
     Optional Object containing information if the Card is a part of a Fleet managed program
@@ -412,6 +448,7 @@ class CardAuthorizationApprovalRequestWebhookEvent(BaseModel):
     event_type: Literal["card_authorization.approval_request"]
 
     merchant: Merchant
+    """Merchant information including full location details."""
 
     merchant_amount: int
     """Deprecated, use `amounts`.
@@ -426,6 +463,13 @@ class CardAuthorizationApprovalRequestWebhookEvent(BaseModel):
     merchant_currency: str
     """3-character alphabetic ISO 4217 code for the local currency of the transaction."""
 
+    service_location: Optional[ServiceLocation] = None
+    """
+    Where the cardholder received the service, when different from the card acceptor
+    location. This is populated from network data elements such as Mastercard DE-122
+    SE1 SF9-14 and Visa F34 DS02.
+    """
+
     settled_amount: int
     """Deprecated, use `amounts`.
 

src/lithic/types/transaction.py

@@ -4,10 +4,10 @@
 from datetime import datetime
 from typing_extensions import Literal
 
+from .shared import merchant
 from .._models import BaseModel
 from .token_info import TokenInfo
 from .shared.currency import Currency
-from .shared.merchant import Merchant
 from .cardholder_authentication import CardholderAuthentication
 
 __all__ = [
@@ -18,9 +18,11 @@
     "AmountsMerchant",
     "AmountsSettlement",
     "Avs",
+    "Merchant",
     "Pos",
     "PosEntryMode",
     "PosTerminal",
+    "ServiceLocation",
     "Event",
     "EventAmounts",
     "EventAmountsCardholder",
@@ -98,6 +100,19 @@ class Avs(BaseModel):
     """Cardholder ZIP code"""
 
 
+class Merchant(merchant.Merchant):
+    """Merchant information including full location details."""
+
+    phone_number: Optional[str] = None
+    """Phone number of card acceptor."""
+
+    postal_code: Optional[str] = None
+    """Postal code of card acceptor."""
+
+    street_address: Optional[str] = None
+    """Street address of card acceptor."""
+
+
 class PosEntryMode(BaseModel):
     card: Literal["NOT_PRESENT", "PREAUTHORIZED", "PRESENT", "UNKNOWN"]
     """Card presence indicator"""
@@ -206,6 +221,27 @@ class Pos(BaseModel):
     terminal: PosTerminal
 
 
+class ServiceLocation(BaseModel):
+    """
+    Where the cardholder received the service, when different from the card acceptor location. This is populated from network data elements such as Mastercard DE-122 SE1 SF9-14 and Visa F34 DS02.
+    """
+
+    city: Optional[str] = None
+    """City of service location."""
+
+    country: Optional[str] = None
+    """Country code of service location, ISO 3166-1 alpha-3."""
+
+    postal_code: Optional[str] = None
+    """Postal code of service location."""
+
+    state: Optional[str] = None
+    """State/province code of service location, ISO 3166-2."""
+
+    street_address: Optional[str] = None
+    """Street address of service location."""
+
+
 class EventAmountsCardholder(BaseModel):
     amount: int
     """Amount of the event in the cardholder billing currency."""
@@ -667,6 +703,7 @@ class Transaction(BaseModel):
     financial_account_token: Optional[str] = None
 
     merchant: Merchant
+    """Merchant information including full location details."""
 
     merchant_amount: Optional[int] = None
     """Analogous to the 'amount', but in the merchant currency."""
@@ -723,6 +760,13 @@ class Transaction(BaseModel):
         "USER_TRANSACTION_LIMIT",
     ]
 
+    service_location: Optional[ServiceLocation] = None
+    """
+    Where the cardholder received the service, when different from the card acceptor
+    location. This is populated from network data elements such as Mastercard DE-122
+    SE1 SF9-14 and Visa F34 DS02.
+    """
+
     settled_amount: int
     """The settled amount of the transaction in the settlement currency."""