increase 1.0.0 → 1.2.0

data/lib/increase/models/inbound_mail_item.rb

@@ -10,6 +10,12 @@ module Increase
       #   @return [String]
       required :id, String
 
+      # @!attribute checks
+      #   The checks in the mail item.
+      #
+      #   @return [Array<Increase::Models::InboundMailItem::Check>]
+      required :checks, -> { Increase::Internal::Type::ArrayOf[Increase::InboundMailItem::Check] }
+
       # @!attribute created_at
       #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Inbound
       #   Mail Item was created.
@@ -55,7 +61,7 @@ module Increase
       #   @return [Symbol, Increase::Models::InboundMailItem::Type]
       required :type, enum: -> { Increase::InboundMailItem::Type }
 
-      # @!method initialize(id:, created_at:, file_id:, lockbox_id:, recipient_name:, rejection_reason:, status:, type:)
+      # @!method initialize(id:, checks:, created_at:, file_id:, lockbox_id:, recipient_name:, rejection_reason:, status:, type:)
       #   Some parameter documentations has been truncated, see
       #   {Increase::Models::InboundMailItem} for more details.
       #
@@ -63,6 +69,8 @@ module Increase
       #
       #   @param id [String] The Inbound Mail Item identifier.
       #
+      #   @param checks [Array<Increase::Models::InboundMailItem::Check>] The checks in the mail item.
+      #
       #   @param created_at [Time] The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Inbound
       #
       #   @param file_id [String] The identifier for the File containing the scanned contents of the mail item.
@@ -77,6 +85,35 @@ module Increase
       #
       #   @param type [Symbol, Increase::Models::InboundMailItem::Type] A constant representing the object's type. For this resource it will always be `
 
+      class Check < Increase::Internal::Type::BaseModel
+        # @!attribute amount
+        #   The amount of the check.
+        #
+        #   @return [Integer]
+        required :amount, Integer
+
+        # @!attribute back_file_id
+        #   The identifier for the File containing the back of the check.
+        #
+        #   @return [String, nil]
+        required :back_file_id, String, nil?: true
+
+        # @!attribute front_file_id
+        #   The identifier for the File containing the front of the check.
+        #
+        #   @return [String, nil]
+        required :front_file_id, String, nil?: true
+
+        # @!method initialize(amount:, back_file_id:, front_file_id:)
+        #   Inbound Mail Item Checks represent the checks in an Inbound Mail Item.
+        #
+        #   @param amount [Integer] The amount of the check.
+        #
+        #   @param back_file_id [String, nil] The identifier for the File containing the back of the check.
+        #
+        #   @param front_file_id [String, nil] The identifier for the File containing the front of the check.
+      end
+
       # If the mail item has been rejected, why it was rejected.
       #
       # @see Increase::Models::InboundMailItem#rejection_reason

data/lib/increase/models/pending_transaction.rb

@@ -227,6 +227,15 @@ module Increase
                  },
                  nil?: true
 
+        # @!attribute card_push_transfer_instruction
+        #   A Card Push Transfer Instruction object. This field will be present in the JSON
+        #   response if and only if `category` is equal to `card_push_transfer_instruction`.
+        #
+        #   @return [Increase::Models::PendingTransaction::Source::CardPushTransferInstruction, nil]
+        required :card_push_transfer_instruction,
+                 -> { Increase::PendingTransaction::Source::CardPushTransferInstruction },
+                 nil?: true
+
         # @!attribute category
         #   The type of the resource. We may add additional possible values for this enum
         #   over time; your application should be able to handle such additions gracefully.
@@ -283,16 +292,6 @@ module Increase
         #   @return [Object, nil]
         required :other, Increase::Internal::Type::Unknown, nil?: true
 
-        # @!attribute outbound_card_push_transfer_instruction
-        #   An Outbound Card Push Transfer Instruction object. This field will be present in
-        #   the JSON response if and only if `category` is equal to
-        #   `outbound_card_push_transfer_instruction`.
-        #
-        #   @return [Increase::Models::PendingTransaction::Source::OutboundCardPushTransferInstruction, nil]
-        required :outbound_card_push_transfer_instruction,
-                 -> { Increase::PendingTransaction::Source::OutboundCardPushTransferInstruction },
-                 nil?: true
-
         # @!attribute real_time_payments_transfer_instruction
         #   A Real-Time Payments Transfer Instruction object. This field will be present in
         #   the JSON response if and only if `category` is equal to
