increase 1.90.0 → 1.91.0

data/lib/increase/models/transaction.rb

@@ -247,6 +247,14 @@ module Increase
         #   @return [Increase::Models::Transaction::Source::CardDisputeLoss, nil]
         required :card_dispute_loss, -> { Increase::Transaction::Source::CardDisputeLoss }, nil?: true
 
+        # @!attribute card_financial
+        #   A Card Financial object. This field will be present in the JSON response if and
+        #   only if `category` is equal to `card_financial`. Card Financials are temporary
+        #   holds placed on a customers funds with the intent to later clear a transaction.
+        #
+        #   @return [Increase::Models::Transaction::Source::CardFinancial, nil]
+        required :card_financial, -> { Increase::Transaction::Source::CardFinancial }, 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`.
@@ -530,7 +538,7 @@ module Increase
                  },
                  nil?: true
 
-        # @!method initialize(account_revenue_payment:, account_transfer_intention:, ach_transfer_intention:, ach_transfer_rejection:, ach_transfer_return:, card_dispute_acceptance:, card_dispute_financial:, 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:, fednow_transfer_acknowledgement:, fee_payment:, inbound_ach_transfer:, inbound_ach_transfer_return_intention:, inbound_check_adjustment:, inbound_check_deposit_return_intention:, inbound_fednow_transfer_confirmation:, inbound_real_time_payments_transfer_confirmation:, 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:, swift_transfer_return:, wire_transfer_intention:)
+        # @!method initialize(account_revenue_payment:, account_transfer_intention:, ach_transfer_intention:, ach_transfer_rejection:, ach_transfer_return:, card_dispute_acceptance:, card_dispute_financial:, card_dispute_loss:, card_financial:, card_push_transfer_acceptance:, card_refund:, card_revenue_payment:, card_settlement:, cashback_payment:, category:, check_deposit_acceptance:, check_deposit_return:, check_transfer_deposit:, fednow_transfer_acknowledgement:, fee_payment:, inbound_ach_transfer:, inbound_ach_transfer_return_intention:, inbound_check_adjustment:, inbound_check_deposit_return_intention:, inbound_fednow_transfer_confirmation:, inbound_real_time_payments_transfer_confirmation:, 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:, swift_transfer_return:, wire_transfer_intention:)
         #   Some parameter documentations has been truncated, see
         #   {Increase::Models::Transaction::Source} for more details.
         #
@@ -555,6 +563,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_financial [Increase::Models::Transaction::Source::CardFinancial, nil] A Card Financial object. This field will be present in the JSON response if and
+        #
         #   @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
@@ -1045,230 +1055,1340 @@ module Increase
             # Code R70. A rare return reason. The receiving bank had not approved this return.
             PERMISSIBLE_RETURN_ENTRY_NOT_ACCEPTED = :permissible_return_entry_not_accepted
 
-            # Code R32. A rare return reason. The receiving bank could not settle this transaction.
-            RDFI_NON_SETTLEMENT = :rdfi_non_settlement
+            # Code R32. A rare return reason. The receiving bank could not settle this transaction.
+            RDFI_NON_SETTLEMENT = :rdfi_non_settlement
+
+            # Code R30. A rare return reason. The receiving bank does not accept Check Truncation ACH transfers.
+            RDFI_PARTICIPANT_IN_CHECK_TRUNCATION_PROGRAM = :rdfi_participant_in_check_truncation_program
+
+            # Code R14. A rare return reason. The payee is deceased.
+            REPRESENTATIVE_PAYEE_DECEASED_OR_UNABLE_TO_CONTINUE_IN_THAT_CAPACITY =
+              :representative_payee_deceased_or_unable_to_continue_in_that_capacity
+
+            # Code R75. A rare return reason. The originating bank disputes that an earlier `duplicate_entry` return was actually a duplicate.
+            RETURN_NOT_A_DUPLICATE = :return_not_a_duplicate
+
+            # Code R62. A rare return reason. The originating financial institution made a mistake and this return corrects it.
+            RETURN_OF_ERRONEOUS_OR_REVERSING_DEBIT = :return_of_erroneous_or_reversing_debit
+
+            # Code R36. A rare return reason. Return of a malformed credit entry.
+            RETURN_OF_IMPROPER_CREDIT_ENTRY = :return_of_improper_credit_entry
+
+            # Code R35. A rare return reason. Return of a malformed debit entry.
+            RETURN_OF_IMPROPER_DEBIT_ENTRY = :return_of_improper_debit_entry
+
+            # Code R33. A rare return reason. Return of a Destroyed Check ("XKC") entry.
+            RETURN_OF_XCK_ENTRY = :return_of_xck_entry
+
+            # Code R37. A rare return reason. The source document related to this ACH, usually an ACH check conversion, was presented to the bank.
+            SOURCE_DOCUMENT_PRESENTED_FOR_PAYMENT = :source_document_presented_for_payment
+
+            # Code R50. A rare return reason. State law prevents the bank from accepting the Represented Check ("RCK") entry.
+            STATE_LAW_AFFECTING_RCK_ACCEPTANCE = :state_law_affecting_rck_acceptance
+
+            # Code R52. A rare return reason. A stop payment was issued on a Represented Check ("RCK") entry.
+            STOP_PAYMENT_ON_ITEM_RELATED_TO_RCK_ENTRY = :stop_payment_on_item_related_to_rck_entry
+
+            # Code R38. A rare return reason. The source attached to the ACH, usually an ACH check conversion, includes a stop payment.
+            STOP_PAYMENT_ON_SOURCE_DOCUMENT = :stop_payment_on_source_document
+
+            # Code R73. A rare return reason. The bank receiving an `untimely_return` believes it was on time.
+            TIMELY_ORIGINAL_RETURN = :timely_original_return
+
+            # Code R27. A rare return reason. An ACH return's trace number does not match an originated ACH.
+            TRACE_NUMBER_ERROR = :trace_number_error
+
+            # Code R72. A rare return reason. The dishonored return was sent too late.
+            UNTIMELY_DISHONORED_RETURN = :untimely_dishonored_return
+
+            # Code R68. A rare return reason. The return was sent too late.
+            UNTIMELY_RETURN = :untimely_return
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see Increase::Models::Transaction::Source#card_dispute_acceptance
+        class CardDisputeAcceptance < Increase::Internal::Type::BaseModel
+          # @!attribute accepted_at
+          #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+          #   the Card Dispute was accepted.
+          #
+          #   @return [Time]
+          required :accepted_at, Time
+
+          # @!attribute transaction_id
+          #   The identifier of the Transaction that was created to return the disputed funds
+          #   to your account.
+          #
+          #   @return [String]
+          required :transaction_id, String
+
+          # @!method initialize(accepted_at:, transaction_id:)
+          #   Some parameter documentations has been truncated, see
+          #   {Increase::Models::Transaction::Source::CardDisputeAcceptance} for more details.
+          #
+          #   A Card Dispute Acceptance object. This field will be present in the JSON
+          #   response if and only if `category` is equal to `card_dispute_acceptance`.
+          #   Contains the details of a successful Card Dispute.
+          #
+          #   @param accepted_at [Time] The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which th
+          #
+          #   @param transaction_id [String] The identifier of the Transaction that was created to return the disputed funds
+        end
+
+        # @see Increase::Models::Transaction::Source#card_dispute_financial
+        class CardDisputeFinancial < Increase::Internal::Type::BaseModel
+          # @!attribute amount
+          #   The amount of the financial event.
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute network
+          #   The network that the Card Dispute is associated with.
+          #
+          #   @return [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Network]
+          required :network, enum: -> { Increase::Transaction::Source::CardDisputeFinancial::Network }
+
+          # @!attribute transaction_id
+          #   The identifier of the Transaction that was created to credit or debit the
+          #   disputed funds to or from your account.
+          #
+          #   @return [String]
+          required :transaction_id, String
+
+          # @!attribute visa
+          #   Information for events related to card dispute for card payments processed over
+          #   Visa's network. This field will be present in the JSON response if and only if
+          #   `network` is equal to `visa`.
+          #
+          #   @return [Increase::Models::Transaction::Source::CardDisputeFinancial::Visa, nil]
+          required :visa, -> { Increase::Transaction::Source::CardDisputeFinancial::Visa }, nil?: true
+
+          # @!method initialize(amount:, network:, transaction_id:, visa:)
+          #   Some parameter documentations has been truncated, see
+          #   {Increase::Models::Transaction::Source::CardDisputeFinancial} for more details.
+          #
+          #   A Card Dispute Financial object. This field will be present in the JSON response
+          #   if and only if `category` is equal to `card_dispute_financial`. Financial event
+          #   related to a Card Dispute.
+          #
+          #   @param amount [Integer] The amount of the financial event.
+          #
+          #   @param network [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Network] The network that the Card Dispute is associated with.
+          #
+          #   @param transaction_id [String] The identifier of the Transaction that was created to credit or debit the disput
+          #
+          #   @param visa [Increase::Models::Transaction::Source::CardDisputeFinancial::Visa, nil] Information for events related to card dispute for card payments processed over
+
+          # The network that the Card Dispute is associated with.
+          #
+          # @see Increase::Models::Transaction::Source::CardDisputeFinancial#network
+          module Network
+            extend Increase::Internal::Type::Enum
+
+            # Visa: details will be under the `visa` object.
+            VISA = :visa
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Increase::Models::Transaction::Source::CardDisputeFinancial#visa
+          class Visa < Increase::Internal::Type::BaseModel
+            # @!attribute event_type
+            #   The type of card dispute financial event.
+            #
+            #   @return [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Visa::EventType]
+            required :event_type, enum: -> { Increase::Transaction::Source::CardDisputeFinancial::Visa::EventType }
+
+            # @!method initialize(event_type:)
+            #   Information for events related to card dispute for card payments processed over
+            #   Visa's network. This field will be present in the JSON response if and only if
+            #   `network` is equal to `visa`.
+            #
+            #   @param event_type [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Visa::EventType] The type of card dispute financial event.
+
+            # The type of card dispute financial event.
+            #
+            # @see Increase::Models::Transaction::Source::CardDisputeFinancial::Visa#event_type
+            module EventType
+              extend Increase::Internal::Type::Enum
+
+              # The user's chargeback was submitted.
+              CHARGEBACK_SUBMITTED = :chargeback_submitted
+
+              # The user declined the merchant's pre-arbitration submission.
+              MERCHANT_PREARBITRATION_DECLINE_SUBMITTED = :merchant_prearbitration_decline_submitted
+
+              # The merchant's pre-arbitration submission was received.
+              MERCHANT_PREARBITRATION_RECEIVED = :merchant_prearbitration_received
+
+              # The transaction was re-presented by the merchant.
+              REPRESENTED = :represented
+
+              # The user's pre-arbitration was declined by the merchant.
+              USER_PREARBITRATION_DECLINE_RECEIVED = :user_prearbitration_decline_received
+
+              # The user's pre-arbitration was submitted.
+              USER_PREARBITRATION_SUBMITTED = :user_prearbitration_submitted
+
+              # The user withdrew from the dispute.
+              USER_WITHDRAWAL_SUBMITTED = :user_withdrawal_submitted
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+
+        # @see Increase::Models::Transaction::Source#card_dispute_loss
+        class CardDisputeLoss < Increase::Internal::Type::BaseModel
+          # @!attribute explanation
+          #   Why the Card Dispute was lost.
+          #
+          #   @return [String]
+          required :explanation, String
+
+          # @!attribute lost_at
+          #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+          #   the Card Dispute was lost.
+          #
+          #   @return [Time]
+          required :lost_at, Time
+
+          # @!attribute transaction_id
+          #   The identifier of the Transaction that was created to debit the disputed funds
+          #   from your account.
+          #
+          #   @return [String]
+          required :transaction_id, String
+
+          # @!method initialize(explanation:, lost_at:, transaction_id:)
+          #   Some parameter documentations has been truncated, see
+          #   {Increase::Models::Transaction::Source::CardDisputeLoss} for more details.
+          #
+          #   A Card Dispute Loss object. This field will be present in the JSON response if
+          #   and only if `category` is equal to `card_dispute_loss`. Contains the details of
+          #   a lost Card Dispute.
+          #
+          #   @param explanation [String] Why the Card Dispute was lost.
+          #
+          #   @param lost_at [Time] The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which th
+          #
+          #   @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_financial
+        class CardFinancial < Increase::Internal::Type::BaseModel
+          # @!attribute id
+          #   The Card Financial identifier.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute actioner
+          #   Whether this financial was approved by Increase, the card network through
+          #   stand-in processing, or the user through a real-time decision.
+          #
+          #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::Actioner]
+          required :actioner, enum: -> { Increase::Transaction::Source::CardFinancial::Actioner }
+
+          # @!attribute additional_amounts
+          #   Additional amounts associated with the card authorization, such as ATM
+          #   surcharges fees. These are usually a subset of the `amount` field and are used
+          #   to provide more detailed information about the transaction.
+          #
+          #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts]
+          required :additional_amounts, -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts }
+
+          # @!attribute amount
+          #   The pending amount in the minor unit of the transaction's currency. For dollars,
+          #   for example, this is cents.
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute card_payment_id
+          #   The ID of the Card Payment this transaction belongs to.
+          #
+          #   @return [String]
+          required :card_payment_id, String
+
+          # @!attribute currency
+          #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+          #   transaction's currency.
+          #
+          #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::Currency]
+          required :currency, enum: -> { Increase::Transaction::Source::CardFinancial::Currency }
+
+          # @!attribute digital_wallet_token_id
+          #   If the authorization was made via a Digital Wallet Token (such as an Apple Pay
+          #   purchase), the identifier of the token that was used.
+          #
+          #   @return [String, nil]
+          required :digital_wallet_token_id, String, nil?: true
+
+          # @!attribute direction
+          #   The direction describes the direction the funds will move, either from the
+          #   cardholder to the merchant or from the merchant to the cardholder.
+          #
+          #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::Direction]
+          required :direction, enum: -> { Increase::Transaction::Source::CardFinancial::Direction }
+
+          # @!attribute merchant_acceptor_id
+          #   The merchant identifier (commonly abbreviated as MID) of the merchant the card
+          #   is transacting with.
+          #
+          #   @return [String]
+          required :merchant_acceptor_id, String
+
+          # @!attribute merchant_category_code
+          #   The Merchant Category Code (commonly abbreviated as MCC) of the merchant the
+          #   card is transacting with.
+          #
+          #   @return [String]
+          required :merchant_category_code, String
+
+          # @!attribute merchant_city
+          #   The city the merchant resides in.
+          #
+          #   @return [String, nil]
+          required :merchant_city, String, nil?: true
+
+          # @!attribute merchant_country
+          #   The country the merchant resides in.
+          #
+          #   @return [String]
+          required :merchant_country, String
+
+          # @!attribute merchant_descriptor
+          #   The merchant descriptor of the merchant the card is transacting with.
+          #
+          #   @return [String]
+          required :merchant_descriptor, String
+
+          # @!attribute merchant_postal_code
+          #   The merchant's postal code. For US merchants this is either a 5-digit or 9-digit
+          #   ZIP code, where the first 5 and last 4 are separated by a dash.
+          #
+          #   @return [String, nil]
+          required :merchant_postal_code, String, nil?: true
+
+          # @!attribute merchant_state
+          #   The state the merchant resides in.
+          #
+          #   @return [String, nil]
+          required :merchant_state, String, nil?: true
+
+          # @!attribute network_details
+          #   Fields specific to the `network`.
+          #
+          #   @return [Increase::Models::Transaction::Source::CardFinancial::NetworkDetails]
+          required :network_details, -> { Increase::Transaction::Source::CardFinancial::NetworkDetails }
+
+          # @!attribute network_identifiers
+          #   Network-specific identifiers for a specific request or transaction.
+          #
+          #   @return [Increase::Models::Transaction::Source::CardFinancial::NetworkIdentifiers]
+          required :network_identifiers, -> { Increase::Transaction::Source::CardFinancial::NetworkIdentifiers }
+
+          # @!attribute network_risk_score
+          #   The risk score generated by the card network. For Visa this is the Visa Advanced
+          #   Authorization risk score, from 0 to 99, where 99 is the riskiest.
+          #
+          #   @return [Integer, nil]
+          required :network_risk_score, Integer, nil?: true
+
+          # @!attribute physical_card_id
+          #   If the authorization was made in-person with a physical card, the Physical Card
+          #   that was used.
+          #
+          #   @return [String, nil]
+          required :physical_card_id, String, nil?: true
+
+          # @!attribute presentment_amount
+          #   The pending amount in the minor unit of the transaction's presentment currency.
+          #
+          #   @return [Integer]
+          required :presentment_amount, Integer
+
+          # @!attribute presentment_currency
+          #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+          #   transaction's presentment currency.
+          #
+          #   @return [String]
+          required :presentment_currency, String
+
+          # @!attribute processing_category
+          #   The processing category describes the intent behind the financial, such as
+          #   whether it was used for bill payments or an automatic fuel dispenser.
+          #
+          #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::ProcessingCategory]
+          required :processing_category,
+                   enum: -> { Increase::Transaction::Source::CardFinancial::ProcessingCategory }
+
+          # @!attribute real_time_decision_id
+          #   The identifier of the Real-Time Decision sent to approve or decline this
+          #   transaction.
+          #
+          #   @return [String, nil]
+          required :real_time_decision_id, String, nil?: true
+
+          # @!attribute terminal_id
+          #   The terminal identifier (commonly abbreviated as TID) of the terminal the card
+          #   is transacting with.
+          #
+          #   @return [String, nil]
+          required :terminal_id, String, nil?: true
+
+          # @!attribute transaction_id
+          #   The identifier of the Transaction associated with this Transaction.
+          #
+          #   @return [String]
+          required :transaction_id, String
+
+          # @!attribute type
+          #   A constant representing the object's type. For this resource it will always be
+          #   `card_financial`.
+          #
+          #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::Type]
+          required :type, enum: -> { Increase::Transaction::Source::CardFinancial::Type }
+
+          # @!attribute verification
+          #   Fields related to verification of cardholder-provided values.
+          #
+          #   @return [Increase::Models::Transaction::Source::CardFinancial::Verification]
+          required :verification, -> { Increase::Transaction::Source::CardFinancial::Verification }
+
+          # @!method initialize(id:, actioner:, additional_amounts:, amount:, card_payment_id:, currency:, digital_wallet_token_id:, direction:, merchant_acceptor_id:, merchant_category_code:, merchant_city:, merchant_country:, merchant_descriptor:, merchant_postal_code:, merchant_state:, network_details:, network_identifiers:, network_risk_score:, physical_card_id:, presentment_amount:, presentment_currency:, processing_category:, real_time_decision_id:, terminal_id:, transaction_id:, type:, verification:)
+          #   Some parameter documentations has been truncated, see
+          #   {Increase::Models::Transaction::Source::CardFinancial} for more details.
+          #
+          #   A Card Financial object. This field will be present in the JSON response if and
+          #   only if `category` is equal to `card_financial`. Card Financials are temporary
+          #   holds placed on a customers funds with the intent to later clear a transaction.
+          #
+          #   @param id [String] The Card Financial identifier.
+          #
+          #   @param actioner [Symbol, Increase::Models::Transaction::Source::CardFinancial::Actioner] Whether this financial was approved by Increase, the card network through stand-
+          #
+          #   @param additional_amounts [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts] Additional amounts associated with the card authorization, such as ATM surcharge
+          #
+          #   @param amount [Integer] The pending amount in the minor unit of the transaction's currency. For dollars,
+          #
+          #   @param card_payment_id [String] The ID of the Card Payment this transaction belongs to.
+          #
+          #   @param currency [Symbol, Increase::Models::Transaction::Source::CardFinancial::Currency] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction'
+          #
+          #   @param digital_wallet_token_id [String, nil] If the authorization was made via a Digital Wallet Token (such as an Apple Pay p
+          #
+          #   @param direction [Symbol, Increase::Models::Transaction::Source::CardFinancial::Direction] The direction describes the direction the funds will move, either from the cardh
+          #
+          #   @param merchant_acceptor_id [String] The merchant identifier (commonly abbreviated as MID) of the merchant the card i
+          #
+          #   @param merchant_category_code [String] The Merchant Category Code (commonly abbreviated as MCC) of the merchant the car
+          #
+          #   @param merchant_city [String, nil] The city the merchant resides in.
+          #
+          #   @param merchant_country [String] The country the merchant resides in.
+          #
+          #   @param merchant_descriptor [String] The merchant descriptor of the merchant the card is transacting with.
+          #
+          #   @param merchant_postal_code [String, nil] The merchant's postal code. For US merchants this is either a 5-digit or 9-digit
+          #
+          #   @param merchant_state [String, nil] The state the merchant resides in.
+          #
+          #   @param network_details [Increase::Models::Transaction::Source::CardFinancial::NetworkDetails] Fields specific to the `network`.
+          #
+          #   @param network_identifiers [Increase::Models::Transaction::Source::CardFinancial::NetworkIdentifiers] Network-specific identifiers for a specific request or transaction.
+          #
+          #   @param network_risk_score [Integer, nil] The risk score generated by the card network. For Visa this is the Visa Advanced
+          #
+          #   @param physical_card_id [String, nil] If the authorization was made in-person with a physical card, the Physical Card
+          #
+          #   @param presentment_amount [Integer] The pending amount in the minor unit of the transaction's presentment currency.
+          #
+          #   @param presentment_currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction'
+          #
+          #   @param processing_category [Symbol, Increase::Models::Transaction::Source::CardFinancial::ProcessingCategory] The processing category describes the intent behind the financial, such as wheth
+          #
+          #   @param real_time_decision_id [String, nil] The identifier of the Real-Time Decision sent to approve or decline this transac
+          #
+          #   @param terminal_id [String, nil] The terminal identifier (commonly abbreviated as TID) of the terminal the card i
+          #
+          #   @param transaction_id [String] The identifier of the Transaction associated with this Transaction.
+          #
+          #   @param type [Symbol, Increase::Models::Transaction::Source::CardFinancial::Type] A constant representing the object's type. For this resource it will always be `
+          #
+          #   @param verification [Increase::Models::Transaction::Source::CardFinancial::Verification] Fields related to verification of cardholder-provided values.
+
+          # Whether this financial was approved by Increase, the card network through
+          # stand-in processing, or the user through a real-time decision.
+          #
+          # @see Increase::Models::Transaction::Source::CardFinancial#actioner
+          module Actioner
+            extend Increase::Internal::Type::Enum
+
+            # This object was actioned by the user through a real-time decision.
+            USER = :user
+
+            # This object was actioned by Increase without user intervention.
+            INCREASE = :increase
+
+            # This object was actioned by the network, through stand-in processing.
+            NETWORK = :network
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Increase::Models::Transaction::Source::CardFinancial#additional_amounts
+          class AdditionalAmounts < Increase::Internal::Type::BaseModel
+            # @!attribute clinic
+            #   The part of this transaction amount that was for clinic-related services.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Clinic, nil]
+            required :clinic,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::Clinic },
+                     nil?: true
+
+            # @!attribute dental
+            #   The part of this transaction amount that was for dental-related services.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Dental, nil]
+            required :dental,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::Dental },
+                     nil?: true
+
+            # @!attribute prescription
+            #   The part of this transaction amount that was for healthcare prescriptions.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Prescription, nil]
+            required :prescription,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::Prescription },
+                     nil?: true
+
+            # @!attribute surcharge
+            #   The surcharge amount charged for this transaction by the merchant.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Surcharge, nil]
+            required :surcharge,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::Surcharge },
+                     nil?: true
+
+            # @!attribute total_cumulative
+            #   The total amount of a series of incremental authorizations, optionally provided.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::TotalCumulative, nil]
+            required :total_cumulative,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::TotalCumulative },
+                     nil?: true
+
+            # @!attribute total_healthcare
+            #   The total amount of healthcare-related additional amounts.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::TotalHealthcare, nil]
+            required :total_healthcare,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::TotalHealthcare },
+                     nil?: true
+
+            # @!attribute transit
+            #   The part of this transaction amount that was for transit-related services.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Transit, nil]
+            required :transit,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::Transit },
+                     nil?: true
+
+            # @!attribute unknown
+            #   An unknown additional amount.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Unknown, nil]
+            required :unknown,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::Unknown },
+                     nil?: true
+
+            # @!attribute vision
+            #   The part of this transaction amount that was for vision-related services.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Vision, nil]
+            required :vision,
+                     -> { Increase::Transaction::Source::CardFinancial::AdditionalAmounts::Vision },
+                     nil?: true
+
+            # @!method initialize(clinic:, dental:, prescription:, surcharge:, total_cumulative:, total_healthcare:, transit:, unknown:, vision:)
+            #   Some parameter documentations has been truncated, see
+            #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts} for
+            #   more details.
+            #
+            #   Additional amounts associated with the card authorization, such as ATM
+            #   surcharges fees. These are usually a subset of the `amount` field and are used
+            #   to provide more detailed information about the transaction.
+            #
+            #   @param clinic [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Clinic, nil] The part of this transaction amount that was for clinic-related services.
+            #
+            #   @param dental [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Dental, nil] The part of this transaction amount that was for dental-related services.
+            #
+            #   @param prescription [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Prescription, nil] The part of this transaction amount that was for healthcare prescriptions.
+            #
+            #   @param surcharge [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Surcharge, nil] The surcharge amount charged for this transaction by the merchant.
+            #
+            #   @param total_cumulative [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::TotalCumulative, nil] The total amount of a series of incremental authorizations, optionally provided.
+            #
+            #   @param total_healthcare [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::TotalHealthcare, nil] The total amount of healthcare-related additional amounts.
+            #
+            #   @param transit [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Transit, nil] The part of this transaction amount that was for transit-related services.
+            #
+            #   @param unknown [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Unknown, nil] An unknown additional amount.
+            #
+            #   @param vision [Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Vision, nil] The part of this transaction amount that was for vision-related services.
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#clinic
+            class Clinic < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Clinic}
+              #   for more details.
+              #
+              #   The part of this transaction amount that was for clinic-related services.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#dental
+            class Dental < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Dental}
+              #   for more details.
+              #
+              #   The part of this transaction amount that was for dental-related services.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#prescription
+            class Prescription < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Prescription}
+              #   for more details.
+              #
+              #   The part of this transaction amount that was for healthcare prescriptions.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#surcharge
+            class Surcharge < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Surcharge}
+              #   for more details.
+              #
+              #   The surcharge amount charged for this transaction by the merchant.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#total_cumulative
+            class TotalCumulative < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::TotalCumulative}
+              #   for more details.
+              #
+              #   The total amount of a series of incremental authorizations, optionally provided.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#total_healthcare
+            class TotalHealthcare < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::TotalHealthcare}
+              #   for more details.
+              #
+              #   The total amount of healthcare-related additional amounts.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#transit
+            class Transit < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Transit}
+              #   for more details.
+              #
+              #   The part of this transaction amount that was for transit-related services.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#unknown
+            class Unknown < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Unknown}
+              #   for more details.
+              #
+              #   An unknown additional amount.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts#vision
+            class Vision < Increase::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The amount in minor units of the `currency` field. The amount is positive if it
+              #   is added to the amount (such as an ATM surcharge fee) and negative if it is
+              #   subtracted from the amount (such as a discount).
+              #
+              #   @return [Integer]
+              required :amount, Integer
+
+              # @!attribute currency
+              #   The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+              #   amount's currency.
+              #
+              #   @return [String]
+              required :currency, String
+
+              # @!method initialize(amount:, currency:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::AdditionalAmounts::Vision}
+              #   for more details.
+              #
+              #   The part of this transaction amount that was for vision-related services.
+              #
+              #   @param amount [Integer] The amount in minor units of the `currency` field. The amount is positive if it
+              #
+              #   @param currency [String] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional a
+            end
+          end
+
+          # The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+          # transaction's currency.
+          #
+          # @see Increase::Models::Transaction::Source::CardFinancial#currency
+          module Currency
+            extend Increase::Internal::Type::Enum
+
+            # Canadian Dollar (CAD)
+            CAD = :CAD
+
+            # Swiss Franc (CHF)
+            CHF = :CHF
+
+            # Euro (EUR)
+            EUR = :EUR
+
+            # British Pound (GBP)
+            GBP = :GBP
+
+            # Japanese Yen (JPY)
+            JPY = :JPY
+
+            # US Dollar (USD)
+            USD = :USD
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The direction describes the direction the funds will move, either from the
+          # cardholder to the merchant or from the merchant to the cardholder.
+          #
+          # @see Increase::Models::Transaction::Source::CardFinancial#direction
+          module Direction
+            extend Increase::Internal::Type::Enum
+
+            # A regular card authorization where funds are debited from the cardholder.
+            SETTLEMENT = :settlement
+
+            # A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.
+            REFUND = :refund
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Increase::Models::Transaction::Source::CardFinancial#network_details
+          class NetworkDetails < Increase::Internal::Type::BaseModel
+            # @!attribute category
+            #   The payment network used to process this card authorization.
+            #
+            #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Category]
+            required :category, enum: -> { Increase::Transaction::Source::CardFinancial::NetworkDetails::Category }
+
+            # @!attribute visa
+            #   Fields specific to the `visa` network.
+            #
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa, nil]
+            required :visa,
+                     -> {
+                       Increase::Transaction::Source::CardFinancial::NetworkDetails::Visa
+                     },
+                     nil?: true
+
+            # @!method initialize(category:, visa:)
+            #   Fields specific to the `network`.
+            #
+            #   @param category [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Category] The payment network used to process this card authorization.
+            #
+            #   @param visa [Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa, nil] Fields specific to the `visa` network.
+
+            # The payment network used to process this card authorization.
+            #
+            # @see Increase::Models::Transaction::Source::CardFinancial::NetworkDetails#category
+            module Category
+              extend Increase::Internal::Type::Enum
+
+              # Visa
+              VISA = :visa
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # @see Increase::Models::Transaction::Source::CardFinancial::NetworkDetails#visa
+            class Visa < Increase::Internal::Type::BaseModel
+              # @!attribute electronic_commerce_indicator
+              #   For electronic commerce transactions, this identifies the level of security used
+              #   in obtaining the customer's payment credential. For mail or telephone order
+              #   transactions, identifies the type of mail or telephone order.
+              #
+              #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa::ElectronicCommerceIndicator, nil]
+              required :electronic_commerce_indicator,
+                       enum: -> {
+                         Increase::Transaction::Source::CardFinancial::NetworkDetails::Visa::ElectronicCommerceIndicator
+                       },
+                       nil?: true
+
+              # @!attribute point_of_service_entry_mode
+              #   The method used to enter the cardholder's primary account number and card
+              #   expiration date.
+              #
+              #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa::PointOfServiceEntryMode, nil]
+              required :point_of_service_entry_mode,
+                       enum: -> {
+                         Increase::Transaction::Source::CardFinancial::NetworkDetails::Visa::PointOfServiceEntryMode
+                       },
+                       nil?: true
+
+              # @!attribute stand_in_processing_reason
+              #   Only present when `actioner: network`. Describes why a card authorization was
+              #   approved or declined by Visa through stand-in processing.
+              #
+              #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa::StandInProcessingReason, nil]
+              required :stand_in_processing_reason,
+                       enum: -> {
+                         Increase::Transaction::Source::CardFinancial::NetworkDetails::Visa::StandInProcessingReason
+                       },
+                       nil?: true
+
+              # @!method initialize(electronic_commerce_indicator:, point_of_service_entry_mode:, stand_in_processing_reason:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa} for
+              #   more details.
+              #
+              #   Fields specific to the `visa` network.
+              #
+              #   @param electronic_commerce_indicator [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa::ElectronicCommerceIndicator, nil] For electronic commerce transactions, this identifies the level of security used
+              #
+              #   @param point_of_service_entry_mode [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa::PointOfServiceEntryMode, nil] The method used to enter the cardholder's primary account number and card expira
+              #
+              #   @param stand_in_processing_reason [Symbol, Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa::StandInProcessingReason, nil] Only present when `actioner: network`. Describes why a card authorization was ap
+
+              # For electronic commerce transactions, this identifies the level of security used
+              # in obtaining the customer's payment credential. For mail or telephone order
+              # transactions, identifies the type of mail or telephone order.
+              #
+              # @see Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa#electronic_commerce_indicator
+              module ElectronicCommerceIndicator
+                extend Increase::Internal::Type::Enum
+
+                # Single transaction of a mail/phone order: Use to indicate that the transaction is a mail/phone order purchase, not a recurring transaction or installment payment. For domestic transactions in the US region, this value may also indicate one bill payment transaction in the card-present or card-absent environments.
+                MAIL_PHONE_ORDER = :mail_phone_order
+
+                # Recurring transaction: Payment indicator used to indicate a recurring transaction that originates from an acquirer in the US region.
+                RECURRING = :recurring
+
+                # Installment payment: Payment indicator used to indicate one purchase of goods or services that is billed to the account in multiple charges over a period of time agreed upon by the cardholder and merchant from transactions that originate from an acquirer in the US region.
+                INSTALLMENT = :installment
+
+                # Unknown classification: other mail order: Use to indicate that the type of mail/telephone order is unknown.
+                UNKNOWN_MAIL_PHONE_ORDER = :unknown_mail_phone_order
+
+                # Secure electronic commerce transaction: Use to indicate that the electronic commerce transaction has been authenticated using e.g., 3-D Secure
+                SECURE_ELECTRONIC_COMMERCE = :secure_electronic_commerce
+
+                # Non-authenticated security transaction at a 3-D Secure-capable merchant, and merchant attempted to authenticate the cardholder using 3-D Secure: Use to identify an electronic commerce transaction where the merchant attempted to authenticate the cardholder using 3-D Secure, but was unable to complete the authentication because the issuer or cardholder does not participate in the 3-D Secure program.
+                NON_AUTHENTICATED_SECURITY_TRANSACTION_AT_3DS_CAPABLE_MERCHANT =
+                  :non_authenticated_security_transaction_at_3ds_capable_merchant
+
+                # Non-authenticated security transaction: Use to identify an electronic commerce transaction that uses data encryption for security however , cardholder authentication is not performed using 3-D Secure.
+                NON_AUTHENTICATED_SECURITY_TRANSACTION = :non_authenticated_security_transaction
+
+                # Non-secure transaction: Use to identify an electronic commerce transaction that has no data protection.
+                NON_SECURE_TRANSACTION = :non_secure_transaction
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              # The method used to enter the cardholder's primary account number and card
+              # expiration date.
+              #
+              # @see Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa#point_of_service_entry_mode
+              module PointOfServiceEntryMode
+                extend Increase::Internal::Type::Enum
+
+                # Unknown
+                UNKNOWN = :unknown
+
+                # Manual key entry
+                MANUAL = :manual
+
+                # Magnetic stripe read, without card verification value
+                MAGNETIC_STRIPE_NO_CVV = :magnetic_stripe_no_cvv
+
+                # Optical code
+                OPTICAL_CODE = :optical_code
+
+                # Contact chip card
+                INTEGRATED_CIRCUIT_CARD = :integrated_circuit_card
+
+                # Contactless read of chip card
+                CONTACTLESS = :contactless
+
+                # Transaction initiated using a credential that has previously been stored on file
+                CREDENTIAL_ON_FILE = :credential_on_file
+
+                # Magnetic stripe read
+                MAGNETIC_STRIPE = :magnetic_stripe
 
