feat(api): Add card state attribute to tokenization rules

stainless-app[bot] · stainless-app[bot] · commit 5d2d8a9d58b5 · 2026-01-08T10:25:35.000Z
feat(api): Add event_type to ASA request and 3DS decisioning request
feat(api): Add user defined status to ledger accounts
feat(api): Expose Payment Allocation Details
chore: update code formatting
docs: Update language for Google Web Push Provisioning docs
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 175
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-854de7cc8f79e150ffe98f038ce9f39367010b2bdfffc9992be2738697dc4880.yml
-openapi_spec_hash: fd471b20f3eda1e00cdebf028cbfe867
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-4ecc06edca2cfad4eaf11573611e89823fda5f56370bac5cd02a498a6b277d09.yml
+openapi_spec_hash: 8f4a30bec4348cbde85b1e65bef9189a
 config_hash: 9dddee5f7af579864599849cb28a0770
diff --git a/api.md b/api.md
@@ -822,7 +822,7 @@ from lithic.types import (
     AccountHolderUpdatedWebhookEvent,
     AccountHolderVerificationWebhookEvent,
     AccountHolderDocumentUpdatedWebhookEvent,
-    AsaRequestWebhookEvent,
+    CardAuthorizationApprovalRequestWebhookEvent,
     TokenizationDecisioningRequestWebhookEvent,
     AuthRulesBacktestReportCreatedWebhookEvent,
     BalanceUpdatedWebhookEvent,
@@ -870,6 +870,7 @@ from lithic.types import (
     TokenizationTwoFactorAuthenticationCodeWebhookEvent,
     TokenizationTwoFactorAuthenticationCodeSentWebhookEvent,
     TokenizationUpdatedWebhookEvent,
+    ThreeDSAuthenticationApprovalRequestWebhookEvent,
     DisputeTransactionCreatedWebhookEvent,
     DisputeTransactionUpdatedWebhookEvent,
     ParsedWebhookEvent,
diff --git a/src/lithic/resources/cards/cards.py b/src/lithic/resources/cards/cards.py
@@ -1194,7 +1194,7 @@ def web_provision(
     ) -> CardWebProvisionResponse:
         """
         Allow your cardholders to directly add payment cards to the device's digital
-        wallet from a browser on the web. Currently only suported for Apple Pay.
+        wallet from a browser on the web.
 
         This requires some additional setup and configuration. Please
         [Contact Us](https://lithic.com/contact) or your Customer Success representative
@@ -2376,7 +2376,7 @@ async def web_provision(
     ) -> CardWebProvisionResponse:
         """
         Allow your cardholders to directly add payment cards to the device's digital
-        wallet from a browser on the web. Currently only suported for Apple Pay.
+        wallet from a browser on the web.
 
         This requires some additional setup and configuration. Please
         [Contact Us](https://lithic.com/contact) or your Customer Success representative
diff --git a/src/lithic/resources/financial_accounts/financial_accounts.py b/src/lithic/resources/financial_accounts/financial_accounts.py
@@ -320,6 +320,7 @@ def update_status(
         *,
         status: Literal["OPEN", "CLOSED", "SUSPENDED", "PENDING"],
         substatus: Optional[Literal["CHARGED_OFF_FRAUD", "END_USER_REQUEST", "BANK_REQUEST", "CHARGED_OFF_DELINQUENT"]],
+        user_defined_status: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -335,6 +336,8 @@ def update_status(
 
           substatus: Substatus for the financial account
 
+          user_defined_status: User-defined status for the financial account
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -353,6 +356,7 @@ def update_status(
                 {
                     "status": status,
                     "substatus": substatus,
+                    "user_defined_status": user_defined_status,
                 },
                 financial_account_update_status_params.FinancialAccountUpdateStatusParams,
             ),
@@ -618,6 +622,7 @@ async def update_status(
         *,
         status: Literal["OPEN", "CLOSED", "SUSPENDED", "PENDING"],
         substatus: Optional[Literal["CHARGED_OFF_FRAUD", "END_USER_REQUEST", "BANK_REQUEST", "CHARGED_OFF_DELINQUENT"]],
+        user_defined_status: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -633,6 +638,8 @@ async def update_status(
 
           substatus: Substatus for the financial account
 
+          user_defined_status: User-defined status for the financial account
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -651,6 +658,7 @@ async def update_status(
                 {
                     "status": status,
                     "substatus": substatus,
+                    "user_defined_status": user_defined_status,
                 },
                 financial_account_update_status_params.FinancialAccountUpdateStatusParams,
             ),
diff --git a/src/lithic/types/__init__.py b/src/lithic/types/__init__.py
@@ -95,7 +95,6 @@
 from .tokenization_list_params import TokenizationListParams as TokenizationListParams
 from .tokenization_rule_result import TokenizationRuleResult as TokenizationRuleResult
 from .transfer_limits_response import TransferLimitsResponse as TransferLimitsResponse
-from .asa_request_webhook_event import AsaRequestWebhookEvent as AsaRequestWebhookEvent
 from .book_transfer_list_params import BookTransferListParams as BookTransferListParams
 from .card_get_embed_url_params import CardGetEmbedURLParams as CardGetEmbedURLParams
 from .card_search_by_pan_params import CardSearchByPanParams as CardSearchByPanParams
@@ -334,6 +333,9 @@
 from .transaction_simulate_credit_authorization_params import (
     TransactionSimulateCreditAuthorizationParams as TransactionSimulateCreditAuthorizationParams,
 )
+from .card_authorization_approval_request_webhook_event import (
+    CardAuthorizationApprovalRequestWebhookEvent as CardAuthorizationApprovalRequestWebhookEvent,
+)
 from .digital_wallet_tokenization_updated_webhook_event import (
     DigitalWalletTokenizationUpdatedWebhookEvent as DigitalWalletTokenizationUpdatedWebhookEvent,
 )
@@ -358,6 +360,9 @@
 from .card_transaction_enhanced_data_updated_webhook_event import (
     CardTransactionEnhancedDataUpdatedWebhookEvent as CardTransactionEnhancedDataUpdatedWebhookEvent,
 )
+from .three_ds_authentication_approval_request_webhook_event import (
+    ThreeDSAuthenticationApprovalRequestWebhookEvent as ThreeDSAuthenticationApprovalRequestWebhookEvent,
+)
 from .transaction_simulate_credit_authorization_advice_params import (
     TransactionSimulateCreditAuthorizationAdviceParams as TransactionSimulateCreditAuthorizationAdviceParams,
 )
diff --git a/src/lithic/types/auth_rules/conditional_tokenization_action_parameters.py b/src/lithic/types/auth_rules/conditional_tokenization_action_parameters.py
@@ -81,6 +81,7 @@ class Condition(BaseModel):
         "WALLET_RECOMMENDATION_REASONS",
         "TOKEN_REQUESTOR_ID",
         "WALLET_TOKEN_STATUS",
+        "CARD_STATE",
     ]
     """The attribute to target.
 
@@ -114,6 +115,8 @@ class Condition(BaseModel):
       `TOO_MANY_RECENT_TOKENS`, `UNABLE_TO_ASSESS`.
     - `TOKEN_REQUESTOR_ID`: Unique identifier for the entity requesting the token.
     - `WALLET_TOKEN_STATUS`: The current status of the wallet token.
+    - `CARD_STATE`: The state of the card being tokenized. Valid values are
+      `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`, `PENDING_FULFILLMENT`.
     """
 
     operation: ConditionalOperation
diff --git a/src/lithic/types/auth_rules/conditional_tokenization_action_parameters_param.py b/src/lithic/types/auth_rules/conditional_tokenization_action_parameters_param.py
@@ -80,6 +80,7 @@ class Condition(TypedDict, total=False):
             "WALLET_RECOMMENDATION_REASONS",
             "TOKEN_REQUESTOR_ID",
             "WALLET_TOKEN_STATUS",
+            "CARD_STATE",
         ]
     ]
     """The attribute to target.
@@ -114,6 +115,8 @@ class Condition(TypedDict, total=False):
       `TOO_MANY_RECENT_TOKENS`, `UNABLE_TO_ASSESS`.
     - `TOKEN_REQUESTOR_ID`: Unique identifier for the entity requesting the token.
     - `WALLET_TOKEN_STATUS`: The current status of the wallet token.
+    - `CARD_STATE`: The state of the card being tokenized. Valid values are
+      `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`, `PENDING_FULFILLMENT`.
     """
 
     operation: Required[ConditionalOperation]
diff --git a/src/lithic/types/card_authorization_approval_request_webhook_event.py b/src/lithic/types/card_authorization_approval_request_webhook_event.py
@@ -10,7 +10,7 @@
 from .cardholder_authentication import CardholderAuthentication
 
 __all__ = [
-    "AsaRequestWebhookEvent",
+    "CardAuthorizationApprovalRequestWebhookEvent",
     "Avs",
     "Card",
     "FleetInfo",
@@ -293,9 +293,7 @@ class Pos(BaseModel):
     terminal: Optional[PosTerminal] = None
 
 
-class AsaRequestWebhookEvent(BaseModel):
-    """The Auth Stream Access request payload that was sent to the ASA responder."""
-
+class CardAuthorizationApprovalRequestWebhookEvent(BaseModel):
     token: str
     """The provisional transaction group uuid associated with the authorization"""
 
@@ -340,6 +338,8 @@ class AsaRequestWebhookEvent(BaseModel):
     created: datetime
     """Date and time when the transaction first occurred in UTC."""
 
+    event_type: Literal["card_authorization.approval_request"]
+
     merchant: Merchant
 
     merchant_amount: int
diff --git a/src/lithic/types/financial_account.py b/src/lithic/types/financial_account.py
@@ -46,6 +46,11 @@ class FinancialAccount(BaseModel):
     status: Literal["OPEN", "CLOSED", "SUSPENDED", "PENDING"]
     """Status of the financial account"""
 
+    substatus: Optional[
+        Literal["CHARGED_OFF_DELINQUENT", "CHARGED_OFF_FRAUD", "END_USER_REQUEST", "BANK_REQUEST", "DELINQUENT"]
+    ] = None
+    """Substatus for the financial account"""
+
     type: Literal[
         "ISSUING",
         "RESERVE",
@@ -61,11 +66,9 @@ class FinancialAccount(BaseModel):
 
     updated: datetime
 
+    user_defined_status: Optional[str] = None
+    """User-defined status for the financial account"""
+
     account_number: Optional[str] = None
 
     routing_number: Optional[str] = None
-
-    substatus: Optional[
-        Literal["CHARGED_OFF_DELINQUENT", "CHARGED_OFF_FRAUD", "END_USER_REQUEST", "BANK_REQUEST", "DELINQUENT"]
-    ] = None
-    """Substatus for the financial account"""
diff --git a/src/lithic/types/financial_account_update_status_params.py b/src/lithic/types/financial_account_update_status_params.py
@@ -16,3 +16,6 @@ class FinancialAccountUpdateStatusParams(TypedDict, total=False):
         Optional[Literal["CHARGED_OFF_FRAUD", "END_USER_REQUEST", "BANK_REQUEST", "CHARGED_OFF_DELINQUENT"]]
     ]
     """Substatus for the financial account"""
+
+    user_defined_status: str
+    """User-defined status for the financial account"""
diff --git a/src/lithic/types/financial_accounts/loan_tape.py b/src/lithic/types/financial_accounts/loan_tape.py
@@ -16,6 +16,7 @@
     "Balances",
     "InterestDetails",
     "MinimumPaymentBalance",
+    "PaymentAllocation",
     "PreviousStatementBalance",
 ]
 
@@ -101,6 +102,23 @@ class MinimumPaymentBalance(BaseModel):
     remaining: int
 
 
+class PaymentAllocation(BaseModel):
+    fee_details: Optional[CategoryDetails] = None
+
+    fees: int
+    """Amount allocated to fees in cents"""
+
+    interest: int
+    """Amount allocated to interest in cents"""
+
+    interest_details: Optional[CategoryDetails] = None
+
+    principal: int
+    """Amount allocated to principal in cents"""
+
+    principal_details: Optional[CategoryDetails] = None
+
+
 class PreviousStatementBalance(BaseModel):
     amount: int
 
@@ -154,7 +172,7 @@ class LoanTape(BaseModel):
 
     minimum_payment_balance: MinimumPaymentBalance
 
-    payment_allocation: CategoryBalances
+    payment_allocation: PaymentAllocation
 
     period_totals: StatementTotals
 
diff --git a/src/lithic/types/parsed_webhook_event.py b/src/lithic/types/parsed_webhook_event.py
@@ -6,8 +6,6 @@
 
 from .._models import BaseModel
 from .kyb_business_entity import KYBBusinessEntity
-from .three_ds_authentication import ThreeDSAuthentication
-from .asa_request_webhook_event import AsaRequestWebhookEvent
 from .card_created_webhook_event import CardCreatedWebhookEvent
 from .card_renewed_webhook_event import CardRenewedWebhookEvent
 from .card_shipped_webhook_event import CardShippedWebhookEvent
@@ -52,9 +50,11 @@
 from .three_ds_authentication_challenge_webhook_event import ThreeDSAuthenticationChallengeWebhookEvent
 from .auth_rules_backtest_report_created_webhook_event import AuthRulesBacktestReportCreatedWebhookEvent
 from .digital_wallet_tokenization_result_webhook_event import DigitalWalletTokenizationResultWebhookEvent
+from .card_authorization_approval_request_webhook_event import CardAuthorizationApprovalRequestWebhookEvent
 from .digital_wallet_tokenization_updated_webhook_event import DigitalWalletTokenizationUpdatedWebhookEvent
 from .card_transaction_enhanced_data_created_webhook_event import CardTransactionEnhancedDataCreatedWebhookEvent
 from .card_transaction_enhanced_data_updated_webhook_event import CardTransactionEnhancedDataUpdatedWebhookEvent
+from .three_ds_authentication_approval_request_webhook_event import ThreeDSAuthenticationApprovalRequestWebhookEvent
 from .tokenization_two_factor_authentication_code_webhook_event import (
     TokenizationTwoFactorAuthenticationCodeWebhookEvent,
 )
@@ -426,7 +426,7 @@ class LegacyPayload(BaseModel):
     LegacyPayload,
     AccountHolderVerificationWebhookEvent,
     AccountHolderDocumentUpdatedWebhookEvent,
-    AsaRequestWebhookEvent,
+    CardAuthorizationApprovalRequestWebhookEvent,
     TokenizationDecisioningRequestWebhookEvent,
     AuthRulesBacktestReportCreatedWebhookEvent,
     BalanceUpdatedWebhookEvent,
@@ -474,7 +474,7 @@ class LegacyPayload(BaseModel):
     TokenizationTwoFactorAuthenticationCodeWebhookEvent,
     TokenizationTwoFactorAuthenticationCodeSentWebhookEvent,
     TokenizationUpdatedWebhookEvent,
-    ThreeDSAuthentication,
+    ThreeDSAuthenticationApprovalRequestWebhookEvent,
     DisputeTransactionCreatedWebhookEvent,
     DisputeTransactionUpdatedWebhookEvent,
 ]
diff --git a/src/lithic/types/three_ds_authentication_approval_request_webhook_event.py b/src/lithic/types/three_ds_authentication_approval_request_webhook_event.py
@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from .three_ds_authentication import ThreeDSAuthentication
+
+__all__ = ["ThreeDSAuthenticationApprovalRequestWebhookEvent"]
+
+
+class ThreeDSAuthenticationApprovalRequestWebhookEvent(ThreeDSAuthentication):
+    """Represents a 3DS authentication"""
+
+    event_type: Literal["three_ds_authentication.approval_request"]
diff --git a/src/lithic/types/transaction.py b/src/lithic/types/transaction.py
@@ -381,6 +381,7 @@ class EventRuleResult(BaseModel):
         "AUTH_RULE_ALLOWED_MCC",
         "AUTH_RULE_BLOCKED_COUNTRY",
         "AUTH_RULE_BLOCKED_MCC",
+        "AUTH_RULE",
         "CARD_CLOSED",
         "CARD_CRYPTOGRAM_VALIDATION_FAILURE",
         "CARD_EXPIRED",
@@ -495,6 +496,7 @@ class Event(BaseModel):
             "AUTH_RULE_ALLOWED_MCC",
             "AUTH_RULE_BLOCKED_COUNTRY",
             "AUTH_RULE_BLOCKED_MCC",
+            "AUTH_RULE",
             "CARD_CLOSED",
             "CARD_CRYPTOGRAM_VALIDATION_FAILURE",
             "CARD_EXPIRED",
diff --git a/tests/api_resources/test_financial_accounts.py b/tests/api_resources/test_financial_accounts.py
@@ -239,6 +239,16 @@ def test_method_update_status(self, client: Lithic) -> None:
         )
         assert_matches_type(FinancialAccount, financial_account, path=["response"])
 
+    @parametrize
+    def test_method_update_status_with_all_params(self, client: Lithic) -> None:
+        financial_account = client.financial_accounts.update_status(
+            financial_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            status="OPEN",
+            substatus="CHARGED_OFF_FRAUD",
+            user_defined_status="26",
+        )
+        assert_matches_type(FinancialAccount, financial_account, path=["response"])
+
     @parametrize
     def test_raw_response_update_status(self, client: Lithic) -> None:
         response = client.financial_accounts.with_raw_response.update_status(
@@ -503,6 +513,16 @@ async def test_method_update_status(self, async_client: AsyncLithic) -> None:
         )
         assert_matches_type(FinancialAccount, financial_account, path=["response"])
 
+    @parametrize
+    async def test_method_update_status_with_all_params(self, async_client: AsyncLithic) -> None:
+        financial_account = await async_client.financial_accounts.update_status(
+            financial_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            status="OPEN",
+            substatus="CHARGED_OFF_FRAUD",
+            user_defined_status="26",
+        )
+        assert_matches_type(FinancialAccount, financial_account, path=["response"])
+
     @parametrize
     async def test_raw_response_update_status(self, async_client: AsyncLithic) -> None:
         response = await async_client.financial_accounts.with_raw_response.update_status(

Original file line number	Diff line number	Diff line change
`@@ -16,3 +16,6 @@ class FinancialAccountUpdateStatusParams(TypedDict, total=False):`
`16`	`16`	`Optional[Literal["CHARGED_OFF_FRAUD", "END_USER_REQUEST", "BANK_REQUEST", "CHARGED_OFF_DELINQUENT"]]`
`17`	`17`	`]`
`18`	`18`	`"""Substatus for the financial account"""`
	`19`	`+`
	`20`	`+ user_defined_status: str`
	`21`	`+ """User-defined status for the financial account"""`