@@ -329,7 +328,7 @@ module Increase
                  -> { Increase::PendingTransaction::Source::WireTransferInstruction },
                  nil?: true
 
-        # @!method initialize(account_transfer_instruction:, ach_transfer_instruction:, card_authorization:, category:, check_deposit_instruction:, check_transfer_instruction:, inbound_funds_hold:, inbound_wire_transfer_reversal:, other:, outbound_card_push_transfer_instruction:, real_time_payments_transfer_instruction:, swift_transfer_instruction:, user_initiated_hold:, wire_transfer_instruction:)
+        # @!method initialize(account_transfer_instruction:, ach_transfer_instruction:, card_authorization:, card_push_transfer_instruction:, category:, check_deposit_instruction:, check_transfer_instruction:, inbound_funds_hold:, inbound_wire_transfer_reversal:, other:, real_time_payments_transfer_instruction:, swift_transfer_instruction:, user_initiated_hold:, wire_transfer_instruction:)
         #   Some parameter documentations has been truncated, see
         #   {Increase::Models::PendingTransaction::Source} for more details.
         #
@@ -343,6 +342,8 @@ module Increase
         #
         #   @param card_authorization [Increase::Models::PendingTransaction::Source::CardAuthorization, nil] A Card Authorization object. This field will be present in the JSON response if
         #
+        #   @param card_push_transfer_instruction [Increase::Models::PendingTransaction::Source::CardPushTransferInstruction, nil] A Card Push Transfer Instruction object. This field will be present in the JSON
+        #
         #   @param category [Symbol, Increase::Models::PendingTransaction::Source::Category] The type of the resource. We may add additional possible values for this enum ov
         #
         #   @param check_deposit_instruction [Increase::Models::PendingTransaction::Source::CheckDepositInstruction, nil] A Check Deposit Instruction object. This field will be present in the JSON respo
@@ -355,8 +356,6 @@ module Increase
         #
         #   @param other [Object, nil] If the category of this Transaction source is equal to `other`, this field will
         #
-        #   @param outbound_card_push_transfer_instruction [Increase::Models::PendingTransaction::Source::OutboundCardPushTransferInstruction, nil] An Outbound Card Push Transfer Instruction object. This field will be present in
-        #
         #   @param real_time_payments_transfer_instruction [Increase::Models::PendingTransaction::Source::RealTimePaymentsTransferInstruction, nil] A Real-Time Payments Transfer Instruction object. This field will be present in
         #
         #   @param swift_transfer_instruction [Increase::Models::PendingTransaction::Source::SwiftTransferInstruction, nil] A Swift Transfer Instruction object. This field will be present in the JSON resp
@@ -1210,6 +1209,29 @@ module Increase
           end
         end
 
+        # @see Increase::Models::PendingTransaction::Source#card_push_transfer_instruction
+        class CardPushTransferInstruction < Increase::Internal::Type::BaseModel
+          # @!attribute amount
+          #   The transfer amount in USD cents.
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute transfer_id
+          #   The identifier of the Card Push Transfer that led to this Pending Transaction.
+          #
+          #   @return [String]
+          required :transfer_id, String
+
+          # @!method initialize(amount:, transfer_id:)
+          #   A Card Push Transfer Instruction object. This field will be present in the JSON
+          #   response if and only if `category` is equal to `card_push_transfer_instruction`.
+          #
+          #   @param amount [Integer] The transfer amount in USD cents.
+          #
+          #   @param transfer_id [String] The identifier of the Card Push Transfer that led to this Pending Transaction.
+        end
+
         # The type of the resource. We may add additional possible values for this enum
         # over time; your application should be able to handle such additions gracefully.
         #
@@ -1250,8 +1272,8 @@ module Increase
           # Swift Transfer Instruction: details will be under the `swift_transfer_instruction` object.
           SWIFT_TRANSFER_INSTRUCTION = :swift_transfer_instruction
 
