increase 1.87.0 → 1.89.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 651a08df9db757f9807b44084d880c18a72ba3b8d1b60a32fb21f494cf364f24
-  data.tar.gz: 204a76e612b67a10971a315ba582a122ea93b24ed63cc9886b4a9875062e0097
+  metadata.gz: 7275a50335699dbca8dcdf0923eb6fba66c94f4d2fdc9de51b95e47eb1c7cdfa
+  data.tar.gz: 2c63e95248ae8a51fbdb5cc28129a858bfab693e5270a1224adbc7f1382bd370
 SHA512:
-  metadata.gz: ee3739c424b428642147a8e6be0f1fbc9813b7cb57769dbf8f98302afb3df755ae9bf33fee8ccb64cb45b3a3f78316d6e9510b07d0b04f3bc98ddb4e2d898fc9
-  data.tar.gz: c41e29246c83630864f1ce2a2b95154c666f9153957d891a206a5a9f68c3eda800d2c6eabaf57e7f9880e138404a6750b307e6847c6dd9bc57ab8431c7dc6145
+  metadata.gz: cd47cadc3ae99bc005107f1306016c7e2e96598b515c1f13727e54747c03017d11084f35a256c76c88dc51f4af21fa62c5b153c8451e9078ba08f73d97eea964
+  data.tar.gz: a4f3e10c76f5ad48f5064a28eedc301a1fe656893647ad821f68862cd175fbf48d8a9cd23a1c231dab7a09178b5857c8ad5b5fb505603f6cc6e674c086fc755b

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.89.0 (2025-09-24)
+
+Full Changelog: [v1.88.0...v1.89.0](https://github.com/Increase/increase-ruby/compare/v1.88.0...v1.89.0)
+
+### Features
+
+* **api:** api update ([603e760](https://github.com/Increase/increase-ruby/commit/603e760be76b7ef00f4f13c32e4f79b33a1753e2))
+
+## 1.88.0 (2025-09-24)
+
+Full Changelog: [v1.87.0...v1.88.0](https://github.com/Increase/increase-ruby/compare/v1.87.0...v1.88.0)
+
+### Features
+
+* **api:** api update ([3f9bdb7](https://github.com/Increase/increase-ruby/commit/3f9bdb780f32cc60a80b2db10cf3eea3f7872330))
+
 ## 1.87.0 (2025-09-23)
 
 Full Changelog: [v1.86.0...v1.87.0](https://github.com/Increase/increase-ruby/compare/v1.86.0...v1.87.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "increase", "~> 1.87.0"
+gem "increase", "~> 1.89.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/increase/client.rb

@@ -35,9 +35,6 @@ module Increase
     # @return [Increase::Resources::Cards]
     attr_reader :cards
 
-    # @return [Increase::Resources::CardDetails]
-    attr_reader :card_details
-
     # @return [Increase::Resources::CardPayments]
     attr_reader :card_payments
 
@@ -254,7 +251,6 @@ module Increase
       @account_numbers = Increase::Resources::AccountNumbers.new(client: self)
       @account_transfers = Increase::Resources::AccountTransfers.new(client: self)
       @cards = Increase::Resources::Cards.new(client: self)
-      @card_details = Increase::Resources::CardDetails.new(client: self)
       @card_payments = Increase::Resources::CardPayments.new(client: self)
       @card_purchase_supplements = Increase::Resources::CardPurchaseSupplements.new(client: self)
       @physical_cards = Increase::Resources::PhysicalCards.new(client: self)

data/lib/increase/models/account_transfer.rb

@@ -5,20 +5,20 @@ module Increase
     # @see Increase::Resources::AccountTransfers#create
     class AccountTransfer < Increase::Internal::Type::BaseModel
       # @!attribute id
-      #   The account transfer's identifier.
+      #   The Account Transfer's identifier.
       #
       #   @return [String]
       required :id, String
 
       # @!attribute account_id
-      #   The Account to which the transfer belongs.
+      #   The Account from which the transfer originated.
       #
       #   @return [String]
       required :account_id, String
 
       # @!attribute amount
-      #   The transfer amount in the minor unit of the destination account currency. For
-      #   dollars, for example, this is cents.
+      #   The transfer amount in cents. This will always be positive and indicates the
+      #   amount of money leaving the originating account.
       #
       #   @return [Integer]
       required :amount, Integer
@@ -51,26 +51,28 @@ module Increase
       required :created_by, -> { Increase::AccountTransfer::CreatedBy }, nil?: true
 
       # @!attribute currency
-      #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
-      #   account currency.
+      #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's
+      #   currency.
       #
       #   @return [Symbol, Increase::Models::AccountTransfer::Currency]
       required :currency, enum: -> { Increase::AccountTransfer::Currency }
 
       # @!attribute description
-      #   The description that will show on the transactions.
+      #   An internal-facing description for the transfer for display in the API and
+      #   dashboard. This will also show in the description of the created Transactions.
       #
       #   @return [String]
       required :description, String
 
       # @!attribute destination_account_id
-      #   The destination account's identifier.
+      #   The destination Account's identifier.
       #
       #   @return [String]
       required :destination_account_id, String
 
       # @!attribute destination_transaction_id
-      #   The ID for the transaction receiving the transfer.
+      #   The identifier of the Transaction on the destination Account representing the
+      #   received funds.
       #
       #   @return [String, nil]
       required :destination_transaction_id, String, nil?: true
@@ -83,12 +85,6 @@ module Increase
       #   @return [String, nil]
       required :idempotency_key, String, nil?: true
 
-      # @!attribute network
-      #   The transfer's network.
-      #
-      #   @return [Symbol, Increase::Models::AccountTransfer::Network]
-      required :network, enum: -> { Increase::AccountTransfer::Network }
-
       # @!attribute pending_transaction_id
       #   The ID for the pending transaction representing the transfer. A pending
       #   transaction is created when the transfer
@@ -105,7 +101,8 @@ module Increase
       required :status, enum: -> { Increase::AccountTransfer::Status }
 
       # @!attribute transaction_id
-      #   The ID for the transaction funding the transfer.
+      #   The identifier of the Transaction on the originating account representing the
+      #   transferred funds.
       #
       #   @return [String, nil]
       required :transaction_id, String, nil?: true
@@ -117,17 +114,22 @@ module Increase
       #   @return [Symbol, Increase::Models::AccountTransfer::Type]
       required :type, enum: -> { Increase::AccountTransfer::Type }
 
-      # @!method initialize(id:, account_id:, amount:, approval:, cancellation:, created_at:, created_by:, currency:, description:, destination_account_id:, destination_transaction_id:, idempotency_key:, network:, pending_transaction_id:, status:, transaction_id:, type:)
+      # @!method initialize(id:, account_id:, amount:, approval:, cancellation:, created_at:, created_by:, currency:, description:, destination_account_id:, destination_transaction_id:, idempotency_key:, pending_transaction_id:, status:, transaction_id:, type:)
       #   Some parameter documentations has been truncated, see
       #   {Increase::Models::AccountTransfer} for more details.
       #
-      #   Account transfers move funds between your own accounts at Increase.
+      #   Account transfers move funds between your own accounts at Increase (accounting
+      #   systems often refer to these as Book Transfers). Account Transfers are free and
+      #   synchronous. Upon creation they create two Transactions, one negative on the
+      #   originating account and one positive on the destination account (unless the
+      #   transfer requires approval, in which case the Transactions will be created when
+      #   the transfer is approved).
       #
-      #   @param id [String] The account transfer's identifier.
+      #   @param id [String] The Account Transfer's identifier.
       #
-      #   @param account_id [String] The Account to which the transfer belongs.
+      #   @param account_id [String] The Account from which the transfer originated.
       #
-      #   @param amount [Integer] The transfer amount in the minor unit of the destination account currency. For d
+      #   @param amount [Integer] The transfer amount in cents. This will always be positive and indicates the amo
       #
       #   @param approval [Increase::Models::AccountTransfer::Approval, nil] If your account requires approvals for transfers and the transfer was approved,
       #
@@ -137,23 +139,21 @@ module Increase
       #
       #   @param created_by [Increase::Models::AccountTransfer::CreatedBy, nil] What object created the transfer, either via the API or the dashboard.
       #
-      #   @param currency [Symbol, Increase::Models::AccountTransfer::Currency] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
+      #   @param currency [Symbol, Increase::Models::AccountTransfer::Currency] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's c
       #
-      #   @param description [String] The description that will show on the transactions.
+      #   @param description [String] An internal-facing description for the transfer for display in the API and dashb
       #
-      #   @param destination_account_id [String] The destination account's identifier.
+      #   @param destination_account_id [String] The destination Account's identifier.
       #
-      #   @param destination_transaction_id [String, nil] The ID for the transaction receiving the transfer.
+      #   @param destination_transaction_id [String, nil] The identifier of the Transaction on the destination Account representing the re
       #
       #   @param idempotency_key [String, nil] The idempotency key you chose for this object. This value is unique across Incre
       #
-      #   @param network [Symbol, Increase::Models::AccountTransfer::Network] The transfer's network.
-      #
       #   @param pending_transaction_id [String, nil] The ID for the pending transaction representing the transfer. A pending transact
       #
       #   @param status [Symbol, Increase::Models::AccountTransfer::Status] The lifecycle status of the transfer.
       #
-      #   @param transaction_id [String, nil] The ID for the transaction funding the transfer.
+      #   @param transaction_id [String, nil] The identifier of the Transaction on the originating account representing the tr
       #
       #   @param type [Symbol, Increase::Models::AccountTransfer::Type] A constant representing the object's type. For this resource it will always be `
 
@@ -312,8 +312,8 @@ module Increase
         end
       end
 
-      # The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
-      # account currency.
+      # The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's
+      # currency.
       #
       # @see Increase::Models::AccountTransfer#currency
       module Currency
@@ -341,28 +341,16 @@ module Increase
         #   @return [Array<Symbol>]
       end
 
-      # The transfer's network.
-      #
-      # @see Increase::Models::AccountTransfer#network
-      module Network
-        extend Increase::Internal::Type::Enum
-
-        ACCOUNT = :account
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
-
       # The lifecycle status of the transfer.
       #
       # @see Increase::Models::AccountTransfer#status
       module Status
         extend Increase::Internal::Type::Enum
 
-        # The transfer is pending approval.
+        # The transfer is pending approval from your team.
         PENDING_APPROVAL = :pending_approval
 
-        # The transfer has been canceled.
+        # The transfer was pending approval from your team and has been canceled.
         CANCELED = :canceled
 
         # The transfer has been completed.

data/lib/increase/models/account_transfer_create_params.rb

@@ -8,7 +8,7 @@ module Increase
       include Increase::Internal::Type::RequestParameters
 
       # @!attribute account_id
-      #   The identifier for the account that will send the transfer.
+      #   The identifier for the originating Account that will send the transfer.
       #
       #   @return [String]
       required :account_id, String
@@ -21,19 +21,22 @@ module Increase
       required :amount, Integer
 
       # @!attribute description
-      #   The description you choose to give the transfer.
+      #   An internal-facing description for the transfer for display in the API and
+      #   dashboard. This will also show in the description of the created Transactions.
       #
       #   @return [String]
       required :description, String
 
       # @!attribute destination_account_id
-      #   The identifier for the account that will receive the transfer.
+      #   The identifier for the destination Account that will receive the transfer.
       #
       #   @return [String]
       required :destination_account_id, String
 
       # @!attribute require_approval
-      #   Whether the transfer requires explicit approval via the dashboard or API.
+      #   Whether the transfer should require explicit approval via the dashboard or API.
+      #   For more information, see
+      #   [Transfer Approvals](/documentation/transfer-approvals).
       #
       #   @return [Boolean, nil]
       optional :require_approval, Increase::Internal::Type::Boolean
@@ -42,15 +45,15 @@ module Increase
       #   Some parameter documentations has been truncated, see
       #   {Increase::Models::AccountTransferCreateParams} for more details.
       #
-      #   @param account_id [String] The identifier for the account that will send the transfer.
+      #   @param account_id [String] The identifier for the originating Account that will send the transfer.
       #
       #   @param amount [Integer] The transfer amount in the minor unit of the account currency. For dollars, for
       #
-      #   @param description [String] The description you choose to give the transfer.
+      #   @param description [String] An internal-facing description for the transfer for display in the API and dashb
       #
-      #   @param destination_account_id [String] The identifier for the account that will receive the transfer.
+      #   @param destination_account_id [String] The identifier for the destination Account that will receive the transfer.
       #
-      #   @param require_approval [Boolean] Whether the transfer requires explicit approval via the dashboard or API.
+      #   @param require_approval [Boolean] Whether the transfer should require explicit approval via the dashboard or API.
       #
       #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/increase/models/{card_detail_create_details_iframe_params.rb → card_create_details_iframe_params.rb}

@@ -2,19 +2,23 @@
 
 module Increase
   module Models
-    # @see Increase::Resources::CardDetails#create_details_iframe
-    class CardDetailCreateDetailsIframeParams < Increase::Internal::Type::BaseModel
+    # @see Increase::Resources::Cards#create_details_iframe
+    class CardCreateDetailsIframeParams < Increase::Internal::Type::BaseModel
       extend Increase::Internal::Type::RequestParameters::Converter
       include Increase::Internal::Type::RequestParameters
 
       # @!attribute physical_card_id
-      #   The identifier of the Physical Card to retrieve details for.
+      #   The identifier of the Physical Card to create an iframe for. This will inform
+      #   the appearance of the card rendered in the iframe.
       #
       #   @return [String, nil]
       optional :physical_card_id, String
 
       # @!method initialize(physical_card_id: nil, request_options: {})
-      #   @param physical_card_id [String] The identifier of the Physical Card to retrieve details for.
+      #   Some parameter documentations has been truncated, see
+      #   {Increase::Models::CardCreateDetailsIframeParams} for more details.
+      #
+      #   @param physical_card_id [String] The identifier of the Physical Card to create an iframe for. This will inform th
       #
       #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/increase/models/card_details.rb

@@ -2,8 +2,8 @@
 
 module Increase
   module Models
-    # @see Increase::Resources::CardDetails#update
-    class CardDetailsAPI < Increase::Internal::Type::BaseModel
+    # @see Increase::Resources::Cards#details
+    class CardDetails < Increase::Internal::Type::BaseModel
       # @!attribute card_id
       #   The identifier for the Card for which sensitive details have been returned.
       #
@@ -38,8 +38,8 @@ module Increase
       #   A constant representing the object's type. For this resource it will always be
       #   `card_details`.
       #
-      #   @return [Symbol, Increase::Models::CardDetailsAPI::Type]
-      required :type, enum: -> { Increase::CardDetailsAPI::Type }
+      #   @return [Symbol, Increase::Models::CardDetails::Type]
+      required :type, enum: -> { Increase::CardDetails::Type }
 
       # @!attribute verification_code
       #   The three-digit verification code for the card. It's also known as the Card
@@ -51,7 +51,7 @@ module Increase
 
       # @!method initialize(card_id:, expiration_month:, expiration_year:, pin:, primary_account_number:, type:, verification_code:)
       #   Some parameter documentations has been truncated, see
-      #   {Increase::Models::CardDetailsAPI} for more details.
+      #   {Increase::Models::CardDetails} for more details.
       #
       #   An object containing the sensitive details (card number, CVC, PIN, etc) for a
       #   Card. These details are not included in the Card object. If you'd prefer to
@@ -69,14 +69,14 @@ module Increase
       #
       #   @param primary_account_number [String] The card number.
       #
-      #   @param type [Symbol, Increase::Models::CardDetailsAPI::Type] A constant representing the object's type. For this resource it will always be `
+      #   @param type [Symbol, Increase::Models::CardDetails::Type] A constant representing the object's type. For this resource it will always be `
       #
       #   @param verification_code [String] The three-digit verification code for the card. It's also known as the Card Veri
 
       # A constant representing the object's type. For this resource it will always be
       # `card_details`.
       #
-      # @see Increase::Models::CardDetailsAPI#type
+      # @see Increase::Models::CardDetails#type
       module Type
         extend Increase::Internal::Type::Enum
 

data/lib/increase/models/{card_detail_details_params.rb → card_details_params.rb}

@@ -2,8 +2,8 @@
 
 module Increase
   module Models
-    # @see Increase::Resources::CardDetails#details
-    class CardDetailDetailsParams < Increase::Internal::Type::BaseModel
+    # @see Increase::Resources::Cards#details
+    class CardDetailsParams < Increase::Internal::Type::BaseModel
       extend Increase::Internal::Type::RequestParameters::Converter
       include Increase::Internal::Type::RequestParameters
 

data/lib/increase/models/card_iframe_url.rb

@@ -2,7 +2,7 @@
 
 module Increase
   module Models
-    # @see Increase::Resources::CardDetails#create_details_iframe
+    # @see Increase::Resources::Cards#create_details_iframe
     class CardIframeURL < Increase::Internal::Type::BaseModel
       # @!attribute expires_at
       #   The time the iframe URL will expire.

data/lib/increase/models/card_update_params.rb

@@ -34,19 +34,13 @@ module Increase
       #   @return [String, nil]
       optional :entity_id, String
 
-      # @!attribute pin
-      #   The 4-digit PIN for the card, for use with ATMs.
-      #
-      #   @return [String, nil]
-      optional :pin, String
-
       # @!attribute status
       #   The status to update the Card with.
       #
       #   @return [Symbol, Increase::Models::CardUpdateParams::Status, nil]
       optional :status, enum: -> { Increase::CardUpdateParams::Status }
 
-      # @!method initialize(billing_address: nil, description: nil, digital_wallet: nil, entity_id: nil, pin: nil, status: nil, request_options: {})
+      # @!method initialize(billing_address: nil, description: nil, digital_wallet: nil, entity_id: nil, status: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Increase::Models::CardUpdateParams} for more details.
       #
@@ -58,8 +52,6 @@ module Increase
       #
       #   @param entity_id [String] The Entity the card belongs to. You only need to supply this in rare situations
       #
-      #   @param pin [String] The 4-digit PIN for the card, for use with ATMs.
-      #
       #   @param status [Symbol, Increase::Models::CardUpdateParams::Status] The status to update the Card with.
       #
       #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]

data/lib/increase/models/{card_detail_update_params.rb → card_update_pin_params.rb}

@@ -2,8 +2,8 @@
 
 module Increase
   module Models
-    # @see Increase::Resources::CardDetails#update
-    class CardDetailUpdateParams < Increase::Internal::Type::BaseModel
+    # @see Increase::Resources::Cards#update_pin
+    class CardUpdatePinParams < Increase::Internal::Type::BaseModel
       extend Increase::Internal::Type::RequestParameters::Converter
       include Increase::Internal::Type::RequestParameters
 

data/lib/increase/models.rb

@@ -131,15 +131,13 @@ module Increase
 
   Card = Increase::Models::Card
 
-  CardCreateParams = Increase::Models::CardCreateParams
-
-  CardDetailCreateDetailsIframeParams = Increase::Models::CardDetailCreateDetailsIframeParams
+  CardCreateDetailsIframeParams = Increase::Models::CardCreateDetailsIframeParams
 
-  CardDetailDetailsParams = Increase::Models::CardDetailDetailsParams
+  CardCreateParams = Increase::Models::CardCreateParams
 
-  CardDetailsAPI = Increase::Models::CardDetailsAPI
+  CardDetails = Increase::Models::CardDetails
 
-  CardDetailUpdateParams = Increase::Models::CardDetailUpdateParams
+  CardDetailsParams = Increase::Models::CardDetailsParams
 
   CardIframeURL = Increase::Models::CardIframeURL
 
@@ -183,6 +181,8 @@ module Increase
 
   CardUpdateParams = Increase::Models::CardUpdateParams
 
+  CardUpdatePinParams = Increase::Models::CardUpdatePinParams
+
   CardValidation = Increase::Models::CardValidation
 
   CardValidationCreateParams = Increase::Models::CardValidationCreateParams

data/lib/increase/resources/account_transfers.rb

@@ -10,15 +10,15 @@ module Increase
       #
       # @overload create(account_id:, amount:, description:, destination_account_id:, require_approval: nil, request_options: {})
       #
-      # @param account_id [String] The identifier for the account that will send the transfer.
+      # @param account_id [String] The identifier for the originating Account that will send the transfer.
       #
       # @param amount [Integer] The transfer amount in the minor unit of the account currency. For dollars, for
       #
-      # @param description [String] The description you choose to give the transfer.
+      # @param description [String] An internal-facing description for the transfer for display in the API and dashb
       #
-      # @param destination_account_id [String] The identifier for the account that will receive the transfer.
+      # @param destination_account_id [String] The identifier for the destination Account that will receive the transfer.
       #
-      # @param require_approval [Boolean] Whether the transfer requires explicit approval via the dashboard or API.
+      # @param require_approval [Boolean] Whether the transfer should require explicit approval via the dashboard or API.
       #
       # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -90,7 +90,7 @@ module Increase
         )
       end
 
-      # Approve an Account Transfer
+      # Approves an Account Transfer in status `pending_approval`.
       #
       # @overload approve(account_transfer_id, request_options: {})
       #
@@ -110,7 +110,7 @@ module Increase
         )
       end
 
-      # Cancel an Account Transfer
+      # Cancels an Account Transfer in status `pending_approval`.
       #
       # @overload cancel(account_transfer_id, request_options: {})
       #

data/lib/increase/resources/cards.rb

@@ -55,7 +55,7 @@ module Increase
       #
       # Update a Card
       #
-      # @overload update(card_id, billing_address: nil, description: nil, digital_wallet: nil, entity_id: nil, pin: nil, status: nil, request_options: {})
+      # @overload update(card_id, billing_address: nil, description: nil, digital_wallet: nil, entity_id: nil, status: nil, request_options: {})
       #
       # @param card_id [String] The card identifier.
       #
@@ -67,8 +67,6 @@ module Increase
       #
       # @param entity_id [String] The Entity the card belongs to. You only need to supply this in rare situations
       #
-      # @param pin [String] The 4-digit PIN for the card, for use with ATMs.
-      #
       # @param status [Symbol, Increase::Models::CardUpdateParams::Status] The status to update the Card with.
       #
       # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -123,6 +121,80 @@ module Increase
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Increase::Models::CardCreateDetailsIframeParams} for more details.
+      #
+      # Create an iframe URL for a Card to display the card details. More details about
+      # styling and usage can be found in the
+      # [documentation](/documentation/embedded-card-component).
+      #
+      # @overload create_details_iframe(card_id, physical_card_id: nil, request_options: {})
+      #
+      # @param card_id [String] The identifier of the Card to create an iframe for.
+      #
+      # @param physical_card_id [String] The identifier of the Physical Card to create an iframe for. This will inform th
+      #
+      # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Increase::Models::CardIframeURL]
+      #
+      # @see Increase::Models::CardCreateDetailsIframeParams
+      def create_details_iframe(card_id, params = {})
+        parsed, options = Increase::CardCreateDetailsIframeParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["cards/%1$s/create_details_iframe", card_id],
+          body: parsed,
+          model: Increase::CardIframeURL,
+          options: options
+        )
+      end
+
+      # Sensitive details for a Card include the primary account number, expiry, card
+      # verification code, and PIN.
+      #
+      # @overload details(card_id, request_options: {})
+      #
+      # @param card_id [String] The identifier of the Card to retrieve details for.
+      #
+      # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Increase::Models::CardDetails]
+      #
+      # @see Increase::Models::CardDetailsParams
+      def details(card_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["cards/%1$s/details", card_id],
+          model: Increase::CardDetails,
+          options: params[:request_options]
+        )
+      end
+
+      # Update a Card's PIN
+      #
+      # @overload update_pin(card_id, pin:, request_options: {})
+      #
+      # @param card_id [String] The identifier of the Card to update the PIN for.
+      #
+      # @param pin [String] The 4-digit PIN for the card, for use with ATMs.
+      #
+      # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Increase::Models::CardDetails]
+      #
+      # @see Increase::Models::CardUpdatePinParams
+      def update_pin(card_id, params)
+        parsed, options = Increase::CardUpdatePinParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["cards/%1$s/update_pin", card_id],
+          body: parsed,
+          model: Increase::CardDetails,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Increase::Client]

data/lib/increase/version.rb

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

data/lib/increase.rb

@@ -97,11 +97,10 @@ require_relative "increase/models/bookkeeping_entry_set_create_params"
 require_relative "increase/models/bookkeeping_entry_set_list_params"
 require_relative "increase/models/bookkeeping_entry_set_retrieve_params"
 require_relative "increase/models/card"
+require_relative "increase/models/card_create_details_iframe_params"
 require_relative "increase/models/card_create_params"
-require_relative "increase/models/card_detail_create_details_iframe_params"
-require_relative "increase/models/card_detail_details_params"
 require_relative "increase/models/card_details"
-require_relative "increase/models/card_detail_update_params"
+require_relative "increase/models/card_details_params"
 require_relative "increase/models/card_iframe_url"
 require_relative "increase/models/card_list_params"
 require_relative "increase/models/card_payment"
@@ -123,6 +122,7 @@ require_relative "increase/models/card_token_capabilities_params"
 require_relative "increase/models/card_token_list_params"
 require_relative "increase/models/card_token_retrieve_params"
 require_relative "increase/models/card_update_params"
+require_relative "increase/models/card_update_pin_params"
 require_relative "increase/models/card_validation"
 require_relative "increase/models/card_validation_create_params"
 require_relative "increase/models/card_validation_list_params"
@@ -335,7 +335,6 @@ require_relative "increase/resources/ach_transfers"
 require_relative "increase/resources/bookkeeping_accounts"
 require_relative "increase/resources/bookkeeping_entries"
 require_relative "increase/resources/bookkeeping_entry_sets"
-require_relative "increase/resources/card_details"
 require_relative "increase/resources/card_payments"
 require_relative "increase/resources/card_purchase_supplements"
 require_relative "increase/resources/card_push_transfers"

data/rbi/increase/client.rbi

@@ -34,9 +34,6 @@ module Increase
     sig { returns(Increase::Resources::Cards) }
     attr_reader :cards
 
-    sig { returns(Increase::Resources::CardDetails) }
-    attr_reader :card_details
-
     sig { returns(Increase::Resources::CardPayments) }
     attr_reader :card_payments