feat(api): api update

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 239
-openapi_spec_hash: 0af65087719d3a94ec028dea0f1f79dc
+openapi_spec_hash: 4b60059207055c7208501433bbb58cba
 config_hash: 1ca082e374ef7000e2a5971e8da740e0

src/increase/resources/exports.py

@@ -48,18 +48,18 @@ def create(
         self,
         *,
         category: Literal[
-            "account_statement_ofx",
             "account_statement_bai2",
-            "transaction_csv",
+            "account_statement_ofx",
+            "account_verification_letter",
             "balance_csv",
             "bookkeeping_account_balance_csv",
+            "daily_account_balance_csv",
             "entity_csv",
-            "vendor_csv",
-            "account_verification_letter",
-            "funding_instructions",
             "fee_csv",
+            "funding_instructions",
+            "transaction_csv",
+            "vendor_csv",
             "voided_check",
-            "daily_account_balance_csv",
         ],
         account_statement_bai2: export_create_params.AccountStatementBai2 | Omit = omit,
         account_statement_ofx: export_create_params.AccountStatementOfx | Omit = omit,
@@ -86,25 +86,25 @@ def create(
         Args:
           category: The type of Export to create.
 
-              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
-                transactions and balances for a given time range and Account.
               - `account_statement_bai2` - Export a BAI2 file of transactions and balances for
                 a given date and optional Account.
-              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
+                transactions and balances for a given time range and Account.
+              - `account_verification_letter` - A PDF of an account verification letter.
               - `balance_csv` - Export a CSV of account balances for the dates in a given
                 range. (deprecated, use `daily_account_balance_csv` instead)
               - `bookkeeping_account_balance_csv` - Export a CSV of bookkeeping account
                 balances for the dates in a given range.
+              - `daily_account_balance_csv` - Export a CSV of daily account balances with
+                starting and ending balances for a given date range.
               - `entity_csv` - Export a CSV of entities with a given status.
-              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
-                management dashboard.
-              - `account_verification_letter` - A PDF of an account verification letter.
-              - `funding_instructions` - A PDF of funding instructions.
               - `fee_csv` - Export a CSV of fees. The time range must not include any fees
                 that are part of an open fee statement.
+              - `funding_instructions` - A PDF of funding instructions.
+              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
+                management dashboard.
               - `voided_check` - A PDF of a voided check.
-              - `daily_account_balance_csv` - Export a CSV of daily account balances with
-                starting and ending balances for a given date range.
 
           account_statement_bai2: Options for the created export. Required if `category` is equal to
               `account_statement_bai2`.
@@ -214,21 +214,21 @@ def list(
         self,
         *,
         category: Literal[
-            "account_statement_ofx",
             "account_statement_bai2",
-            "transaction_csv",
+            "account_statement_ofx",
+            "account_verification_letter",
             "balance_csv",
             "bookkeeping_account_balance_csv",
-            "entity_csv",
-            "vendor_csv",
+            "daily_account_balance_csv",
             "dashboard_table_csv",
-            "account_verification_letter",
-            "funding_instructions",
+            "entity_csv",
+            "fee_csv",
             "form_1099_int",
             "form_1099_misc",
-            "fee_csv",
+            "funding_instructions",
+            "transaction_csv",
+            "vendor_csv",
             "voided_check",
-            "daily_account_balance_csv",
         ]
         | Omit = omit,
         created_at: export_list_params.CreatedAt | Omit = omit,
@@ -251,29 +251,29 @@ def list(
         Args:
           category: Filter Exports for those with the specified category.
 
-              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
-                transactions and balances for a given time range and Account.
               - `account_statement_bai2` - Export a BAI2 file of transactions and balances for
                 a given date and optional Account.
-              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
+                transactions and balances for a given time range and Account.
+              - `account_verification_letter` - A PDF of an account verification letter.
               - `balance_csv` - Export a CSV of account balances for the dates in a given
                 range. (deprecated, use `daily_account_balance_csv` instead)
               - `bookkeeping_account_balance_csv` - Export a CSV of bookkeeping account
                 balances for the dates in a given range.
-              - `entity_csv` - Export a CSV of entities with a given status.
-              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
-                management dashboard.
+              - `daily_account_balance_csv` - Export a CSV of daily account balances with
+                starting and ending balances for a given date range.
               - `dashboard_table_csv` - Certain dashboard tables are available as CSV exports.
                 This export cannot be created via the API.
-              - `account_verification_letter` - A PDF of an account verification letter.
-              - `funding_instructions` - A PDF of funding instructions.
-              - `form_1099_int` - A PDF of an Internal Revenue Service Form 1099-INT.
-              - `form_1099_misc` - A PDF of an Internal Revenue Service Form 1099-MISC.
+              - `entity_csv` - Export a CSV of entities with a given status.
               - `fee_csv` - Export a CSV of fees. The time range must not include any fees
                 that are part of an open fee statement.
+              - `form_1099_int` - A PDF of an Internal Revenue Service Form 1099-INT.
+              - `form_1099_misc` - A PDF of an Internal Revenue Service Form 1099-MISC.
+              - `funding_instructions` - A PDF of funding instructions.
+              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
+                management dashboard.
               - `voided_check` - A PDF of a voided check.
-              - `daily_account_balance_csv` - Export a CSV of daily account balances with
-                starting and ending balances for a given date range.
 
           cursor: Return the page of entries after this one.
 
@@ -345,18 +345,18 @@ async def create(
         self,
         *,
         category: Literal[
-            "account_statement_ofx",
             "account_statement_bai2",
-            "transaction_csv",
+            "account_statement_ofx",
+            "account_verification_letter",
             "balance_csv",
             "bookkeeping_account_balance_csv",
+            "daily_account_balance_csv",
             "entity_csv",
-            "vendor_csv",
-            "account_verification_letter",
-            "funding_instructions",
             "fee_csv",
+            "funding_instructions",
+            "transaction_csv",
+            "vendor_csv",
             "voided_check",
-            "daily_account_balance_csv",
         ],
         account_statement_bai2: export_create_params.AccountStatementBai2 | Omit = omit,
         account_statement_ofx: export_create_params.AccountStatementOfx | Omit = omit,
@@ -383,25 +383,25 @@ async def create(
         Args:
           category: The type of Export to create.
 
-              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
-                transactions and balances for a given time range and Account.
               - `account_statement_bai2` - Export a BAI2 file of transactions and balances for
                 a given date and optional Account.
-              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
+                transactions and balances for a given time range and Account.
+              - `account_verification_letter` - A PDF of an account verification letter.
               - `balance_csv` - Export a CSV of account balances for the dates in a given
                 range. (deprecated, use `daily_account_balance_csv` instead)
               - `bookkeeping_account_balance_csv` - Export a CSV of bookkeeping account
                 balances for the dates in a given range.
+              - `daily_account_balance_csv` - Export a CSV of daily account balances with
+                starting and ending balances for a given date range.
               - `entity_csv` - Export a CSV of entities with a given status.
-              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
-                management dashboard.
-              - `account_verification_letter` - A PDF of an account verification letter.
-              - `funding_instructions` - A PDF of funding instructions.
               - `fee_csv` - Export a CSV of fees. The time range must not include any fees
                 that are part of an open fee statement.
+              - `funding_instructions` - A PDF of funding instructions.
+              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
+                management dashboard.
               - `voided_check` - A PDF of a voided check.
-              - `daily_account_balance_csv` - Export a CSV of daily account balances with
-                starting and ending balances for a given date range.
 
           account_statement_bai2: Options for the created export. Required if `category` is equal to
               `account_statement_bai2`.
@@ -511,21 +511,21 @@ def list(
         self,
         *,
         category: Literal[
-            "account_statement_ofx",
             "account_statement_bai2",
-            "transaction_csv",
+            "account_statement_ofx",
+            "account_verification_letter",
             "balance_csv",
             "bookkeeping_account_balance_csv",
-            "entity_csv",
-            "vendor_csv",
+            "daily_account_balance_csv",
             "dashboard_table_csv",
-            "account_verification_letter",
-            "funding_instructions",
+            "entity_csv",
+            "fee_csv",
             "form_1099_int",
             "form_1099_misc",
-            "fee_csv",
+            "funding_instructions",
+            "transaction_csv",
+            "vendor_csv",
             "voided_check",
-            "daily_account_balance_csv",
         ]
         | Omit = omit,
         created_at: export_list_params.CreatedAt | Omit = omit,
@@ -548,29 +548,29 @@ def list(
         Args:
           category: Filter Exports for those with the specified category.
 
-              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
-                transactions and balances for a given time range and Account.
               - `account_statement_bai2` - Export a BAI2 file of transactions and balances for
                 a given date and optional Account.
-              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `account_statement_ofx` - Export an Open Financial Exchange (OFX) file of
+                transactions and balances for a given time range and Account.
+              - `account_verification_letter` - A PDF of an account verification letter.
               - `balance_csv` - Export a CSV of account balances for the dates in a given
                 range. (deprecated, use `daily_account_balance_csv` instead)
               - `bookkeeping_account_balance_csv` - Export a CSV of bookkeeping account
                 balances for the dates in a given range.
-              - `entity_csv` - Export a CSV of entities with a given status.
-              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
-                management dashboard.
+              - `daily_account_balance_csv` - Export a CSV of daily account balances with
+                starting and ending balances for a given date range.
               - `dashboard_table_csv` - Certain dashboard tables are available as CSV exports.
                 This export cannot be created via the API.
-              - `account_verification_letter` - A PDF of an account verification letter.
-              - `funding_instructions` - A PDF of funding instructions.
-              - `form_1099_int` - A PDF of an Internal Revenue Service Form 1099-INT.
-              - `form_1099_misc` - A PDF of an Internal Revenue Service Form 1099-MISC.
+              - `entity_csv` - Export a CSV of entities with a given status.
               - `fee_csv` - Export a CSV of fees. The time range must not include any fees
                 that are part of an open fee statement.
+              - `form_1099_int` - A PDF of an Internal Revenue Service Form 1099-INT.
+              - `form_1099_misc` - A PDF of an Internal Revenue Service Form 1099-MISC.
+              - `funding_instructions` - A PDF of funding instructions.
+              - `transaction_csv` - Export a CSV of all transactions for a given time range.
+              - `vendor_csv` - Export a CSV of vendors added to the third-party risk
+                management dashboard.
               - `voided_check` - A PDF of a voided check.
-              - `daily_account_balance_csv` - Export a CSV of daily account balances with
-                starting and ending balances for a given date range.
 
           cursor: Return the page of entries after this one.
 

src/increase/types/ach_transfer.py

@@ -36,7 +36,7 @@ class Acknowledgement(BaseModel):
     After the transfer is acknowledged by FedACH, this will contain supplemental details. The Federal Reserve sends an acknowledgement message for each file that Increase submits.
     """
 
-    acknowledged_at: str
+    acknowledged_at: datetime.datetime
     """
     When the Federal Reserve acknowledged the submitted file containing this
     transfer.

src/increase/types/beneficial_owner_create_params.py

@@ -154,7 +154,7 @@ class IndividualIdentification(TypedDict, total=False, extra_items=object):  # t
 
     - `social_security_number` - A social security number.
     - `social_security_number_last4` - The last four digits of a social security
-      number.
+      number. Not all programs can use this method.
     - `individual_taxpayer_identification_number` - An individual taxpayer
       identification number (ITIN).
     - `passport` - A passport number.

src/increase/types/beneficial_owner_update_params.py

@@ -165,7 +165,7 @@ class Identification(TypedDict, total=False, extra_items=object):  # type: ignor
 
     - `social_security_number` - A social security number.
     - `social_security_number_last4` - The last four digits of a social security
-      number.
+      number. Not all programs can use this method.
     - `individual_taxpayer_identification_number` - An individual taxpayer
       identification number (ITIN).
     - `passport` - A passport number.

src/increase/types/card_payment.py

@@ -3247,6 +3247,7 @@ class ElementCardDecline(BaseModel):
             "exceeds_approval_limit",
             "card_temporarily_disabled",
             "suspected_fraud",
+            "additional_customer_authentication_required",
             "other",
         ]
     ] = None
@@ -3264,6 +3265,8 @@ class ElementCardDecline(BaseModel):
       yet activated. The merchant may attempt to process the transaction again.
     - `suspected_fraud` - The transaction is suspected to be fraudulent. The
       merchant may attempt to process the transaction again.
+    - `additional_customer_authentication_required` - Additional customer
+      authentication is required to complete the transaction, such as 3DS.
     - `other` - The transaction was declined for another reason. The merchant may
       attempt to process the transaction again. This should be used sparingly.
     """

src/increase/types/declined_transaction.py

@@ -993,6 +993,7 @@ class SourceCardDecline(BaseModel):
             "exceeds_approval_limit",
             "card_temporarily_disabled",
             "suspected_fraud",
+            "additional_customer_authentication_required",
             "other",
         ]
     ] = None
@@ -1010,6 +1011,8 @@ class SourceCardDecline(BaseModel):
       yet activated. The merchant may attempt to process the transaction again.
     - `suspected_fraud` - The transaction is suspected to be fraudulent. The
       merchant may attempt to process the transaction again.
+    - `additional_customer_authentication_required` - Additional customer
+      authentication is required to complete the transaction, such as 3DS.
     - `other` - The transaction was declined for another reason. The merchant may
       attempt to process the transaction again. This should be used sparingly.
     """

src/increase/types/digital_wallet_token.py

@@ -28,6 +28,9 @@ class Decline(BaseModel):
         "webhook_declined",
         "incorrect_card_verification_code",
         "declined_by_token_requestor",
+        "group_locked",
+        "account_closed",
+        "entity_not_active",
     ]
     """The reason the token provisioning was declined.
 
@@ -41,6 +44,9 @@ class Decline(BaseModel):
       the Card Verification Code (CVC) was incorrect.
     - `declined_by_token_requestor` - The tokenization attempt was declined by the
       token requestor.
+    - `group_locked` - The group was locked.
+    - `account_closed` - The account has been closed.
+    - `entity_not_active` - The account's entity was not active.
     """
 
 
@@ -94,7 +100,7 @@ class DynamicPrimaryAccountNumber(BaseModel):
 
 
 class Update(BaseModel):
-    status: Literal["active", "inactive", "suspended", "deactivated", "declined"]
+    status: Literal["active", "inactive", "suspended", "deactivated", "declined", "pending_transitioning"]
     """The status the update changed this Digital Wallet Token to.
 
     - `active` - The digital wallet token is active.
@@ -103,6 +109,8 @@ class Update(BaseModel):
     - `suspended` - The digital wallet token has been temporarily paused.
     - `deactivated` - The digital wallet token has been permanently canceled.
     - `declined` - The digital wallet token was declined during provisioning.
+    - `pending_transitioning` - The digital wallet token is transitioning to a new
+      status and is awaiting confirmation from the card network.
     """
 
     timestamp: datetime
@@ -150,7 +158,7 @@ class DigitalWalletToken(BaseModel):
     primary_account_number_reference_identifier: str
     """The reference identifier assigned by the card network to the underlying Card."""
 
-    status: Literal["active", "inactive", "suspended", "deactivated", "declined"]
+    status: Literal["active", "inactive", "suspended", "deactivated", "declined", "pending_transitioning"]
     """This indicates if payments can be made with the Digital Wallet Token.
 
     - `active` - The digital wallet token is active.
@@ -159,6 +167,8 @@ class DigitalWalletToken(BaseModel):
     - `suspended` - The digital wallet token has been temporarily paused.
     - `deactivated` - The digital wallet token has been permanently canceled.
     - `declined` - The digital wallet token was declined during provisioning.
+    - `pending_transitioning` - The digital wallet token is transitioning to a new
+      status and is awaiting confirmation from the card network.
     """
 
     token_reference_identifier: str