increase 1.347.0 → 1.348.0

data/rbi/increase/models/card_create_params.rbi

@@ -40,6 +40,18 @@ module Increase
       end
       attr_writer :billing_address
 
+      # The name of the cardholder. Used to respond to Account Name Inquiry requests
+      # from acquirers in Card Validations.
+      sig { returns(T.nilable(Increase::CardCreateParams::CardholderName)) }
+      attr_reader :cardholder_name
+
+      sig do
+        params(
+          cardholder_name: Increase::CardCreateParams::CardholderName::OrHash
+        ).void
+      end
+      attr_writer :cardholder_name
+
       # The description you choose to give the card.
       sig { returns(T.nilable(String)) }
       attr_reader :description
@@ -76,6 +88,7 @@ module Increase
           authorization_controls:
             Increase::CardCreateParams::AuthorizationControls::OrHash,
           billing_address: Increase::CardCreateParams::BillingAddress::OrHash,
+          cardholder_name: Increase::CardCreateParams::CardholderName::OrHash,
           description: String,
           digital_wallet: Increase::CardCreateParams::DigitalWallet::OrHash,
           entity_id: String,
@@ -89,6 +102,9 @@ module Increase
         authorization_controls: nil,
         # The card's billing address.
         billing_address: nil,
+        # The name of the cardholder. Used to respond to Account Name Inquiry requests
+        # from acquirers in Card Validations.
+        cardholder_name: nil,
         # The description you choose to give the card.
         description: nil,
         # The contact information used in the two-factor steps for digital wallet card
@@ -111,6 +127,7 @@ module Increase
             authorization_controls:
               Increase::CardCreateParams::AuthorizationControls,
             billing_address: Increase::CardCreateParams::BillingAddress,
+            cardholder_name: Increase::CardCreateParams::CardholderName,
             description: String,
             digital_wallet: Increase::CardCreateParams::DigitalWallet,
             entity_id: String,
@@ -1258,6 +1275,54 @@ module Increase
         end
       end
 
+      class CardholderName < Increase::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Increase::CardCreateParams::CardholderName,
+              Increase::Internal::AnyHash
+            )
+          end
+
+        # The cardholder's first name.
+        sig { returns(String) }
+        attr_accessor :first
+
+        # The cardholder's last name.
+        sig { returns(String) }
+        attr_accessor :last
+
+        # The cardholder's middle name.
+        sig { returns(T.nilable(String)) }
+        attr_reader :middle
+
+        sig { params(middle: String).void }
+        attr_writer :middle
+
+        # The name of the cardholder. Used to respond to Account Name Inquiry requests
+        # from acquirers in Card Validations.
+        sig do
+          params(first: String, last: String, middle: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The cardholder's first name.
+          first:,
+          # The cardholder's last name.
+          last:,
+          # The cardholder's middle name.
+          middle: nil
+        )
+        end
+
+        sig do
+          override.returns({ first: String, last: String, middle: String })
+        end
+        def to_hash
+        end
+      end
+
       class DigitalWallet < Increase::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/increase/models/card_dispute.rbi

@@ -372,7 +372,7 @@ module Increase
         # The Card Dispute has been won and no further action can be taken.
         WON = T.let(:won, Increase::CardDispute::Status::TaggedSymbol)
 
-        # The Card Dispute has been reviewed and rejected, please review the explanation for more details.
+        # The Card Dispute was rejected before it was submitted to the network, either by Increase or because the user withdrew it. Please review the explanation for more details.
         REJECTED = T.let(:rejected, Increase::CardDispute::Status::TaggedSymbol)
 
         sig do

data/rbi/increase/models/card_dispute_list_params.rbi

@@ -284,7 +284,7 @@ module Increase
               Increase::CardDisputeListParams::Status::In::TaggedSymbol
             )
 
