increase 1.356.0 → 1.358.0

data/lib/increase/models/transaction.rb

@@ -1666,6 +1666,9 @@ module Increase
               # The user's chargeback was submitted.
               CHARGEBACK_SUBMITTED = :chargeback_submitted
 
+              # The merchant's pre-arbitration submission was accepted by the user or not responded to in time.
+              MERCHANT_PREARBITRATION_ACCEPTED = :merchant_prearbitration_accepted
+
               # The user declined the merchant's pre-arbitration submission.
               MERCHANT_PREARBITRATION_DECLINE_SUBMITTED = :merchant_prearbitration_decline_submitted
 
@@ -1675,6 +1678,9 @@ module Increase
               # The transaction was re-presented by the merchant.
               REPRESENTED = :represented
 
+              # The user's pre-arbitration was accepted by the merchant or not responded to in time.
+              USER_PREARBITRATION_ACCEPTED = :user_prearbitration_accepted
+
               # The user's pre-arbitration was declined by the merchant.
               USER_PREARBITRATION_DECLINE_RECEIVED = :user_prearbitration_decline_received
 
@@ -3048,6 +3054,9 @@ module Increase
               # Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.
               PULSE_SWITCH_FEE = :pulse_switch_fee
 
+              # Pulse Tokenization Fee is a fee charged by the Pulse network for processing tokenized transactions on its network.
+              PULSE_TOKENIZATION_FEE = :pulse_tokenization_fee
+
               # @!method self.values
               #   @return [Array<Symbol>]
             end
@@ -4808,6 +4817,9 @@ module Increase
               # Invoice number
               INVOICE_NUMBER = :invoice_number
 
+              # Visa Recurrent reference identifier
+              VISA_RECURRENT_REFERENCE_IDENTIFIER = :visa_recurrent_reference_identifier
+
               # @!method self.values
               #   @return [Array<Symbol>]
             end
@@ -5443,6 +5455,9 @@ module Increase
               # Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.
               PULSE_SWITCH_FEE = :pulse_switch_fee
 
+              # Pulse Tokenization Fee is a fee charged by the Pulse network for processing tokenized transactions on its network.
+              PULSE_TOKENIZATION_FEE = :pulse_tokenization_fee
+
               # @!method self.values
               #   @return [Array<Symbol>]
             end
@@ -7082,6 +7097,9 @@ module Increase
               # Invoice number
               INVOICE_NUMBER = :invoice_number
 
+              # Visa Recurrent reference identifier
+              VISA_RECURRENT_REFERENCE_IDENTIFIER = :visa_recurrent_reference_identifier
+
               # @!method self.values
               #   @return [Array<Symbol>]
             end
@@ -7719,6 +7737,9 @@ module Increase
               # Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.
               PULSE_SWITCH_FEE = :pulse_switch_fee
 
+              # Pulse Tokenization Fee is a fee charged by the Pulse network for processing tokenized transactions on its network.
+              PULSE_TOKENIZATION_FEE = :pulse_tokenization_fee
+
               # @!method self.values
               #   @return [Array<Symbol>]
             end
@@ -8644,6 +8665,9 @@ module Increase
             # The check has already been deposited elsewhere and so this is a duplicate.
             PAID = :paid
 
+            # A previous adjustment for the check was applied twice and the duplicate has been reversed.
+            DUPLICATE_ENTRY = :duplicate_entry
+
             # @!method self.values
             #   @return [Array<Symbol>]
           end

data/lib/increase/models/unwrap_webhook_event.rb

@@ -184,6 +184,9 @@ module Increase
         # Occurs whenever a Digital Wallet Token is updated.
         DIGITAL_WALLET_TOKEN_UPDATED = :"digital_wallet_token.updated"
 
+        # Occurs whenever a Digital Wallet Token Request is created.
+        DIGITAL_WALLET_TOKEN_REQUEST_CREATED = :"digital_wallet_token_request.created"
+
         # Occurs whenever an Entity is created.
         ENTITY_CREATED = :"entity.created"
 