-          # Outbound Card Push Transfer Instruction: details will be under the `outbound_card_push_transfer_instruction` object.
-          OUTBOUND_CARD_PUSH_TRANSFER_INSTRUCTION = :outbound_card_push_transfer_instruction
+          # Card Push Transfer Instruction: details will be under the `card_push_transfer_instruction` object.
+          CARD_PUSH_TRANSFER_INSTRUCTION = :card_push_transfer_instruction
 
           # The Pending Transaction was made for an undocumented or deprecated reason.
           OTHER = :other
@@ -1587,35 +1609,6 @@ module Increase
           #   @param inbound_wire_transfer_id [String] The ID of the Inbound Wire Transfer that is being reversed.
         end
 
-        # @see Increase::Models::PendingTransaction::Source#outbound_card_push_transfer_instruction
-        class OutboundCardPushTransferInstruction < Increase::Internal::Type::BaseModel
-          # @!attribute amount
-          #   The transfer amount in USD cents.
-          #
-          #   @return [Integer]
-          required :amount, Integer
-
-          # @!attribute transfer_id
-          #   The identifier of the Outbound Card Push Transfer that led to this Pending
-          #   Transaction.
-          #
-          #   @return [String]
-          required :transfer_id, String
-
-          # @!method initialize(amount:, transfer_id:)
-          #   Some parameter documentations has been truncated, see
-          #   {Increase::Models::PendingTransaction::Source::OutboundCardPushTransferInstruction}
-          #   for more details.
-          #
-          #   An Outbound Card Push Transfer Instruction object. This field will be present in
-          #   the JSON response if and only if `category` is equal to
-          #   `outbound_card_push_transfer_instruction`.
-          #
-          #   @param amount [Integer] The transfer amount in USD cents.
-          #
-          #   @param transfer_id [String] The identifier of the Outbound Card Push Transfer that led to this Pending Trans
-        end
-
         # @see Increase::Models::PendingTransaction::Source#real_time_payments_transfer_instruction
         class RealTimePaymentsTransferInstruction < Increase::Internal::Type::BaseModel
           # @!attribute amount

data/lib/increase/models/pending_transaction_list_params.rb

@@ -121,8 +121,8 @@ module Increase
           # Swift Transfer Instruction: details will be under the `swift_transfer_instruction` object.
           SWIFT_TRANSFER_INSTRUCTION = :swift_transfer_instruction
 
-          # Outbound Card Push Transfer Instruction: details will be under the `outbound_card_push_transfer_instruction` object.
-          OUTBOUND_CARD_PUSH_TRANSFER_INSTRUCTION = :outbound_card_push_transfer_instruction
+          # Card Push Transfer Instruction: details will be under the `card_push_transfer_instruction` object.
+          CARD_PUSH_TRANSFER_INSTRUCTION = :card_push_transfer_instruction
 
           # The Pending Transaction was made for an undocumented or deprecated reason.
           OTHER = :other

data/lib/increase/models/transaction.rb

@@ -221,6 +221,17 @@ module Increase
         #   @return [Increase::Models::Transaction::Source::CardDisputeLoss, nil]
         required :card_dispute_loss, -> { Increase::Transaction::Source::CardDisputeLoss }, nil?: true
 
+        # @!attribute card_push_transfer_acceptance
+        #   A Card Push Transfer Acceptance object. This field will be present in the JSON
+        #   response if and only if `category` is equal to `card_push_transfer_acceptance`.
+        #   A Card Push Transfer Acceptance is created when an Outbound Card Push Transfer
+        #   sent from Increase is accepted by the receiving bank.
+        #
+        #   @return [Increase::Models::Transaction::Source::CardPushTransferAcceptance, nil]
+        required :card_push_transfer_acceptance,
+                 -> { Increase::Transaction::Source::CardPushTransferAcceptance },
+                 nil?: true
+
         # @!attribute card_refund
         #   A Card Refund object. This field will be present in the JSON response if and
         #   only if `category` is equal to `card_refund`. Card Refunds move money back to
@@ -430,18 +441,6 @@ module Increase
         #   @return [Object, nil]
         required :other, Increase::Internal::Type::Unknown, nil?: true
 