-            # Code R30. A rare return reason. The receiving bank does not accept Check Truncation ACH transfers.
-            RDFI_PARTICIPANT_IN_CHECK_TRUNCATION_PROGRAM = :rdfi_participant_in_check_truncation_program
+                # Contactless read of magnetic stripe data
+                CONTACTLESS_MAGNETIC_STRIPE = :contactless_magnetic_stripe
 
-            # Code R14. A rare return reason. The payee is deceased.
-            REPRESENTATIVE_PAYEE_DECEASED_OR_UNABLE_TO_CONTINUE_IN_THAT_CAPACITY =
-              :representative_payee_deceased_or_unable_to_continue_in_that_capacity
+                # Contact chip card, without card verification value
+                INTEGRATED_CIRCUIT_CARD_NO_CVV = :integrated_circuit_card_no_cvv
 
-            # Code R75. A rare return reason. The originating bank disputes that an earlier `duplicate_entry` return was actually a duplicate.
-            RETURN_NOT_A_DUPLICATE = :return_not_a_duplicate
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
 
-            # Code R62. A rare return reason. The originating financial institution made a mistake and this return corrects it.
-            RETURN_OF_ERRONEOUS_OR_REVERSING_DEBIT = :return_of_erroneous_or_reversing_debit
+              # Only present when `actioner: network`. Describes why a card authorization was
+              # approved or declined by Visa through stand-in processing.
+              #
+              # @see Increase::Models::Transaction::Source::CardFinancial::NetworkDetails::Visa#stand_in_processing_reason
+              module StandInProcessingReason
+                extend Increase::Internal::Type::Enum
 