data/lib/increase/models.rb

@@ -167,6 +167,8 @@ module Increase
 
   CardPushTransferRetrieveParams = Increase::Models::CardPushTransferRetrieveParams
 
+  CardRenewParams = Increase::Models::CardRenewParams
+
   CardRetrieveParams = Increase::Models::CardRetrieveParams
 
   CardToken = Increase::Models::CardToken

data/lib/increase/resources/cards.rb

@@ -5,7 +5,7 @@ module Increase
     class Cards
       # Create a Card
       #
-      # @overload create(account_id:, authorization_controls: nil, billing_address: nil, cardholder_name: nil, description: nil, digital_wallet: nil, entity_id: nil, request_options: {})
+      # @overload create(account_id:, authorization_controls: nil, billing_address: nil, cardholder_name: nil, description: nil, digital_wallet: nil, entity_id: nil, replacement_for: nil, request_options: {})
       #
       # @param account_id [String] The Account the card should belong to.
       #
@@ -31,6 +31,10 @@ module Increase
       #   The Entity the card belongs to. You only need to supply this in rare situations
       #   when the card is not for the Account holder.
       #
+      # @param replacement_for [Increase::Models::CardCreateParams::ReplacementFor]
+      #   Details about the Card this Card replaces. Supply this when issuing a new Card
+      #   to take over from an existing one. The replaced Card is not canceled.
+      #
       # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Increase::Models::Card]
@@ -216,6 +220,30 @@ module Increase
         )
       end
 
+      # Renew a Card in place. The Card keeps its identifier, card number, PIN, and
+      # Physical Cards, and receives a new expiration date in the current month four
+      # years from now along with a new verification code, which the Card's details will
+      # return afterwards. Physical Cards that have already shipped keep working until
+      # they are canceled.
+      #
+      # @overload renew(card_id, request_options: {})
+      #
+      # @param card_id [String] The identifier of the Card to renew.
+      #
+      # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Increase::Models::Card]
+      #
+      # @see Increase::Models::CardRenewParams
+      def renew(card_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["cards/%1$s/renew", card_id],
+          model: Increase::Card,
+          options: params[:request_options]
+        )
+      end
+
       # Update a Card's PIN
       #
       # @overload update_pin(card_id, pin:, request_options: {})

data/lib/increase/resources/digital_card_profiles.rb

@@ -5,7 +5,7 @@ module Increase
     class DigitalCardProfiles
       # Create a Digital Card Profile
       #
-      # @overload create(app_icon_file_id:, background_image_file_id:, card_description:, description:, issuer_name:, contact_email: nil, contact_phone: nil, contact_website: nil, text_color: nil, request_options: {})
+      # @overload create(app_icon_file_id:, background_image_file_id:, card_description:, description:, contact_email: nil, contact_name: nil, contact_phone: nil, contact_website: nil, text_color: nil, request_options: {})
       #
       # @param app_icon_file_id [String] The identifier of the File containing the card's icon image.
       #
@@ -15,10 +15,12 @@ module Increase
       #
       # @param description [String] A description you can use to identify the Card Profile.
       #
-      # @param issuer_name [String] A user-facing description for whoever is issuing the card.
-      #
       # @param contact_email [String] An email address the user can contact to receive support for their card.
       #
+      # @param contact_name [String]
+      #   The name of your company or card program, shown to the user as who to contact
+      #   for support with their card.
+      #
       # @param contact_phone [String] A phone number the user can contact to receive support for their card.
       #
       # @param contact_website [String] A website the user can visit to view and receive support for their card.
@@ -62,7 +64,7 @@ module Increase
         )
       end
 
-      # List Card Profiles
+      # List Digital Card Profiles
       #
       # @overload list(cursor: nil, idempotency_key: nil, limit: nil, status: nil, request_options: {})
       #
@@ -120,9 +122,9 @@ module Increase
         )
       end
 
-      # Clones a Digital Card Profile
+      # Clone a Digital Card Profile
       #