-        # @!attribute outbound_card_push_transfer_acceptance
-        #   An Outbound Card Push Transfer Acceptance object. This field will be present in
-        #   the JSON response if and only if `category` is equal to
-        #   `outbound_card_push_transfer_acceptance`. An Outbound Card Push Transfer
-        #   Acceptance is created when an Outbound Card Push Transfer sent from Increase is
-        #   accepted by the receiving bank.
-        #
-        #   @return [Increase::Models::Transaction::Source::OutboundCardPushTransferAcceptance, nil]
-        required :outbound_card_push_transfer_acceptance,
-                 -> { Increase::Transaction::Source::OutboundCardPushTransferAcceptance },
-                 nil?: true
-
         # @!attribute real_time_payments_transfer_acknowledgement
         #   A Real-Time Payments Transfer Acknowledgement object. This field will be present
         #   in the JSON response if and only if `category` is equal to
@@ -484,7 +483,7 @@ module Increase
                  },
                  nil?: true
 
-        # @!method initialize(account_transfer_intention:, ach_transfer_intention:, ach_transfer_rejection:, ach_transfer_return:, card_dispute_acceptance:, card_dispute_loss:, card_refund:, card_revenue_payment:, card_settlement:, cashback_payment:, category:, check_deposit_acceptance:, check_deposit_return:, check_transfer_deposit:, fee_payment:, inbound_ach_transfer:, inbound_ach_transfer_return_intention:, inbound_check_adjustment:, inbound_check_deposit_return_intention:, inbound_real_time_payments_transfer_confirmation:, inbound_real_time_payments_transfer_decline:, inbound_wire_reversal:, inbound_wire_transfer:, inbound_wire_transfer_reversal:, interest_payment:, internal_source:, other:, outbound_card_push_transfer_acceptance:, real_time_payments_transfer_acknowledgement:, sample_funds:, swift_transfer_intention:, wire_transfer_intention:)
+        # @!method initialize(account_transfer_intention:, ach_transfer_intention:, ach_transfer_rejection:, ach_transfer_return:, card_dispute_acceptance:, card_dispute_loss:, card_push_transfer_acceptance:, card_refund:, card_revenue_payment:, card_settlement:, cashback_payment:, category:, check_deposit_acceptance:, check_deposit_return:, check_transfer_deposit:, fee_payment:, inbound_ach_transfer:, inbound_ach_transfer_return_intention:, inbound_check_adjustment:, inbound_check_deposit_return_intention:, inbound_real_time_payments_transfer_confirmation:, inbound_real_time_payments_transfer_decline:, inbound_wire_reversal:, inbound_wire_transfer:, inbound_wire_transfer_reversal:, interest_payment:, internal_source:, other:, real_time_payments_transfer_acknowledgement:, sample_funds:, swift_transfer_intention:, wire_transfer_intention:)
         #   Some parameter documentations has been truncated, see
         #   {Increase::Models::Transaction::Source} for more details.
         #
@@ -505,6 +504,8 @@ module Increase
         #
         #   @param card_dispute_loss [Increase::Models::Transaction::Source::CardDisputeLoss, nil] A Card Dispute Loss object. This field will be present in the JSON response if a
         #
+        #   @param card_push_transfer_acceptance [Increase::Models::Transaction::Source::CardPushTransferAcceptance, nil] A Card Push Transfer Acceptance object. This field will be present in the JSON r
+        #
         #   @param card_refund [Increase::Models::Transaction::Source::CardRefund, nil] A Card Refund object. This field will be present in the JSON response if and onl
         #
         #   @param card_revenue_payment [Increase::Models::Transaction::Source::CardRevenuePayment, nil] A Card Revenue Payment object. This field will be present in the JSON response i
@@ -547,8 +548,6 @@ module Increase
         #
         #   @param other [Object, nil] If the category of this Transaction source is equal to `other`, this field will
         #