-            # Code R36. A rare return reason. Return of a malformed credit entry.
-            RETURN_OF_IMPROPER_CREDIT_ENTRY = :return_of_improper_credit_entry
+                # Increase failed to process the authorization in a timely manner.
+                ISSUER_ERROR = :issuer_error
 
-            # Code R35. A rare return reason. Return of a malformed debit entry.
-            RETURN_OF_IMPROPER_DEBIT_ENTRY = :return_of_improper_debit_entry
+                # The physical card read had an invalid CVV, dCVV, or authorization request cryptogram.
+                INVALID_PHYSICAL_CARD = :invalid_physical_card
 
-            # Code R33. A rare return reason. Return of a Destroyed Check ("XKC") entry.
-            RETURN_OF_XCK_ENTRY = :return_of_xck_entry
+                # The 3DS cardholder authentication verification value was invalid.
+                INVALID_CARDHOLDER_AUTHENTICATION_VERIFICATION_VALUE =
+                  :invalid_cardholder_authentication_verification_value
 
-            # Code R37. A rare return reason. The source document related to this ACH, usually an ACH check conversion, was presented to the bank.
-            SOURCE_DOCUMENT_PRESENTED_FOR_PAYMENT = :source_document_presented_for_payment
+                # An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.
+                INTERNAL_VISA_ERROR = :internal_visa_error
 