-      # @overload clone_(digital_card_profile_id, app_icon_file_id: nil, background_image_file_id: nil, card_description: nil, contact_email: nil, contact_phone: nil, contact_website: nil, description: nil, issuer_name: nil, text_color: nil, request_options: {})
+      # @overload clone_(digital_card_profile_id, app_icon_file_id: nil, background_image_file_id: nil, card_description: nil, contact_email: nil, contact_name: nil, contact_phone: nil, contact_website: nil, description: nil, text_color: nil, request_options: {})
       #
       # @param digital_card_profile_id [String] The identifier of the Digital Card Profile to clone.
       #
@@ -134,14 +136,16 @@ module Increase
       #
       # @param contact_email [String] An email address the user can contact to receive support for their card.
       #
+      # @param contact_name [String]
+      #   The name of your company or card program, shown to the user as who to contact
+      #   for support with their card.
+      #
       # @param contact_phone [String] A phone number the user can contact to receive support for their card.
       #
       # @param contact_website [String] A website the user can visit to view and receive support for their card.
       #
       # @param description [String] A description you can use to identify the Card Profile.
       #
-      # @param issuer_name [String] A user-facing description for whoever is issuing the card.
-      #
       # @param text_color [Increase::Models::DigitalCardProfileCloneParams::TextColor]
       #   The Card's text color, specified as an RGB triple. The default is white.
       #

data/lib/increase/resources/events.rb

@@ -37,8 +37,8 @@ module Increase
       # @param cursor [String] Return the page of entries after this one.
       #
       # @param limit [Integer]
-      #   Limit the size of the list that is returned. The default (and maximum) is 100
-      #   objects.
+      #   Limit the size of the list that is returned. The default is 100 objects and the
+      #   maximum is 1,000.
       #
       #   Defaults to `100`.
       #

data/lib/increase/resources/files.rb

@@ -38,7 +38,9 @@ module Increase
         )
       end
 
-      # Retrieve a File
+      # Fetch metadata about a File, like its `purpose` and MIME type. To access the
+      # content, use the [Get File contents](/documentation/api/files#get-file-contents)
+      # API.
       #
       # @overload retrieve(file_id, request_options: {})
       #

data/lib/increase/resources/intrafi_account_enrollments.rb

@@ -3,7 +3,7 @@
 module Increase
   module Resources
     class IntrafiAccountEnrollments
-      # Enroll an account in the IntraFi deposit sweep network
+      # Enroll an Account in the IntraFi deposit sweep network
       #
       # @overload create(account_id:, email_address:, request_options: {})
       #
@@ -88,7 +88,7 @@ module Increase
         )
       end
 
-      # Unenroll an account from IntraFi
+      # Unenroll an Account from IntraFi
       #
       # @overload unenroll(intrafi_account_enrollment_id, request_options: {})
       #

data/lib/increase/resources/physical_card_profiles.rb

@@ -43,7 +43,7 @@ module Increase
         )
       end
 
-      # Retrieve a Card Profile
+      # Retrieve a Physical Card Profile
       #
       # @overload retrieve(physical_card_profile_id, request_options: {})
       #

data/lib/increase/resources/supplemental_documents.rb

@@ -3,7 +3,7 @@
 module Increase
   module Resources
     class SupplementalDocuments
-      # Create a supplemental document for an Entity
+      # Create a Supplemental Document
       #
       # @overload create(entity_id:, file_id:, request_options: {})
       #
@@ -27,7 +27,7 @@ module Increase
         )
       end
 
-      # List Entity Supplemental Document Submissions
+      # List Supplemental Documents
       #
       # @overload list(entity_id:, cursor: nil, idempotency_key: nil, limit: nil, request_options: {})
       #

data/lib/increase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Increase
-  VERSION = "1.356.0"
+  VERSION = "1.358.0"
 end

data/lib/increase.rb

@@ -118,6 +118,7 @@ require_relative "increase/models/card_push_transfer_cancel_params"
 require_relative "increase/models/card_push_transfer_create_params"
 require_relative "increase/models/card_push_transfer_list_params"
 require_relative "increase/models/card_push_transfer_retrieve_params"