-        #   @param outbound_card_push_transfer_acceptance [Increase::Models::Transaction::Source::OutboundCardPushTransferAcceptance, nil] An Outbound Card Push Transfer Acceptance object. This field will be present in
-        #
         #   @param real_time_payments_transfer_acknowledgement [Increase::Models::Transaction::Source::RealTimePaymentsTransferAcknowledgement, nil] A Real-Time Payments Transfer Acknowledgement object. This field will be present
         #
         #   @param sample_funds [Increase::Models::Transaction::Source::SampleFunds, nil] A Sample Funds object. This field will be present in the JSON response if and on
@@ -1094,6 +1093,31 @@ module Increase
           #   @param transaction_id [String] The identifier of the Transaction that was created to debit the disputed funds f
         end
 
+        # @see Increase::Models::Transaction::Source#card_push_transfer_acceptance
+        class CardPushTransferAcceptance < Increase::Internal::Type::BaseModel
+          # @!attribute amount
+          #   The transfer amount in USD cents.
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute transfer_id
+          #   The identifier of the Card Push Transfer that led to this Transaction.
+          #
+          #   @return [String]
+          required :transfer_id, String
+
+          # @!method initialize(amount:, transfer_id:)
+          #   A Card Push Transfer Acceptance object. This field will be present in the JSON
+          #   response if and only if `category` is equal to `card_push_transfer_acceptance`.
+          #   A Card Push Transfer Acceptance is created when an Outbound Card Push Transfer
+          #   sent from Increase is accepted by the receiving bank.
+          #
+          #   @param amount [Integer] The transfer amount in USD cents.
+          #
+          #   @param transfer_id [String] The identifier of the Card Push Transfer that led to this Transaction.
+        end
+
         # @see Increase::Models::Transaction::Source#card_refund
         class CardRefund < Increase::Internal::Type::BaseModel
           # @!attribute id
@@ -4085,8 +4109,8 @@ module Increase
           # Swift Transfer Intention: details will be under the `swift_transfer_intention` object.
           SWIFT_TRANSFER_INTENTION = :swift_transfer_intention
 
-          # Outbound Card Push Transfer Acceptance: details will be under the `outbound_card_push_transfer_acceptance` object.
-          OUTBOUND_CARD_PUSH_TRANSFER_ACCEPTANCE = :outbound_card_push_transfer_acceptance
+          # Card Push Transfer Acceptance: details will be under the `card_push_transfer_acceptance` object.
+          CARD_PUSH_TRANSFER_ACCEPTANCE = :card_push_transfer_acceptance
 
           # The Transaction was made for an undocumented or deprecated reason.
           OTHER = :other
@@ -5649,32 +5673,6 @@ module Increase
           end
         end
 
-        # @see Increase::Models::Transaction::Source#outbound_card_push_transfer_acceptance
-        class OutboundCardPushTransferAcceptance < Increase::Internal::Type::BaseModel
-          # @!attribute amount
-          #   The transfer amount in USD cents.
-          #
-          #   @return [Integer]
-          required :amount, Integer
-
-          # @!attribute transfer_id
-          #   The identifier of the Outbound Card Push Transfer that led to this Transaction.
-          #
-          #   @return [String]
-          required :transfer_id, String
-
-          # @!method initialize(amount:, transfer_id:)
-          #   An Outbound Card Push Transfer Acceptance object. This field will be present in
-          #   the JSON response if and only if `category` is equal to
-          #   `outbound_card_push_transfer_acceptance`. An Outbound Card Push Transfer
-          #   Acceptance is created when an Outbound Card Push Transfer sent from Increase is
-          #   accepted by the receiving bank.
-          #
-          #   @param amount [Integer] The transfer amount in USD cents.
-          #
-          #   @param transfer_id [String] The identifier of the Outbound Card Push Transfer that led to this Transaction.
-        end
-
         # @see Increase::Models::Transaction::Source#real_time_payments_transfer_acknowledgement
         class RealTimePaymentsTransferAcknowledgement < Increase::Internal::Type::BaseModel
           # @!attribute amount

data/lib/increase/models/transaction_list_params.rb

@@ -169,8 +169,8 @@ module Increase
           # Swift Transfer Intention: details will be under the `swift_transfer_intention` object.
           SWIFT_TRANSFER_INTENTION = :swift_transfer_intention
 