-            # Code R50. A rare return reason. State law prevents the bank from accepting the Represented Check ("RCK") entry.
-            STATE_LAW_AFFECTING_RCK_ACCEPTANCE = :state_law_affecting_rck_acceptance
+                # The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.
+                MERCHANT_TRANSACTION_ADVISORY_SERVICE_AUTHENTICATION_REQUIRED =
+                  :merchant_transaction_advisory_service_authentication_required
 
-            # Code R52. A rare return reason. A stop payment was issued on a Represented Check ("RCK") entry.
-            STOP_PAYMENT_ON_ITEM_RELATED_TO_RCK_ENTRY = :stop_payment_on_item_related_to_rck_entry
+                # The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.
+                PAYMENT_FRAUD_DISRUPTION_ACQUIRER_BLOCK = :payment_fraud_disruption_acquirer_block
 
-            # Code R38. A rare return reason. The source attached to the ACH, usually an ACH check conversion, includes a stop payment.
-            STOP_PAYMENT_ON_SOURCE_DOCUMENT = :stop_payment_on_source_document
+                # An unspecific reason for stand-in processing.
+                OTHER = :other
 
-            # Code R73. A rare return reason. The bank receiving an `untimely_return` believes it was on time.
-            TIMELY_ORIGINAL_RETURN = :timely_original_return
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
 