+require_relative "increase/models/card_renew_params"
 require_relative "increase/models/card_retrieve_params"
 require_relative "increase/models/card_token"
 require_relative "increase/models/card_token_capabilities"

data/rbi/increase/models/account_statement.rbi

@@ -44,15 +44,17 @@ module Increase
 
       # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the end
       # of the period the Account Statement covers. The statement covers all
-      # transactions up to, but not including this timestamp. Usually, this is the
-      # beginning of the following month.
+      # transactions up to, but not including this timestamp. Statement periods are
+      # measured in UTC days, so this is usually midnight UTC on the first day of the
+      # following month.
       sig { returns(Time) }
       attr_accessor :statement_period_end
 
       # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the
       # start of the period the Account Statement covers. This is the first moment of
-      # the statement period and is inclusive. Usually, this is the beginning of the
-      # month this statement covers.
+      # the statement period and is inclusive. Statement periods are measured in UTC
+      # days, so this is usually midnight UTC on the first day of the month this
+      # statement covers.
       sig { returns(Time) }
       attr_accessor :statement_period_start
 
@@ -96,13 +98,15 @@ module Increase
         starting_balance:,
         # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the end
         # of the period the Account Statement covers. The statement covers all
-        # transactions up to, but not including this timestamp. Usually, this is the
-        # beginning of the following month.
+        # transactions up to, but not including this timestamp. Statement periods are
+        # measured in UTC days, so this is usually midnight UTC on the first day of the
+        # following month.
         statement_period_end:,
         # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the
         # start of the period the Account Statement covers. This is the first moment of
-        # the statement period and is inclusive. Usually, this is the beginning of the
-        # month this statement covers.
+        # the statement period and is inclusive. Statement periods are measured in UTC
+        # days, so this is usually midnight UTC on the first day of the month this
+        # statement covers.
         statement_period_start:,
         # A constant representing the object's type. For this resource it will always be
         # `account_statement`.

data/rbi/increase/models/card.rbi

@@ -95,6 +95,22 @@ module Increase
       sig { returns(String) }
       attr_accessor :last4
 
+      # Completed renewals of this Card, sorted by `renewed_at` in ascending order. Each
+      # renewal records the expiration date the Card had before it was renewed.
+      sig { returns(T::Array[Increase::Card::Renewal]) }
+      attr_accessor :renewals
+
+      # Details about the Card this Card replaces, if it was created as a replacement.
+      sig { returns(T.nilable(Increase::Card::ReplacementFor)) }
+      attr_reader :replacement_for
+
+      sig do
+        params(
+          replacement_for: T.nilable(Increase::Card::ReplacementFor::OrHash)
+        ).void
+      end
+      attr_writer :replacement_for
+
       # This indicates if payments can be made with the card.
       sig { returns(Increase::Card::Status::TaggedSymbol) }
       attr_accessor :status
@@ -126,6 +142,8 @@ module Increase
           expiration_year: Integer,
           idempotency_key: T.nilable(String),
           last4: String,
+          renewals: T::Array[Increase::Card::Renewal::OrHash],
+          replacement_for: T.nilable(Increase::Card::ReplacementFor::OrHash),
           status: Increase::Card::Status::OrSymbol,
           type: Increase::Card::Type::OrSymbol
         ).returns(T.attached_class)
@@ -165,6 +183,11 @@ module Increase
         idempotency_key:,
         # The last 4 digits of the Card's Primary Account Number.
         last4:,
+        # Completed renewals of this Card, sorted by `renewed_at` in ascending order. Each
+        # renewal records the expiration date the Card had before it was renewed.
+        renewals:,
+        # Details about the Card this Card replaces, if it was created as a replacement.
+        replacement_for:,
         # This indicates if payments can be made with the card.
         status:,
         # A constant representing the object's type. For this resource it will always be
@@ -191,6 +214,8 @@ module Increase
             expiration_year: Integer,
             idempotency_key: T.nilable(String),
             last4: String,