-          # The Card Dispute has been reviewed and rejected, please review the explanation for more details.
+          # The Card Dispute was rejected before it was submitted to the network, either by Increase or because the user withdrew it. Please review the explanation for more details.
           REJECTED =
             T.let(
               :rejected,

data/rbi/increase/models/card_payment.rbi

@@ -2585,6 +2585,14 @@ module Increase
           sig { returns(T.nilable(Integer)) }
           attr_accessor :network_risk_score
 
+          # The ID of the Card Payment containing the original authorization or card
+          # validation this transaction references. For a merchant-initiated transaction,
+          # this is the Card Payment from when the card was first stored, which is typically
+          # where the CVV2 was verified. The reference this is derived from is supplied by
+          # the merchant or their acquirer, so it is not guaranteed to be present.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :original_card_payment_id
+
           # The identifier of the Pending Transaction associated with this Transaction.
           sig { returns(T.nilable(String)) }
           attr_accessor :pending_transaction_id
@@ -2692,6 +2700,7 @@ module Increase
               network_identifiers:
                 Increase::CardPayment::Element::CardAuthorization::NetworkIdentifiers::OrHash,
               network_risk_score: T.nilable(Integer),
+              original_card_payment_id: T.nilable(String),
               pending_transaction_id: T.nilable(String),
               physical_card_id: T.nilable(String),
               presentment_amount: Integer,
@@ -2765,6 +2774,12 @@ module Increase
             # Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the
             # score is from 0 to 999, where 999 is the riskiest.
             network_risk_score:,
+            # The ID of the Card Payment containing the original authorization or card
+            # validation this transaction references. For a merchant-initiated transaction,
+            # this is the Card Payment from when the card was first stored, which is typically
+            # where the CVV2 was verified. The reference this is derived from is supplied by
+            # the merchant or their acquirer, so it is not guaranteed to be present.
+            original_card_payment_id:,
             # The identifier of the Pending Transaction associated with this Transaction.
             pending_transaction_id:,
             # If the authorization was made in-person with a physical card, the Physical Card
@@ -2826,6 +2841,7 @@ module Increase
                 network_identifiers:
                   Increase::CardPayment::Element::CardAuthorization::NetworkIdentifiers,
                 network_risk_score: T.nilable(Integer),
+                original_card_payment_id: T.nilable(String),
                 pending_transaction_id: T.nilable(String),
                 physical_card_id: T.nilable(String),
                 presentment_amount: Integer,

data/rbi/increase/models/check_transfer.rbi

@@ -791,6 +791,10 @@ module Increase
         sig { returns(T::Array[Increase::CheckTransfer::PhysicalCheck::Payer]) }
         attr_accessor :payer
 
+        # The identifier of the Physical Check Batch that this check is a part of.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :physical_check_batch_id
+
         # The name that will be printed on the check.
         sig { returns(String) }
         attr_accessor :recipient_name
@@ -857,6 +861,7 @@ module Increase
             note: T.nilable(String),
             payer:
               T::Array[Increase::CheckTransfer::PhysicalCheck::Payer::OrHash],
+            physical_check_batch_id: T.nilable(String),
             recipient_name: String,
             return_address:
               T.nilable(
@@ -887,6 +892,8 @@ module Increase
           # The payer of the check. This will be printed on the top-left portion of the
           # check and defaults to the return address if unspecified.
           payer:,
+          # The identifier of the Physical Check Batch that this check is a part of.
+          physical_check_batch_id:,
           # The name that will be printed on the check.
           recipient_name:,
           # The return address to be printed on the check.
@@ -913,6 +920,7 @@ module Increase
               memo: T.nilable(String),
               note: T.nilable(String),
               payer: T::Array[Increase::CheckTransfer::PhysicalCheck::Payer],
+              physical_check_batch_id: T.nilable(String),
               recipient_name: String,
               return_address:
                 T.nilable(
@@ -1369,6 +1377,13 @@ module Increase
         CANCELED =
           T.let(:canceled, Increase::CheckTransfer::Status::TaggedSymbol)
 
+        # The transfer is waiting for its Physical Check Batch to be completed.
+        PENDING_BATCH_COMPLETING =
+          T.let(
+            :pending_batch_completing,
+            Increase::CheckTransfer::Status::TaggedSymbol
+          )
+
         # The transfer is pending submission.
         PENDING_SUBMISSION =
           T.let(

data/rbi/increase/models/check_transfer_create_params.rbi

@@ -268,7 +268,8 @@ module Increase
             )
           end
 
-        # Details for where Increase will mail the check.
+        # Details for where Increase will mail the check. When `physical_check_batch_id`
+        # is set, the address must match the Physical Check Batch.
         sig do
           returns(
             Increase::CheckTransferCreateParams::PhysicalCheck::MailingAddress
@@ -327,9 +328,16 @@ module Increase
         sig { params(note: String).void }
         attr_writer :note
 
-        # The return address to be printed on the check. If omitted this will default to
-        # an Increase-owned address that will mark checks as delivery failed and shred
-        # them.
+        # The identifier of the Physical Check Batch to mail this check as a part of.
+        sig { returns(T.nilable(String)) }
+        attr_reader :physical_check_batch_id
+
+        sig { params(physical_check_batch_id: String).void }
+        attr_writer :physical_check_batch_id
+
+        # Details for where the courier will return the check to if it is unable to be
+        # delivered. Defaults to an Increase-owned address that will mark checks as
+        # delivery failed and shred them.
         sig do
           returns(
             T.nilable(
@@ -410,6 +418,7 @@ module Increase
             attachment_file_id: String,
             check_voucher_image_file_id: String,
             note: String,
+            physical_check_batch_id: String,
             return_address:
               Increase::CheckTransferCreateParams::PhysicalCheck::ReturnAddress::OrHash,
             return_address_name: String,
@@ -420,7 +429,8 @@ module Increase
           ).returns(T.attached_class)
         end
         def self.new(
-          # Details for where Increase will mail the check.
+          # Details for where Increase will mail the check. When `physical_check_batch_id`
+          # is set, the address must match the Physical Check Batch.
           mailing_address:,
           # The descriptor that will be printed on the memo field on the check.
           memo:,
@@ -440,9 +450,11 @@ module Increase
           check_voucher_image_file_id: nil,
           # The descriptor that will be printed on the letter included with the check.
           note: nil,
-          # The return address to be printed on the check. If omitted this will default to
-          # an Increase-owned address that will mark checks as delivery failed and shred
-          # them.
+          # The identifier of the Physical Check Batch to mail this check as a part of.
+          physical_check_batch_id: nil,
+          # Details for where the courier will return the check to if it is unable to be
+          # delivered. Defaults to an Increase-owned address that will mark checks as
+          # delivery failed and shred them.
           return_address: nil,
           # A custom name to print above the default return address. Cannot be provided
           # together with `return_address`.
@@ -471,6 +483,7 @@ module Increase
               attachment_file_id: String,
               check_voucher_image_file_id: String,
               note: String,
+              physical_check_batch_id: String,
               return_address:
                 Increase::CheckTransferCreateParams::PhysicalCheck::ReturnAddress,
               return_address_name: String,
@@ -533,7 +546,8 @@ module Increase
           sig { params(phone: String).void }
           attr_writer :phone
 
-          # Details for where Increase will mail the check.
+          # Details for where Increase will mail the check. When `physical_check_batch_id`
+          # is set, the address must match the Physical Check Batch.
           sig do
             params(
               city: String,
@@ -653,9 +667,9 @@ module Increase
           sig { params(phone: String).void }
           attr_writer :phone
 
-          # The return address to be printed on the check. If omitted this will default to
-          # an Increase-owned address that will mark checks as delivery failed and shred
-          # them.
+          # Details for where the courier will return the check to if it is unable to be
+          # delivered. Defaults to an Increase-owned address that will mark checks as
+          # delivery failed and shred them.
           sig do
             params(
               city: String,

data/rbi/increase/models/entity.rbi

@@ -2015,7 +2015,7 @@ module Increase
         attr_accessor :agreed_at
 
         # The IP address the Entity accessed reviewed the terms from.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :ip_address
 
         # The URL of the terms agreement. This link will be provided by your bank partner.
@@ -2025,7 +2025,7 @@ module Increase
         sig do
           params(
             agreed_at: Time,
-            ip_address: String,
+            ip_address: T.nilable(String),
             terms_url: String
           ).returns(T.attached_class)
         end
@@ -2041,7 +2041,11 @@ module Increase
 
         sig do
           override.returns(
-            { agreed_at: Time, ip_address: String, terms_url: String }
+            {
+              agreed_at: Time,
+              ip_address: T.nilable(String),
+              terms_url: String
+            }
           )
         end
         def to_hash
@@ -3137,6 +3141,24 @@ module Increase
           end
           attr_writer :entity_address
 
+          # Details when the issue is with the entity's identity verification.
+          sig do
+            returns(
+              T.nilable(Increase::Entity::Validation::Issue::EntityIdentity)
+            )
+          end
+          attr_reader :entity_identity
+
+          sig do
+            params(
+              entity_identity:
+                T.nilable(
+                  Increase::Entity::Validation::Issue::EntityIdentity::OrHash
+                )
+            ).void
+          end
+          attr_writer :entity_identity
+
           # Details when the issue is with the entity's tax ID.
           sig do
             returns(
@@ -3172,6 +3194,10 @@ module Increase
                 T.nilable(
                   Increase::Entity::Validation::Issue::EntityAddress::OrHash
                 ),
+              entity_identity:
+                T.nilable(
+                  Increase::Entity::Validation::Issue::EntityIdentity::OrHash
+                ),
               entity_tax_identifier:
                 T.nilable(
                   Increase::Entity::Validation::Issue::EntityTaxIdentifier::OrHash
@@ -3188,6 +3214,8 @@ module Increase
             category:,
             # Details when the issue is with the entity's address.
             entity_address:,
+            # Details when the issue is with the entity's identity verification.
+            entity_identity:,
             # Details when the issue is with the entity's tax ID.
             entity_tax_identifier:
           )
@@ -3208,6 +3236,10 @@ module Increase
                   Increase::Entity::Validation::Issue::Category::TaggedSymbol,
                 entity_address:
                   T.nilable(Increase::Entity::Validation::Issue::EntityAddress),
+                entity_identity:
+                  T.nilable(
+                    Increase::Entity::Validation::Issue::EntityIdentity
+                  ),
                 entity_tax_identifier:
                   T.nilable(
                     Increase::Entity::Validation::Issue::EntityTaxIdentifier
@@ -3352,6 +3384,13 @@ module Increase
                 Increase::Entity::Validation::Issue::Category::TaggedSymbol
               )
 
+            # The entity's identity could not be verified. Update the identification with the [update an entity API](/documentation/api/entities#update-an-entity.natural_person.identification).
+            ENTITY_IDENTITY =
+              T.let(
+                :entity_identity,
+                Increase::Entity::Validation::Issue::Category::TaggedSymbol
+              )
+
             # A beneficial owner's identity could not be verified. Update the identification with the [update a beneficial owner API](/documentation/api/beneficial-owners#update-a-beneficial-owner).
             BENEFICIAL_OWNER_IDENTITY =
               T.let(
@@ -3450,6 +3489,25 @@ module Increase
             end
           end
 
+          class EntityIdentity < Increase::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Increase::Entity::Validation::Issue::EntityIdentity,
+                  Increase::Internal::AnyHash
+                )
+              end
+
+            # Details when the issue is with the entity's identity verification.
+            sig { returns(T.attached_class) }
+            def self.new
+            end
+
+            sig { override.returns({}) }
+            def to_hash
+            end
+          end
+
           class EntityTaxIdentifier < Increase::Internal::Type::BaseModel
             OrHash =
               T.type_alias do