-            # Code R27. A rare return reason. An ACH return's trace number does not match an originated ACH.
-            TRACE_NUMBER_ERROR = :trace_number_error
+          # @see Increase::Models::Transaction::Source::CardFinancial#network_identifiers
+          class NetworkIdentifiers < Increase::Internal::Type::BaseModel
+            # @!attribute retrieval_reference_number
+            #   A life-cycle identifier used across e.g., an authorization and a reversal.
+            #   Expected to be unique per acquirer within a window of time. For some card
+            #   networks the retrieval reference number includes the trace counter.
+            #
+            #   @return [String, nil]
+            required :retrieval_reference_number, String, nil?: true
 
-            # Code R72. A rare return reason. The dishonored return was sent too late.
-            UNTIMELY_DISHONORED_RETURN = :untimely_dishonored_return
+            # @!attribute trace_number
+            #   A counter used to verify an individual authorization. Expected to be unique per
+            #   acquirer within a window of time.
+            #
+            #   @return [String, nil]
+            required :trace_number, String, nil?: true
 
-            # Code R68. A rare return reason. The return was sent too late.
-            UNTIMELY_RETURN = :untimely_return
+            # @!attribute transaction_id
+            #   A globally unique transaction identifier provided by the card network, used
+            #   across multiple life-cycle requests.
+            #
+            #   @return [String, nil]
+            required :transaction_id, String, nil?: true
 
