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

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

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 176
-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

api.md

@@ -736,7 +736,7 @@ Types:
 - <code><a href="./src/resources/webhooks.ts">AccountHolderUpdatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">AccountHolderVerificationWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">AccountHolderDocumentUpdatedWebhookEvent</a></code>
-- <code><a href="./src/resources/webhooks.ts">AsaRequestWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">CardAuthorizationApprovalRequestWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">TokenizationDecisioningRequestWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">AuthRulesBacktestReportCreatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">BalanceUpdatedWebhookEvent</a></code>
@@ -784,6 +784,7 @@ Types:
 - <code><a href="./src/resources/webhooks.ts">TokenizationTwoFactorAuthenticationCodeWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">TokenizationTwoFactorAuthenticationCodeSentWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">TokenizationUpdatedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">ThreeDSAuthenticationApprovalRequestWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">DisputeTransactionCreatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">DisputeTransactionUpdatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">ParsedWebhookEvent</a></code>

src/client.ts

@@ -203,11 +203,11 @@ import {
   AccountHolderDocumentUpdatedWebhookEvent,
   AccountHolderUpdatedWebhookEvent,
   AccountHolderVerificationWebhookEvent,
-  AsaRequestWebhookEvent,
   AuthRulesBacktestReportCreatedWebhookEvent,
   BalanceUpdatedWebhookEvent,
   BookTransferTransactionCreatedWebhookEvent,
   BookTransferTransactionUpdatedWebhookEvent,
+  CardAuthorizationApprovalRequestWebhookEvent,
   CardConvertedWebhookEvent,
   CardCreatedWebhookEvent,
   CardReissuedWebhookEvent,
@@ -245,6 +245,7 @@ import {
   PaymentTransactionUpdatedWebhookEvent,
   SettlementReportUpdatedWebhookEvent,
   StatementsCreatedWebhookEvent,
+  ThreeDSAuthenticationApprovalRequestWebhookEvent,
   ThreeDSAuthenticationChallengeWebhookEvent,
   ThreeDSAuthenticationCreatedWebhookEvent,
   ThreeDSAuthenticationUpdatedWebhookEvent,
@@ -1503,7 +1504,7 @@ export declare namespace Lithic {
     type AccountHolderUpdatedWebhookEvent as AccountHolderUpdatedWebhookEvent,
     type AccountHolderVerificationWebhookEvent as AccountHolderVerificationWebhookEvent,
     type AccountHolderDocumentUpdatedWebhookEvent as AccountHolderDocumentUpdatedWebhookEvent,
-    type AsaRequestWebhookEvent as AsaRequestWebhookEvent,
+    type CardAuthorizationApprovalRequestWebhookEvent as CardAuthorizationApprovalRequestWebhookEvent,
     type TokenizationDecisioningRequestWebhookEvent as TokenizationDecisioningRequestWebhookEvent,
     type AuthRulesBacktestReportCreatedWebhookEvent as AuthRulesBacktestReportCreatedWebhookEvent,
     type BalanceUpdatedWebhookEvent as BalanceUpdatedWebhookEvent,
@@ -1551,6 +1552,7 @@ export declare namespace Lithic {
     type TokenizationTwoFactorAuthenticationCodeWebhookEvent as TokenizationTwoFactorAuthenticationCodeWebhookEvent,
     type TokenizationTwoFactorAuthenticationCodeSentWebhookEvent as TokenizationTwoFactorAuthenticationCodeSentWebhookEvent,
     type TokenizationUpdatedWebhookEvent as TokenizationUpdatedWebhookEvent,
+    type ThreeDSAuthenticationApprovalRequestWebhookEvent as ThreeDSAuthenticationApprovalRequestWebhookEvent,
     type DisputeTransactionCreatedWebhookEvent as DisputeTransactionCreatedWebhookEvent,
     type DisputeTransactionUpdatedWebhookEvent as DisputeTransactionUpdatedWebhookEvent,
     type ParsedWebhookEvent as ParsedWebhookEvent,

src/resources/auth-rules/v2/v2.ts

@@ -788,6 +788,8 @@ export namespace ConditionalTokenizationActionParameters {
      *   `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`.
      */
     attribute:
       | 'TIMESTAMP'
@@ -799,7 +801,8 @@ export namespace ConditionalTokenizationActionParameters {
       | 'WALLET_RECOMMENDED_DECISION'
       | 'WALLET_RECOMMENDATION_REASONS'
       | 'TOKEN_REQUESTOR_ID'
-      | 'WALLET_TOKEN_STATUS';
+      | 'WALLET_TOKEN_STATUS'
+      | 'CARD_STATE';
 
     /**
      * The operation to apply to the attribute

src/resources/cards/cards.ts

@@ -382,7 +382,7 @@ export class Cards extends APIResource {
 
   /**
    * 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

src/resources/financial-accounts/financial-accounts.ts

@@ -212,6 +212,17 @@ export interface FinancialAccount {
    */
   status: 'OPEN' | 'CLOSED' | 'SUSPENDED' | 'PENDING';
 
+  /**
+   * Substatus for the financial account
+   */
+  substatus:
+    | 'CHARGED_OFF_DELINQUENT'
+    | 'CHARGED_OFF_FRAUD'
+    | 'END_USER_REQUEST'
+    | 'BANK_REQUEST'
+    | 'DELINQUENT'
+    | null;
+
   type:
     | 'ISSUING'
     | 'RESERVE'
@@ -226,20 +237,14 @@ export interface FinancialAccount {
 
   updated: string;
 
+  /**
+   * User-defined status for the financial account
+   */
+  user_defined_status: string | null;
+
   account_number?: string | null;
 
   routing_number?: string | null;
-
-  /**
-   * Substatus for the financial account
-   */
-  substatus?:
-    | 'CHARGED_OFF_DELINQUENT'
-    | 'CHARGED_OFF_FRAUD'
-    | 'END_USER_REQUEST'
-    | 'BANK_REQUEST'
-    | 'DELINQUENT'
-    | null;
 }
 
 export namespace FinancialAccount {
@@ -527,6 +532,11 @@ export interface FinancialAccountUpdateStatusParams {
    * Substatus for the financial account
    */
   substatus: 'CHARGED_OFF_FRAUD' | 'END_USER_REQUEST' | 'BANK_REQUEST' | 'CHARGED_OFF_DELINQUENT' | null;
+
+  /**
+   * User-defined status for the financial account
+   */
+  user_defined_status?: string;
 }
 
 FinancialAccounts.Balances = Balances;

src/resources/financial-accounts/loan-tapes.ts

@@ -132,7 +132,7 @@ export interface LoanTape {
 
   minimum_payment_balance: LoanTape.MinimumPaymentBalance;
 
-  payment_allocation: CategoryBalances;
+  payment_allocation: LoanTape.PaymentAllocation;
 
   period_totals: FinancialAccountsAPI.StatementTotals;
 
@@ -271,6 +271,29 @@ export namespace LoanTape {
     remaining: number;
   }
 
+  export interface PaymentAllocation {
+    fee_details: FinancialAccountsAPI.CategoryDetails | null;
+
+    /**
+     * Amount allocated to fees in cents
+     */
+    fees: number;
+
+    /**
+     * Amount allocated to interest in cents
+     */
+    interest: number;
+
+    interest_details: FinancialAccountsAPI.CategoryDetails | null;
+
+    /**
+     * Amount allocated to principal in cents
+     */
+    principal: number;
+
+    principal_details: FinancialAccountsAPI.CategoryDetails | null;
+  }
+
   export interface PreviousStatementBalance {
     amount: number;
 

src/resources/index.ts

@@ -288,7 +288,7 @@ export {
   type AccountHolderUpdatedWebhookEvent,
   type AccountHolderVerificationWebhookEvent,
   type AccountHolderDocumentUpdatedWebhookEvent,
-  type AsaRequestWebhookEvent,
+  type CardAuthorizationApprovalRequestWebhookEvent,
   type TokenizationDecisioningRequestWebhookEvent,
   type AuthRulesBacktestReportCreatedWebhookEvent,
   type BalanceUpdatedWebhookEvent,
@@ -336,6 +336,7 @@ export {
   type TokenizationTwoFactorAuthenticationCodeWebhookEvent,
   type TokenizationTwoFactorAuthenticationCodeSentWebhookEvent,
   type TokenizationUpdatedWebhookEvent,
+  type ThreeDSAuthenticationApprovalRequestWebhookEvent,
   type DisputeTransactionCreatedWebhookEvent,
   type DisputeTransactionUpdatedWebhookEvent,
   type ParsedWebhookEvent,

src/resources/transactions/transactions.ts

@@ -677,6 +677,7 @@ export namespace Transaction {
       | 'AUTH_RULE_ALLOWED_MCC'
       | 'AUTH_RULE_BLOCKED_COUNTRY'
       | 'AUTH_RULE_BLOCKED_MCC'
+      | 'AUTH_RULE'
       | 'CARD_CLOSED'
       | 'CARD_CRYPTOGRAM_VALIDATION_FAILURE'
       | 'CARD_EXPIRED'
@@ -997,6 +998,7 @@ export namespace Transaction {
         | 'AUTH_RULE_ALLOWED_MCC'
         | 'AUTH_RULE_BLOCKED_COUNTRY'
         | 'AUTH_RULE_BLOCKED_MCC'
+        | 'AUTH_RULE'
         | 'CARD_CLOSED'
         | 'CARD_CRYPTOGRAM_VALIDATION_FAILURE'
         | 'CARD_EXPIRED'

src/resources/webhooks.ts

@@ -665,10 +665,7 @@ export namespace AccountHolderDocumentUpdatedWebhookEvent {
   }
 }
 
-/**
- * The Auth Stream Access request payload that was sent to the ASA responder.
- */
-export interface AsaRequestWebhookEvent {
+export interface CardAuthorizationApprovalRequestWebhookEvent {
   /**
    * The provisional transaction group uuid associated with the authorization
    */
@@ -694,12 +691,12 @@ export interface AsaRequestWebhookEvent {
    */
   authorization_amount: number;
 
-  avs: AsaRequestWebhookEvent.Avs;
+  avs: CardAuthorizationApprovalRequestWebhookEvent.Avs;
 
   /**
    * Card object in ASA
    */
-  card: AsaRequestWebhookEvent.Card;
+  card: CardAuthorizationApprovalRequestWebhookEvent.Card;
 
   /**
    * 3-character alphabetic ISO 4217 code for cardholder's billing currency.
@@ -721,6 +718,8 @@ export interface AsaRequestWebhookEvent {
    */
   created: string;
 
+  event_type: 'card_authorization.approval_request';
+
   merchant: Shared.Merchant;
 
   /**
@@ -788,13 +787,13 @@ export interface AsaRequestWebhookEvent {
    * Optional Object containing information if the Card is a part of a Fleet managed
    * program
    */
-  fleet_info?: AsaRequestWebhookEvent.FleetInfo | null;
+  fleet_info?: CardAuthorizationApprovalRequestWebhookEvent.FleetInfo | null;
 
   /**
    * The latest Authorization Challenge that was issued to the cardholder for this
    * merchant.
    */
-  latest_challenge?: AsaRequestWebhookEvent.LatestChallenge;
+  latest_challenge?: CardAuthorizationApprovalRequestWebhookEvent.LatestChallenge;
 
   /**
    * Card network of the authorization.
@@ -818,9 +817,9 @@ export interface AsaRequestWebhookEvent {
    * values and how to use them. This object is only available to certain programs-
    * contact your Customer Success Manager to discuss enabling access.
    */
-  network_specific_data?: AsaRequestWebhookEvent.NetworkSpecificData | null;
+  network_specific_data?: CardAuthorizationApprovalRequestWebhookEvent.NetworkSpecificData | null;
 
-  pos?: AsaRequestWebhookEvent.Pos;
+  pos?: CardAuthorizationApprovalRequestWebhookEvent.Pos;
 
   token_info?: TransactionsAPI.TokenInfo | null;
 
@@ -830,7 +829,7 @@ export interface AsaRequestWebhookEvent {
   ttl?: string;
 }
 
-export namespace AsaRequestWebhookEvent {
+export namespace CardAuthorizationApprovalRequestWebhookEvent {
   export interface Avs {
     /**
      * Cardholder address
@@ -2249,6 +2248,13 @@ export interface TokenizationUpdatedWebhookEvent {
   tokenization: TokenizationsAPI.Tokenization;
 }
 
+/**
+ * Represents a 3DS authentication
+ */
+export interface ThreeDSAuthenticationApprovalRequestWebhookEvent extends ThreeDSAPI.ThreeDSAuthentication {
+  event_type: 'three_ds_authentication.approval_request';
+}
+
 /**
  * The Dispute object tracks the progression of a dispute throughout its lifecycle.
  */
@@ -2279,7 +2285,7 @@ export type ParsedWebhookEvent =
   | ParsedWebhookEvent.LegacyPayload
   | AccountHolderVerificationWebhookEvent
   | AccountHolderDocumentUpdatedWebhookEvent
-  | AsaRequestWebhookEvent
+  | CardAuthorizationApprovalRequestWebhookEvent
   | TokenizationDecisioningRequestWebhookEvent
   | AuthRulesBacktestReportCreatedWebhookEvent
   | BalanceUpdatedWebhookEvent
@@ -2327,7 +2333,7 @@ export type ParsedWebhookEvent =
   | TokenizationTwoFactorAuthenticationCodeWebhookEvent
   | TokenizationTwoFactorAuthenticationCodeSentWebhookEvent
   | TokenizationUpdatedWebhookEvent
-  | ThreeDSAPI.ThreeDSAuthentication
+  | ThreeDSAuthenticationApprovalRequestWebhookEvent
   | DisputeTransactionCreatedWebhookEvent
   | DisputeTransactionUpdatedWebhookEvent;
 
@@ -2756,7 +2762,7 @@ export declare namespace Webhooks {
     type AccountHolderUpdatedWebhookEvent as AccountHolderUpdatedWebhookEvent,
     type AccountHolderVerificationWebhookEvent as AccountHolderVerificationWebhookEvent,
     type AccountHolderDocumentUpdatedWebhookEvent as AccountHolderDocumentUpdatedWebhookEvent,
-    type AsaRequestWebhookEvent as AsaRequestWebhookEvent,
+    type CardAuthorizationApprovalRequestWebhookEvent as CardAuthorizationApprovalRequestWebhookEvent,
     type TokenizationDecisioningRequestWebhookEvent as TokenizationDecisioningRequestWebhookEvent,
     type AuthRulesBacktestReportCreatedWebhookEvent as AuthRulesBacktestReportCreatedWebhookEvent,
     type BalanceUpdatedWebhookEvent as BalanceUpdatedWebhookEvent,
@@ -2804,6 +2810,7 @@ export declare namespace Webhooks {
     type TokenizationTwoFactorAuthenticationCodeWebhookEvent as TokenizationTwoFactorAuthenticationCodeWebhookEvent,
     type TokenizationTwoFactorAuthenticationCodeSentWebhookEvent as TokenizationTwoFactorAuthenticationCodeSentWebhookEvent,
     type TokenizationUpdatedWebhookEvent as TokenizationUpdatedWebhookEvent,
+    type ThreeDSAuthenticationApprovalRequestWebhookEvent as ThreeDSAuthenticationApprovalRequestWebhookEvent,
     type DisputeTransactionCreatedWebhookEvent as DisputeTransactionCreatedWebhookEvent,
     type DisputeTransactionUpdatedWebhookEvent as DisputeTransactionUpdatedWebhookEvent,
     type ParsedWebhookEvent as ParsedWebhookEvent,