-          # Outbound Card Push Transfer Acceptance: details will be under the `outbound_card_push_transfer_acceptance` object.
-          OUTBOUND_CARD_PUSH_TRANSFER_ACCEPTANCE = :outbound_card_push_transfer_acceptance
+          # Card Push Transfer Acceptance: details will be under the `card_push_transfer_acceptance` object.
+          CARD_PUSH_TRANSFER_ACCEPTANCE = :card_push_transfer_acceptance
 
           # The Transaction was made for an undocumented or deprecated reason.
           OTHER = :other

data/lib/increase/resources/documents.rb

@@ -5,12 +5,14 @@ module Increase
     class Documents
       # Create a Document
       #
-      # @overload create(category:, account_verification_letter: nil, request_options: {})
+      # @overload create(category:, account_verification_letter: nil, funding_instructions: nil, request_options: {})
       #
       # @param category [Symbol, Increase::Models::DocumentCreateParams::Category] The type of document to create.
       #
       # @param account_verification_letter [Increase::Models::DocumentCreateParams::AccountVerificationLetter] An account verification letter.
       #
+      # @param funding_instructions [Increase::Models::DocumentCreateParams::FundingInstructions] Funding instructions.
+      #
       # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Increase::Models::Document]

data/lib/increase/version.rb

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

data/rbi/increase/errors.rbi

@@ -8,6 +8,22 @@ module Increase
     end
 
     class ConversionError < Increase::Errors::Error
+      sig { returns(T.nilable(StandardError)) }
+      def cause
+      end
+
+      # @api private
+      sig do
+        params(
+          on: T::Class[StandardError],
+          method: Symbol,
+          target: T.anything,
+          value: T.anything,
+          cause: T.nilable(StandardError)
+        ).returns(T.attached_class)
+      end
+      def self.new(on:, method:, target:, value:, cause: nil)
+      end
     end
 
     class APIError < Increase::Errors::Error

data/rbi/increase/internal/type/boolean.rbi

@@ -22,6 +22,8 @@ module Increase
 
         class << self
           # @api private