-            # @!method self.values
-            #   @return [Array<Symbol>]
+            # @!method initialize(retrieval_reference_number:, trace_number:, transaction_id:)
+            #   Some parameter documentations has been truncated, see
+            #   {Increase::Models::Transaction::Source::CardFinancial::NetworkIdentifiers} for
+            #   more details.
+            #
+            #   Network-specific identifiers for a specific request or transaction.
+            #
+            #   @param retrieval_reference_number [String, nil] A life-cycle identifier used across e.g., an authorization and a reversal. Expec
+            #
+            #   @param trace_number [String, nil] A counter used to verify an individual authorization. Expected to be unique per
+            #
+            #   @param transaction_id [String, nil] A globally unique transaction identifier provided by the card network, used acro
           end
-        end
 
-        # @see Increase::Models::Transaction::Source#card_dispute_acceptance
-        class CardDisputeAcceptance < Increase::Internal::Type::BaseModel
-          # @!attribute accepted_at
-          #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
-          #   the Card Dispute was accepted.
+          # The processing category describes the intent behind the financial, such as
+          # whether it was used for bill payments or an automatic fuel dispenser.
           #
-          #   @return [Time]
-          required :accepted_at, Time
+          # @see Increase::Models::Transaction::Source::CardFinancial#processing_category
+          module ProcessingCategory
+            extend Increase::Internal::Type::Enum
 