+            renewals: T::Array[Increase::Card::Renewal],
+            replacement_for: T.nilable(Increase::Card::ReplacementFor),
             status: Increase::Card::Status::TaggedSymbol,
             type: Increase::Card::Type::TaggedSymbol
           }
@@ -1393,6 +1418,143 @@ module Increase
         end
       end
 
+      class Renewal < Increase::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Increase::Card::Renewal, Increase::Internal::AnyHash)
+          end
+
+        # The month the Card expired in before this renewal, in M format (e.g., August is
+        # 8).
+        sig { returns(Integer) }
+        attr_accessor :previous_expiration_month
+
+        # The year the Card expired in before this renewal, in YYYY format (e.g., 2025).
+        sig { returns(Integer) }
+        attr_accessor :previous_expiration_year
+
+        # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+        # the Card was renewed.
+        sig { returns(Time) }
+        attr_accessor :renewed_at
+
+        sig do
+          params(
+            previous_expiration_month: Integer,
+            previous_expiration_year: Integer,
+            renewed_at: Time
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The month the Card expired in before this renewal, in M format (e.g., August is
+          # 8).
+          previous_expiration_month:,
+          # The year the Card expired in before this renewal, in YYYY format (e.g., 2025).
+          previous_expiration_year:,
+          # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+          # the Card was renewed.
+          renewed_at:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              previous_expiration_month: Integer,
+              previous_expiration_year: Integer,
+              renewed_at: Time
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      class ReplacementFor < Increase::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Increase::Card::ReplacementFor, Increase::Internal::AnyHash)
+          end
+
+        # The identifier of the replaced Card.
+        sig { returns(String) }
+        attr_accessor :card_id
+
+        # Why the Card was replaced. Only `expiring` notifies merchants that have the
+        # replaced Card on file of the new Card and moves Digital Wallet Tokens on the
+        # replaced Card that have not been deactivated to the new Card.
+        sig { returns(Increase::Card::ReplacementFor::Reason::TaggedSymbol) }
+        attr_accessor :reason
+
+        # Details about the Card this Card replaces, if it was created as a replacement.
+        sig do
+          params(
+            card_id: String,
+            reason: Increase::Card::ReplacementFor::Reason::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The identifier of the replaced Card.
+          card_id:,
+          # Why the Card was replaced. Only `expiring` notifies merchants that have the
+          # replaced Card on file of the new Card and moves Digital Wallet Tokens on the
+          # replaced Card that have not been deactivated to the new Card.
+          reason:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              card_id: String,
+              reason: Increase::Card::ReplacementFor::Reason::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Why the Card was replaced. Only `expiring` notifies merchants that have the
+        # replaced Card on file of the new Card and moves Digital Wallet Tokens on the
+        # replaced Card that have not been deactivated to the new Card.
+        module Reason
+          extend Increase::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Increase::Card::ReplacementFor::Reason)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          # The replaced card is expiring. Merchants with the replaced card on file will be notified of the new card, and its digital wallet tokens that have not been deactivated will move to the new card.
+          EXPIRING =
+            T.let(
+              :expiring,
+              Increase::Card::ReplacementFor::Reason::TaggedSymbol
+            )
+
+          # The replaced card was lost. Merchants will not be notified of the new card.
+          LOST =
+            T.let(:lost, Increase::Card::ReplacementFor::Reason::TaggedSymbol)
+
+          # The replaced card was stolen. Merchants will not be notified of the new card.
+          STOLEN =
+            T.let(:stolen, Increase::Card::ReplacementFor::Reason::TaggedSymbol)
+
+          # The replaced card was used fraudulently. Merchants will not be notified of the new card.
+          FRAUD =
+            T.let(:fraud, Increase::Card::ReplacementFor::Reason::TaggedSymbol)
+
+          sig do
+            override.returns(
+              T::Array[Increase::Card::ReplacementFor::Reason::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       # This indicates if payments can be made with the card.
       module Status
         extend Increase::Internal::Type::Enum