+          #
+          # Coerce value to Boolean if possible, otherwise return the original value.
           sig do
             override
               .params(

data/rbi/increase/internal/type/converter.rbi

@@ -15,12 +15,14 @@ module Increase
         CoerceState =
           T.type_alias do
             {
-              strictness: T.any(T::Boolean, Symbol),
+              translate_names: T::Boolean,
+              strictness: T::Boolean,
               exactness: {
                 yes: Integer,
                 no: Integer,
                 maybe: Integer
               },
+              error: T::Class[StandardError],
               branched: Integer
             }
           end
@@ -88,6 +90,15 @@ module Increase
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(translate_names: T::Boolean).returns(
+              Increase::Internal::Type::Converter::CoerceState
+            )
+          end
+          def self.new_coerce_state(translate_names: true)
+          end
+
           # @api private
           #
           # Based on `target`, transform `value` into `target`, to the extent possible:
@@ -109,14 +120,11 @@ module Increase
           def self.coerce(
             target,
             value,
-            # The `strictness` is one of `true`, `false`, or `:strong`. This informs the
-            # coercion strategy when we have to decide between multiple possible conversion
-            # targets:
+            # The `strictness` is one of `true`, `false`. This informs the coercion strategy
+            # when we have to decide between multiple possible conversion targets:
             #
             # - `true`: the conversion must be exact, with minimum coercion.
             # - `false`: the conversion can be approximate, with some coercion.
-            # - `:strong`: the conversion must be exact, with no coercion, and raise an error
-            #   if not possible.
             #
             # The `exactness` is `Hash` with keys being one of `yes`, `no`, or `maybe`. For
             # any given conversion attempt, the exactness will be updated based on how closely
@@ -128,15 +136,7 @@ module Increase
             # - `no`: the value cannot be converted to the target type.
             #
             # See implementation below for more details.
-            state: {
-              strictness: true,
-              exactness: {
-                yes: 0,
-                no: 0,
-                maybe: 0
-              },
-              branched: 0
-            }
+            state: Increase::Internal::Type::Converter.new_coerce_state
           )
           end
 

data/rbi/increase/internal/type/union.rbi

@@ -78,6 +78,11 @@ module Increase
         end
 
         # @api private
+        #
+        # Tries to efficiently coerce the given value to one of the known variants.
+        #
+        # If the value cannot match any of the known variants, the coercion is considered
+        # non-viable and returns the original value.
         sig do
           override
             .params(

data/rbi/increase/internal/type/unknown.rbi

@@ -22,6 +22,8 @@ module Increase
 
         class << self
           # @api private
+          #
+          # No coercion needed for Unknown type.
           sig do
             override
               .params(

data/rbi/increase/models/card_payment.rbi

@@ -270,10 +270,10 @@ module Increase
         end
         attr_writer :card_settlement
 
-        # A Card Validation object. This field will be present in the JSON response if and
-        # only if `category` is equal to `card_validation`. Card Validations are requests
-        # from a merchant to verify that a card number and optionally its address and/or
-        # Card Verification Value are valid.
+        # An Inbound Card Validation object. This field will be present in the JSON
+        # response if and only if `category` is equal to `card_validation`. Inbound Card
+        # Validations are requests from a merchant to verify that a card number and
+        # optionally its address and/or Card Verification Value are valid.
         sig do
           returns(T.nilable(Increase::CardPayment::Element::CardValidation))
         end
@@ -380,10 +380,10 @@ module Increase
           # preceded by an authorization, an acquirer can also directly clear a transaction
           # without first authorizing it.
           card_settlement:,
-          # A Card Validation object. This field will be present in the JSON response if and
-          # only if `category` is equal to `card_validation`. Card Validations are requests
-          # from a merchant to verify that a card number and optionally its address and/or
-          # Card Verification Value are valid.
+          # An Inbound Card Validation object. This field will be present in the JSON
+          # response if and only if `category` is equal to `card_validation`. Inbound Card
+          # Validations are requests from a merchant to verify that a card number and
+          # optionally its address and/or Card Verification Value are valid.
           card_validation:,
           # The type of the resource. We may add additional possible values for this enum
           # over time; your application should be able to handle such additions gracefully.
@@ -10650,7 +10650,7 @@ module Increase
           attr_accessor :terminal_id
 
           # A constant representing the object's type. For this resource it will always be
-          # `card_validation`.
+          # `inbound_card_validation`.
           sig do
             returns(
               Increase::CardPayment::Element::CardValidation::Type::TaggedSymbol
@@ -10674,10 +10674,10 @@ module Increase
           end
           attr_writer :verification
 
-          # A Card Validation object. This field will be present in the JSON response if and
-          # only if `category` is equal to `card_validation`. Card Validations are requests
-          # from a merchant to verify that a card number and optionally its address and/or
-          # Card Verification Value are valid.
+          # An Inbound Card Validation object. This field will be present in the JSON
+          # response if and only if `category` is equal to `card_validation`. Inbound Card
+          # Validations are requests from a merchant to verify that a card number and
+          # optionally its address and/or Card Verification Value are valid.
           sig do
             params(
               id: String,
@@ -10756,7 +10756,7 @@ module Increase
             # is transacting with.
             terminal_id:,
             # A constant representing the object's type. For this resource it will always be
-            # `card_validation`.
+            # `inbound_card_validation`.
             type:,
             # Fields related to verification of cardholder-provided values.
             verification:
@@ -11422,7 +11422,7 @@ module Increase
           end
 
           # A constant representing the object's type. For this resource it will always be
-          # `card_validation`.
+          # `inbound_card_validation`.
           module Type
             extend Increase::Internal::Type::Enum
 
@@ -11435,9 +11435,9 @@ module Increase
               end
             OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-            CARD_VALIDATION =
+            INBOUND_CARD_VALIDATION =
               T.let(
-                :card_validation,
+                :inbound_card_validation,
                 Increase::CardPayment::Element::CardValidation::Type::TaggedSymbol
               )
 
@@ -11785,7 +11785,7 @@ module Increase
               Increase::CardPayment::Element::Category::TaggedSymbol
             )
 
-          # Card Validation: details will be under the `card_validation` object.
+          # Inbound Card Validation: details will be under the `card_validation` object.
           CARD_VALIDATION =
             T.let(
               :card_validation,