-          # @!attribute transaction_id
-          #   The identifier of the Transaction that was created to return the disputed funds
-          #   to your account.
-          #
-          #   @return [String]
-          required :transaction_id, String
+            # Account funding transactions are transactions used to e.g., fund an account or transfer funds between accounts.
+            ACCOUNT_FUNDING = :account_funding
 
-          # @!method initialize(accepted_at:, transaction_id:)
-          #   Some parameter documentations has been truncated, see
-          #   {Increase::Models::Transaction::Source::CardDisputeAcceptance} for more details.
-          #
-          #   A Card Dispute Acceptance object. This field will be present in the JSON
-          #   response if and only if `category` is equal to `card_dispute_acceptance`.
-          #   Contains the details of a successful Card Dispute.
-          #
-          #   @param accepted_at [Time] The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which th
-          #
-          #   @param transaction_id [String] The identifier of the Transaction that was created to return the disputed funds
-        end
+            # Automatic fuel dispenser authorizations occur when a card is used at a gas pump, prior to the actual transaction amount being known. They are followed by an advice message that updates the amount of the pending transaction.
+            AUTOMATIC_FUEL_DISPENSER = :automatic_fuel_dispenser
 
-        # @see Increase::Models::Transaction::Source#card_dispute_financial
-        class CardDisputeFinancial < Increase::Internal::Type::BaseModel
-          # @!attribute amount
-          #   The amount of the financial event.
-          #
-          #   @return [Integer]
-          required :amount, Integer
+            # A transaction used to pay a bill.
+            BILL_PAYMENT = :bill_payment
 
-          # @!attribute network
-          #   The network that the Card Dispute is associated with.
-          #
-          #   @return [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Network]
-          required :network, enum: -> { Increase::Transaction::Source::CardDisputeFinancial::Network }
+            # Original credit transactions are used to send money to a cardholder.
+            ORIGINAL_CREDIT = :original_credit
 
-          # @!attribute transaction_id
-          #   The identifier of the Transaction that was created to credit or debit the
-          #   disputed funds to or from your account.
-          #
-          #   @return [String]
-          required :transaction_id, String
+            # A regular purchase.
+            PURCHASE = :purchase
 
-          # @!attribute visa
-          #   Information for events related to card dispute for card payments processed over
-          #   Visa's network. This field will be present in the JSON response if and only if
-          #   `network` is equal to `visa`.
-          #
-          #   @return [Increase::Models::Transaction::Source::CardDisputeFinancial::Visa, nil]
-          required :visa, -> { Increase::Transaction::Source::CardDisputeFinancial::Visa }, nil?: true
+            # Quasi-cash transactions represent purchases of items which may be convertible to cash.
+            QUASI_CASH = :quasi_cash
 
-          # @!method initialize(amount:, network:, transaction_id:, visa:)
-          #   Some parameter documentations has been truncated, see
-          #   {Increase::Models::Transaction::Source::CardDisputeFinancial} for more details.
-          #
-          #   A Card Dispute Financial object. This field will be present in the JSON response
-          #   if and only if `category` is equal to `card_dispute_financial`. Financial event
-          #   related to a Card Dispute.
-          #
-          #   @param amount [Integer] The amount of the financial event.
-          #
-          #   @param network [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Network] The network that the Card Dispute is associated with.
-          #
-          #   @param transaction_id [String] The identifier of the Transaction that was created to credit or debit the disput
-          #
-          #   @param visa [Increase::Models::Transaction::Source::CardDisputeFinancial::Visa, nil] Information for events related to card dispute for card payments processed over
+            # A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.
+            REFUND = :refund
 
-          # The network that the Card Dispute is associated with.
+            # Cash disbursement transactions are used to withdraw cash from an ATM or a point of sale.
+            CASH_DISBURSEMENT = :cash_disbursement
+
+            # The processing category is unknown.
+            UNKNOWN = :unknown
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # A constant representing the object's type. For this resource it will always be
+          # `card_financial`.
           #
-          # @see Increase::Models::Transaction::Source::CardDisputeFinancial#network
-          module Network
+          # @see Increase::Models::Transaction::Source::CardFinancial#type
+          module Type
             extend Increase::Internal::Type::Enum
 
-            # Visa: details will be under the `visa` object.
-            VISA = :visa
+            CARD_FINANCIAL = :card_financial
 
             # @!method self.values
             #   @return [Array<Symbol>]
           end
 
-          # @see Increase::Models::Transaction::Source::CardDisputeFinancial#visa
-          class Visa < Increase::Internal::Type::BaseModel
-            # @!attribute event_type
-            #   The type of card dispute financial event.
+          # @see Increase::Models::Transaction::Source::CardFinancial#verification
+          class Verification < Increase::Internal::Type::BaseModel
+            # @!attribute card_verification_code
+            #   Fields related to verification of the Card Verification Code, a 3-digit code on
+            #   the back of the card.
             #
-            #   @return [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Visa::EventType]
-            required :event_type, enum: -> { Increase::Transaction::Source::CardDisputeFinancial::Visa::EventType }
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::Verification::CardVerificationCode]
+            required :card_verification_code,
+                     -> { Increase::Transaction::Source::CardFinancial::Verification::CardVerificationCode }
 
-            # @!method initialize(event_type:)
-            #   Information for events related to card dispute for card payments processed over
-            #   Visa's network. This field will be present in the JSON response if and only if
-            #   `network` is equal to `visa`.
+            # @!attribute cardholder_address
+            #   Cardholder address provided in the authorization request and the address on file
+            #   we verified it against.
             #
-            #   @param event_type [Symbol, Increase::Models::Transaction::Source::CardDisputeFinancial::Visa::EventType] The type of card dispute financial event.
+            #   @return [Increase::Models::Transaction::Source::CardFinancial::Verification::CardholderAddress]
+            required :cardholder_address,
+                     -> { Increase::Transaction::Source::CardFinancial::Verification::CardholderAddress }
 
-            # The type of card dispute financial event.
+            # @!method initialize(card_verification_code:, cardholder_address:)
+            #   Some parameter documentations has been truncated, see
+            #   {Increase::Models::Transaction::Source::CardFinancial::Verification} for more
+            #   details.
             #
-            # @see Increase::Models::Transaction::Source::CardDisputeFinancial::Visa#event_type
-            module EventType
-              extend Increase::Internal::Type::Enum
-
-              # The user's chargeback was submitted.
-              CHARGEBACK_SUBMITTED = :chargeback_submitted
+            #   Fields related to verification of cardholder-provided values.
+            #
+            #   @param card_verification_code [Increase::Models::Transaction::Source::CardFinancial::Verification::CardVerificationCode] Fields related to verification of the Card Verification Code, a 3-digit code on
+            #
+            #   @param cardholder_address [Increase::Models::Transaction::Source::CardFinancial::Verification::CardholderAddress] Cardholder address provided in the authorization request and the address on file
 
-              # The user declined the merchant's pre-arbitration submission.
-              MERCHANT_PREARBITRATION_DECLINE_SUBMITTED = :merchant_prearbitration_decline_submitted
+            # @see Increase::Models::Transaction::Source::CardFinancial::Verification#card_verification_code
+            class CardVerificationCode < Increase::Internal::Type::BaseModel
+              # @!attribute result
+              #   The result of verifying the Card Verification Code.
+              #
+              #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::Verification::CardVerificationCode::Result]
+              required :result,
+                       enum: -> { Increase::Transaction::Source::CardFinancial::Verification::CardVerificationCode::Result }
 
-              # The merchant's pre-arbitration submission was received.
-              MERCHANT_PREARBITRATION_RECEIVED = :merchant_prearbitration_received
+              # @!method initialize(result:)
+              #   Fields related to verification of the Card Verification Code, a 3-digit code on
+              #   the back of the card.
+              #
+              #   @param result [Symbol, Increase::Models::Transaction::Source::CardFinancial::Verification::CardVerificationCode::Result] The result of verifying the Card Verification Code.
 
-              # The transaction was re-presented by the merchant.
-              REPRESENTED = :represented
+              # The result of verifying the Card Verification Code.
+              #
+              # @see Increase::Models::Transaction::Source::CardFinancial::Verification::CardVerificationCode#result
+              module Result
+                extend Increase::Internal::Type::Enum
 
-              # The user's pre-arbitration was declined by the merchant.
-              USER_PREARBITRATION_DECLINE_RECEIVED = :user_prearbitration_decline_received
+                # No card verification code was provided in the authorization request.
+                NOT_CHECKED = :not_checked
 
-              # The user's pre-arbitration was submitted.
-              USER_PREARBITRATION_SUBMITTED = :user_prearbitration_submitted
+                # The card verification code matched the one on file.
+                MATCH = :match
 
-              # The user withdrew from the dispute.
-              USER_WITHDRAWAL_SUBMITTED = :user_withdrawal_submitted
+                # The card verification code did not match the one on file.
+                NO_MATCH = :no_match
 
-              # @!method self.values
-              #   @return [Array<Symbol>]
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
             end
-          end
-        end
 
-        # @see Increase::Models::Transaction::Source#card_dispute_loss
-        class CardDisputeLoss < Increase::Internal::Type::BaseModel
-          # @!attribute explanation
-          #   Why the Card Dispute was lost.
-          #
-          #   @return [String]
-          required :explanation, String
+            # @see Increase::Models::Transaction::Source::CardFinancial::Verification#cardholder_address
+            class CardholderAddress < Increase::Internal::Type::BaseModel
+              # @!attribute actual_line1
+              #   Line 1 of the address on file for the cardholder.
+              #
+              #   @return [String, nil]
+              required :actual_line1, String, nil?: true
 
-          # @!attribute lost_at
-          #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
-          #   the Card Dispute was lost.
-          #
-          #   @return [Time]
-          required :lost_at, Time
+              # @!attribute actual_postal_code
+              #   The postal code of the address on file for the cardholder.
+              #
+              #   @return [String, nil]
+              required :actual_postal_code, String, nil?: true
 
-          # @!attribute transaction_id
-          #   The identifier of the Transaction that was created to debit the disputed funds
-          #   from your account.
-          #
-          #   @return [String]
-          required :transaction_id, String
+              # @!attribute provided_line1
+              #   The cardholder address line 1 provided for verification in the authorization
+              #   request.
+              #
+              #   @return [String, nil]
+              required :provided_line1, String, nil?: true
 
-          # @!method initialize(explanation:, lost_at:, transaction_id:)
-          #   Some parameter documentations has been truncated, see
-          #   {Increase::Models::Transaction::Source::CardDisputeLoss} for more details.
-          #
-          #   A Card Dispute Loss object. This field will be present in the JSON response if
-          #   and only if `category` is equal to `card_dispute_loss`. Contains the details of
-          #   a lost Card Dispute.
-          #
-          #   @param explanation [String] Why the Card Dispute was lost.
-          #
-          #   @param lost_at [Time] The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which th
-          #
-          #   @param transaction_id [String] The identifier of the Transaction that was created to debit the disputed funds f
+              # @!attribute provided_postal_code
+              #   The postal code provided for verification in the authorization request.
+              #
+              #   @return [String, nil]
+              required :provided_postal_code, String, nil?: true
+
+              # @!attribute result
+              #   The address verification result returned to the card network.
+              #
+              #   @return [Symbol, Increase::Models::Transaction::Source::CardFinancial::Verification::CardholderAddress::Result]
+              required :result,
+                       enum: -> { Increase::Transaction::Source::CardFinancial::Verification::CardholderAddress::Result }
+
+              # @!method initialize(actual_line1:, actual_postal_code:, provided_line1:, provided_postal_code:, result:)
+              #   Some parameter documentations has been truncated, see
+              #   {Increase::Models::Transaction::Source::CardFinancial::Verification::CardholderAddress}
+              #   for more details.
+              #
+              #   Cardholder address provided in the authorization request and the address on file
+              #   we verified it against.
+              #
+              #   @param actual_line1 [String, nil] Line 1 of the address on file for the cardholder.
+              #
+              #   @param actual_postal_code [String, nil] The postal code of the address on file for the cardholder.
+              #
+              #   @param provided_line1 [String, nil] The cardholder address line 1 provided for verification in the authorization req
+              #
+              #   @param provided_postal_code [String, nil] The postal code provided for verification in the authorization request.
+              #
+              #   @param result [Symbol, Increase::Models::Transaction::Source::CardFinancial::Verification::CardholderAddress::Result] The address verification result returned to the card network.
+
+              # The address verification result returned to the card network.
+              #
+              # @see Increase::Models::Transaction::Source::CardFinancial::Verification::CardholderAddress#result
+              module Result
+                extend Increase::Internal::Type::Enum
+
+                # No address information was provided in the authorization request.
+                NOT_CHECKED = :not_checked
+
+                # Postal code matches, but the street address does not match or was not provided.
+                POSTAL_CODE_MATCH_ADDRESS_NO_MATCH = :postal_code_match_address_no_match
+
+                # Postal code does not match, but the street address matches or was not provided.
+                POSTAL_CODE_NO_MATCH_ADDRESS_MATCH = :postal_code_no_match_address_match
+
+                # Postal code and street address match.
+                MATCH = :match
+
+                # Postal code and street address do not match.
+                NO_MATCH = :no_match
+
+                # Postal code matches, but the street address was not verified. (deprecated)
+                POSTAL_CODE_MATCH_ADDRESS_NOT_CHECKED = :postal_code_match_address_not_checked
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
         end
 
         # @see Increase::Models::Transaction::Source#card_push_transfer_acceptance
@@ -4280,6 +5400,9 @@ module Increase
           # Card Settlement: details will be under the `card_settlement` object.
           CARD_SETTLEMENT = :card_settlement
 
+          # Card Financial: details will be under the `card_financial` object.
+          CARD_FINANCIAL = :card_financial
+
           # Card Revenue Payment: details will be under the `card_revenue_payment` object.
           CARD_REVENUE_PAYMENT = :card_revenue_payment