increase 1.294.0 → 1.295.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e5dcc8dd08f58f6ae9204e2e9ae0f36352ccb71f23e523aa620651c86b0c614
-  data.tar.gz: 0b15784ef624a7adef77a687db26ce2563786db6fffa42fe5e650e397d8a7864
+  metadata.gz: 567701574c02ba560bbb96a1e04827f022b68d0a7cf84e0872ea76c9af85dece
+  data.tar.gz: 0253d3e5d408b42a93191492eb0f3e489abb3a9477dc323fbcbcee5c5b4b33ba
 SHA512:
-  metadata.gz: 7b3196b5a27d4e21b7345cb9abebee720a1a1246d108a2f11ca9d9c2e7ec5c0d708f07e61769c6c63baae0769b68673469c47ca21e1d604d942ef77d4f916887
-  data.tar.gz: a405a85ed0c105a1f70d54ef1b1bd0cc72ff2d6f64a54dab294bc94c34ffe5eed4bd01ef7c220b4db1e38d54a42228a345e9952f0aa42b334fcb0f5284e30bd8
+  metadata.gz: 5a3ea4fa764355741a79cef56034c5d44e46fb39349aab6c9ef8b54bed59b7f22fd195ea0c7664f6723d80a4b0584886e682e4aa90f3fe2dcc38120b00d0de4c
+  data.tar.gz: ec2cad6647a883fa54596c4c7630d07c380d74a9fd075db0b8981934bc8156d406f10fc0cbde04a920898dc15d3f2f0771d98cf6a930317e9fcc2d96c710e247

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.295.0 (2026-04-13)
+
+Full Changelog: [v1.294.0...v1.295.0](https://github.com/Increase/increase-ruby/compare/v1.294.0...v1.295.0)
+
+### Features
+
+* **api:** api update ([b0eedbe](https://github.com/Increase/increase-ruby/commit/b0eedbe1db3daaf38c542071c9430e602def8045))
+
 ## 1.294.0 (2026-04-13)
 
 Full Changelog: [v1.293.0...v1.294.0](https://github.com/Increase/increase-ruby/compare/v1.293.0...v1.294.0)

data/README.md

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

data/lib/increase/models/simulations/card_purchase_supplement_create_params.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+module Increase
+  module Models
+    module Simulations
+      # @see Increase::Resources::Simulations::CardPurchaseSupplements#create
+      class CardPurchaseSupplementCreateParams < Increase::Internal::Type::BaseModel
+        extend Increase::Internal::Type::RequestParameters::Converter
+        include Increase::Internal::Type::RequestParameters
+
+        # @!attribute transaction_id
+        #   The identifier of the Transaction to create a Card Purchase Supplement for. The
+        #   Transaction must have a source of type `card_settlement`.
+        #
+        #   @return [String]
+        required :transaction_id, String
+
+        # @!attribute invoice
+        #   Invoice-level information about the payment.
+        #
+        #   @return [Increase::Models::Simulations::CardPurchaseSupplementCreateParams::Invoice, nil]
+        optional :invoice, -> { Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice }
+
+        # @!attribute line_items
+        #   Line item information, such as individual products purchased.
+        #
+        #   @return [Array<Increase::Models::Simulations::CardPurchaseSupplementCreateParams::LineItem>, nil]
+        optional :line_items,
+                 -> { Increase::Internal::Type::ArrayOf[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem] }
+
+        # @!method initialize(transaction_id:, invoice: nil, line_items: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Increase::Models::Simulations::CardPurchaseSupplementCreateParams} for more
+        #   details.
+        #
+        #   @param transaction_id [String] The identifier of the Transaction to create a Card Purchase Supplement for. The
+        #
+        #   @param invoice [Increase::Models::Simulations::CardPurchaseSupplementCreateParams::Invoice] Invoice-level information about the payment.
+        #
+        #   @param line_items [Array<Increase::Models::Simulations::CardPurchaseSupplementCreateParams::LineItem>] Line item information, such as individual products purchased.
+        #
+        #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
+
+        class Invoice < Increase::Internal::Type::BaseModel
+          # @!attribute discount_amount
+          #   Discount given to cardholder.
+          #
+          #   @return [Integer, nil]
+          optional :discount_amount, Integer
+
+          # @!attribute duty_tax_amount
+          #   Amount of duty taxes.
+          #
+          #   @return [Integer, nil]
+          optional :duty_tax_amount, Integer
+
+          # @!attribute order_date
+          #   Date the order was taken.
+          #
+          #   @return [Date, nil]
+          optional :order_date, Date
+
+          # @!attribute shipping_amount
+          #   The shipping cost.
+          #
+          #   @return [Integer, nil]
+          optional :shipping_amount, Integer
+
+          # @!attribute shipping_destination_country_code
+          #   Country code of the shipping destination.
+          #
+          #   @return [String, nil]
+          optional :shipping_destination_country_code, String
+
+          # @!attribute shipping_destination_postal_code
+          #   Postal code of the shipping destination.
+          #
+          #   @return [String, nil]
+          optional :shipping_destination_postal_code, String
+
+          # @!attribute shipping_source_postal_code
+          #   Postal code of the location being shipped from.
+          #
+          #   @return [String, nil]
+          optional :shipping_source_postal_code, String
+
+          # @!attribute shipping_tax_amount
+          #   Taxes paid for freight and shipping.
+          #
+          #   @return [Integer, nil]
+          optional :shipping_tax_amount, Integer
+
+          # @!attribute shipping_tax_rate
+          #   Tax rate for freight and shipping.
+          #
+          #   @return [String, nil]
+          optional :shipping_tax_rate, String
+
+          # @!attribute unique_value_added_tax_invoice_reference
+          #   Value added tax invoice reference number.
+          #
+          #   @return [String, nil]
+          optional :unique_value_added_tax_invoice_reference, String
+
+          # @!method initialize(discount_amount: nil, duty_tax_amount: nil, order_date: nil, shipping_amount: nil, shipping_destination_country_code: nil, shipping_destination_postal_code: nil, shipping_source_postal_code: nil, shipping_tax_amount: nil, shipping_tax_rate: nil, unique_value_added_tax_invoice_reference: nil)
+          #   Invoice-level information about the payment.
+          #
+          #   @param discount_amount [Integer] Discount given to cardholder.
+          #
+          #   @param duty_tax_amount [Integer] Amount of duty taxes.
+          #
+          #   @param order_date [Date] Date the order was taken.
+          #
+          #   @param shipping_amount [Integer] The shipping cost.
+          #
+          #   @param shipping_destination_country_code [String] Country code of the shipping destination.
+          #
+          #   @param shipping_destination_postal_code [String] Postal code of the shipping destination.
+          #
+          #   @param shipping_source_postal_code [String] Postal code of the location being shipped from.
+          #
+          #   @param shipping_tax_amount [Integer] Taxes paid for freight and shipping.
+          #
+          #   @param shipping_tax_rate [String] Tax rate for freight and shipping.
+          #
+          #   @param unique_value_added_tax_invoice_reference [String] Value added tax invoice reference number.
+        end
+
+        class LineItem < Increase::Internal::Type::BaseModel
+          # @!attribute discount_amount
+          #   Discount amount for this specific line item.
+          #
+          #   @return [Integer, nil]
+          optional :discount_amount, Integer
+
+          # @!attribute item_commodity_code
+          #   Code used to categorize the purchase item.
+          #
+          #   @return [String, nil]
+          optional :item_commodity_code, String
+
+          # @!attribute item_descriptor
+          #   Description of the purchase item.
+          #
+          #   @return [String, nil]
+          optional :item_descriptor, String
+
+          # @!attribute item_quantity
+          #   The number of units of the product being purchased.
+          #
+          #   @return [String, nil]
+          optional :item_quantity, String
+
+          # @!attribute product_code
+          #   Code used to categorize the product being purchased.
+          #
+          #   @return [String, nil]
+          optional :product_code, String
+
+          # @!attribute sales_tax_amount
+          #   Sales tax amount for this line item.
+          #
+          #   @return [Integer, nil]
+          optional :sales_tax_amount, Integer
+
+          # @!attribute sales_tax_rate
+          #   Sales tax rate for this line item.
+          #
+          #   @return [String, nil]
+          optional :sales_tax_rate, String
+
+          # @!attribute total_amount
+          #   Total amount of all line items.
+          #
+          #   @return [Integer, nil]
+          optional :total_amount, Integer
+
+          # @!attribute unit_cost
+          #   Cost of line item per unit of measure, in major units.
+          #
+          #   @return [String, nil]
+          optional :unit_cost, String
+
+          # @!attribute unit_of_measure_code
+          #   Code indicating unit of measure (gallons, etc.).
+          #
+          #   @return [String, nil]
+          optional :unit_of_measure_code, String
+
+          # @!method initialize(discount_amount: nil, item_commodity_code: nil, item_descriptor: nil, item_quantity: nil, product_code: nil, sales_tax_amount: nil, sales_tax_rate: nil, total_amount: nil, unit_cost: nil, unit_of_measure_code: nil)
+          #   @param discount_amount [Integer] Discount amount for this specific line item.
+          #
+          #   @param item_commodity_code [String] Code used to categorize the purchase item.
+          #
+          #   @param item_descriptor [String] Description of the purchase item.
+          #
+          #   @param item_quantity [String] The number of units of the product being purchased.
+          #
+          #   @param product_code [String] Code used to categorize the product being purchased.
+          #
+          #   @param sales_tax_amount [Integer] Sales tax amount for this line item.
+          #
+          #   @param sales_tax_rate [String] Sales tax rate for this line item.
+          #
+          #   @param total_amount [Integer] Total amount of all line items.
+          #
+          #   @param unit_cost [String] Cost of line item per unit of measure, in major units.
+          #
+          #   @param unit_of_measure_code [String] Code indicating unit of measure (gallons, etc.).
+        end
+      end
+    end
+  end
+end

data/lib/increase/resources/simulations/card_purchase_supplements.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Increase
+  module Resources
+    class Simulations
+      class CardPurchaseSupplements
+        # Some parameter documentations has been truncated, see
+        # {Increase::Models::Simulations::CardPurchaseSupplementCreateParams} for more
+        # details.
+        #
+        # Simulates the creation of a Card Purchase Supplement (Level 3 data) for a card
+        # settlement. This happens asynchronously in production when Visa sends enhanced
+        # transaction data about a purchase.
+        #
+        # @overload create(transaction_id:, invoice: nil, line_items: nil, request_options: {})
+        #
+        # @param transaction_id [String] The identifier of the Transaction to create a Card Purchase Supplement for. The
+        #
+        # @param invoice [Increase::Models::Simulations::CardPurchaseSupplementCreateParams::Invoice] Invoice-level information about the payment.
+        #
+        # @param line_items [Array<Increase::Models::Simulations::CardPurchaseSupplementCreateParams::LineItem>] Line item information, such as individual products purchased.
+        #
+        # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Increase::Models::CardPurchaseSupplement]
+        #
+        # @see Increase::Models::Simulations::CardPurchaseSupplementCreateParams
+        def create(params)
+          parsed, options = Increase::Simulations::CardPurchaseSupplementCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "simulations/card_purchase_supplements",
+            body: parsed,
+            model: Increase::CardPurchaseSupplement,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Increase::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/increase/resources/simulations.rb

@@ -33,6 +33,9 @@ module Increase
       # @return [Increase::Resources::Simulations::CardAuthentications]
       attr_reader :card_authentications
 
+      # @return [Increase::Resources::Simulations::CardPurchaseSupplements]
+      attr_reader :card_purchase_supplements
+
       # @return [Increase::Resources::Simulations::CardDisputes]
       attr_reader :card_disputes
 
@@ -115,6 +118,8 @@ module Increase
         @card_fuel_confirmations = Increase::Resources::Simulations::CardFuelConfirmations.new(client: client)
         @card_refunds = Increase::Resources::Simulations::CardRefunds.new(client: client)
         @card_authentications = Increase::Resources::Simulations::CardAuthentications.new(client: client)
+        @card_purchase_supplements =
+          Increase::Resources::Simulations::CardPurchaseSupplements.new(client: client)
         @card_disputes = Increase::Resources::Simulations::CardDisputes.new(client: client)
         @physical_cards = Increase::Resources::Simulations::PhysicalCards.new(client: client)
         @digital_wallet_token_requests =

data/lib/increase/version.rb

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

data/lib/increase.rb

@@ -308,6 +308,7 @@ require_relative "increase/models/simulations/card_balance_inquiry_create_params
 require_relative "increase/models/simulations/card_dispute_action_params"
 require_relative "increase/models/simulations/card_fuel_confirmation_create_params"
 require_relative "increase/models/simulations/card_increment_create_params"
+require_relative "increase/models/simulations/card_purchase_supplement_create_params"
 require_relative "increase/models/simulations/card_refund_create_params"
 require_relative "increase/models/simulations/card_reversal_create_params"
 require_relative "increase/models/simulations/card_settlement_create_params"
@@ -425,6 +426,7 @@ require_relative "increase/resources/simulations/card_balance_inquiries"
 require_relative "increase/resources/simulations/card_disputes"
 require_relative "increase/resources/simulations/card_fuel_confirmations"
 require_relative "increase/resources/simulations/card_increments"
+require_relative "increase/resources/simulations/card_purchase_supplements"
 require_relative "increase/resources/simulations/card_refunds"
 require_relative "increase/resources/simulations/card_reversals"
 require_relative "increase/resources/simulations/card_settlements"

data/rbi/increase/models/simulations/card_purchase_supplement_create_params.rbi

@@ -0,0 +1,381 @@
+# typed: strong
+
+module Increase
+  module Models
+    module Simulations
+      class CardPurchaseSupplementCreateParams < Increase::Internal::Type::BaseModel
+        extend Increase::Internal::Type::RequestParameters::Converter
+        include Increase::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Increase::Simulations::CardPurchaseSupplementCreateParams,
+              Increase::Internal::AnyHash
+            )
+          end
+
+        # The identifier of the Transaction to create a Card Purchase Supplement for. The
+        # Transaction must have a source of type `card_settlement`.
+        sig { returns(String) }
+        attr_accessor :transaction_id
+
+        # Invoice-level information about the payment.
+        sig do
+          returns(
+            T.nilable(
+              Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice
+            )
+          )
+        end
+        attr_reader :invoice
+
+        sig do
+          params(
+            invoice:
+              Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice::OrHash
+          ).void
+        end
+        attr_writer :invoice
+
+        # Line item information, such as individual products purchased.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem
+              ]
+            )
+          )
+        end
+        attr_reader :line_items
+
+        sig do
+          params(
+            line_items:
+              T::Array[
+                Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem::OrHash
+              ]
+          ).void
+        end
+        attr_writer :line_items
+
+        sig do
+          params(
+            transaction_id: String,
+            invoice:
+              Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice::OrHash,
+            line_items:
+              T::Array[
+                Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem::OrHash
+              ],
+            request_options: Increase::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The identifier of the Transaction to create a Card Purchase Supplement for. The
+          # Transaction must have a source of type `card_settlement`.
+          transaction_id:,
+          # Invoice-level information about the payment.
+          invoice: nil,
+          # Line item information, such as individual products purchased.
+          line_items: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              transaction_id: String,
+              invoice:
+                Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice,
+              line_items:
+                T::Array[
+                  Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem
+                ],
+              request_options: Increase::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Invoice < Increase::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice,
+                Increase::Internal::AnyHash
+              )
+            end
+
+          # Discount given to cardholder.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :discount_amount
+
+          sig { params(discount_amount: Integer).void }
+          attr_writer :discount_amount
+
+          # Amount of duty taxes.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :duty_tax_amount
+
+          sig { params(duty_tax_amount: Integer).void }
+          attr_writer :duty_tax_amount
+
+          # Date the order was taken.
+          sig { returns(T.nilable(Date)) }
+          attr_reader :order_date
+
+          sig { params(order_date: Date).void }
+          attr_writer :order_date
+
+          # The shipping cost.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :shipping_amount
+
+          sig { params(shipping_amount: Integer).void }
+          attr_writer :shipping_amount
+
+          # Country code of the shipping destination.
+          sig { returns(T.nilable(String)) }
+          attr_reader :shipping_destination_country_code
+
+          sig { params(shipping_destination_country_code: String).void }
+          attr_writer :shipping_destination_country_code
+
+          # Postal code of the shipping destination.
+          sig { returns(T.nilable(String)) }
+          attr_reader :shipping_destination_postal_code
+
+          sig { params(shipping_destination_postal_code: String).void }
+          attr_writer :shipping_destination_postal_code
+
+          # Postal code of the location being shipped from.
+          sig { returns(T.nilable(String)) }
+          attr_reader :shipping_source_postal_code
+
+          sig { params(shipping_source_postal_code: String).void }
+          attr_writer :shipping_source_postal_code
+
+          # Taxes paid for freight and shipping.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :shipping_tax_amount
+
+          sig { params(shipping_tax_amount: Integer).void }
+          attr_writer :shipping_tax_amount
+
+          # Tax rate for freight and shipping.
+          sig { returns(T.nilable(String)) }
+          attr_reader :shipping_tax_rate
+
+          sig { params(shipping_tax_rate: String).void }
+          attr_writer :shipping_tax_rate
+
+          # Value added tax invoice reference number.
+          sig { returns(T.nilable(String)) }
+          attr_reader :unique_value_added_tax_invoice_reference
+
+          sig { params(unique_value_added_tax_invoice_reference: String).void }
+          attr_writer :unique_value_added_tax_invoice_reference
+
+          # Invoice-level information about the payment.
+          sig do
+            params(
+              discount_amount: Integer,
+              duty_tax_amount: Integer,
+              order_date: Date,
+              shipping_amount: Integer,
+              shipping_destination_country_code: String,
+              shipping_destination_postal_code: String,
+              shipping_source_postal_code: String,
+              shipping_tax_amount: Integer,
+              shipping_tax_rate: String,
+              unique_value_added_tax_invoice_reference: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Discount given to cardholder.
+            discount_amount: nil,
+            # Amount of duty taxes.
+            duty_tax_amount: nil,
+            # Date the order was taken.
+            order_date: nil,
+            # The shipping cost.
+            shipping_amount: nil,
+            # Country code of the shipping destination.
+            shipping_destination_country_code: nil,
+            # Postal code of the shipping destination.
+            shipping_destination_postal_code: nil,
+            # Postal code of the location being shipped from.
+            shipping_source_postal_code: nil,
+            # Taxes paid for freight and shipping.
+            shipping_tax_amount: nil,
+            # Tax rate for freight and shipping.
+            shipping_tax_rate: nil,
+            # Value added tax invoice reference number.
+            unique_value_added_tax_invoice_reference: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                discount_amount: Integer,
+                duty_tax_amount: Integer,
+                order_date: Date,
+                shipping_amount: Integer,
+                shipping_destination_country_code: String,
+                shipping_destination_postal_code: String,
+                shipping_source_postal_code: String,
+                shipping_tax_amount: Integer,
+                shipping_tax_rate: String,
+                unique_value_added_tax_invoice_reference: String
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class LineItem < Increase::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem,
+                Increase::Internal::AnyHash
+              )
+            end
+
+          # Discount amount for this specific line item.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :discount_amount
+
+          sig { params(discount_amount: Integer).void }
+          attr_writer :discount_amount
+
+          # Code used to categorize the purchase item.
+          sig { returns(T.nilable(String)) }
+          attr_reader :item_commodity_code
+
+          sig { params(item_commodity_code: String).void }
+          attr_writer :item_commodity_code
+
+          # Description of the purchase item.
+          sig { returns(T.nilable(String)) }
+          attr_reader :item_descriptor
+
+          sig { params(item_descriptor: String).void }
+          attr_writer :item_descriptor
+
+          # The number of units of the product being purchased.
+          sig { returns(T.nilable(String)) }
+          attr_reader :item_quantity
+
+          sig { params(item_quantity: String).void }
+          attr_writer :item_quantity
+
+          # Code used to categorize the product being purchased.
+          sig { returns(T.nilable(String)) }
+          attr_reader :product_code
+
+          sig { params(product_code: String).void }
+          attr_writer :product_code
+
+          # Sales tax amount for this line item.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :sales_tax_amount
+
+          sig { params(sales_tax_amount: Integer).void }
+          attr_writer :sales_tax_amount
+
+          # Sales tax rate for this line item.
+          sig { returns(T.nilable(String)) }
+          attr_reader :sales_tax_rate
+
+          sig { params(sales_tax_rate: String).void }
+          attr_writer :sales_tax_rate
+
+          # Total amount of all line items.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_amount
+
+          sig { params(total_amount: Integer).void }
+          attr_writer :total_amount
+
+          # Cost of line item per unit of measure, in major units.
+          sig { returns(T.nilable(String)) }
+          attr_reader :unit_cost
+
+          sig { params(unit_cost: String).void }
+          attr_writer :unit_cost
+
+          # Code indicating unit of measure (gallons, etc.).
+          sig { returns(T.nilable(String)) }
+          attr_reader :unit_of_measure_code
+
+          sig { params(unit_of_measure_code: String).void }
+          attr_writer :unit_of_measure_code
+
+          sig do
+            params(
+              discount_amount: Integer,
+              item_commodity_code: String,
+              item_descriptor: String,
+              item_quantity: String,
+              product_code: String,
+              sales_tax_amount: Integer,
+              sales_tax_rate: String,
+              total_amount: Integer,
+              unit_cost: String,
+              unit_of_measure_code: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Discount amount for this specific line item.
+            discount_amount: nil,
+            # Code used to categorize the purchase item.
+            item_commodity_code: nil,
+            # Description of the purchase item.
+            item_descriptor: nil,
+            # The number of units of the product being purchased.
+            item_quantity: nil,
+            # Code used to categorize the product being purchased.
+            product_code: nil,
+            # Sales tax amount for this line item.
+            sales_tax_amount: nil,
+            # Sales tax rate for this line item.
+            sales_tax_rate: nil,
+            # Total amount of all line items.
+            total_amount: nil,
+            # Cost of line item per unit of measure, in major units.
+            unit_cost: nil,
+            # Code indicating unit of measure (gallons, etc.).
+            unit_of_measure_code: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                discount_amount: Integer,
+                item_commodity_code: String,
+                item_descriptor: String,
+                item_quantity: String,
+                product_code: String,
+                sales_tax_amount: Integer,
+                sales_tax_rate: String,
+                total_amount: Integer,
+                unit_cost: String,
+                unit_of_measure_code: String
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/increase/resources/simulations/card_purchase_supplements.rbi

@@ -0,0 +1,41 @@
+# typed: strong
+
+module Increase
+  module Resources
+    class Simulations
+      class CardPurchaseSupplements
+        # Simulates the creation of a Card Purchase Supplement (Level 3 data) for a card
+        # settlement. This happens asynchronously in production when Visa sends enhanced
+        # transaction data about a purchase.
+        sig do
+          params(
+            transaction_id: String,
+            invoice:
+              Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice::OrHash,
+            line_items:
+              T::Array[
+                Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem::OrHash
+              ],
+            request_options: Increase::RequestOptions::OrHash
+          ).returns(Increase::CardPurchaseSupplement)
+        end
+        def create(
+          # The identifier of the Transaction to create a Card Purchase Supplement for. The
+          # Transaction must have a source of type `card_settlement`.
+          transaction_id:,
+          # Invoice-level information about the payment.
+          invoice: nil,
+          # Line item information, such as individual products purchased.
+          line_items: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Increase::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/increase/resources/simulations.rbi

@@ -35,6 +35,9 @@ module Increase
       sig { returns(Increase::Resources::Simulations::CardAuthentications) }
       attr_reader :card_authentications
 
+      sig { returns(Increase::Resources::Simulations::CardPurchaseSupplements) }
+      attr_reader :card_purchase_supplements
+
       sig { returns(Increase::Resources::Simulations::CardDisputes) }
       attr_reader :card_disputes
 

data/sig/increase/models/simulations/card_purchase_supplement_create_params.rbs

@@ -0,0 +1,210 @@
+module Increase
+  module Models
+    module Simulations
+      type card_purchase_supplement_create_params =
+        {
+          transaction_id: String,
+          invoice: Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice,
+          line_items: ::Array[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem]
+        }
+        & Increase::Internal::Type::request_parameters
+
+      class CardPurchaseSupplementCreateParams < Increase::Internal::Type::BaseModel
+        extend Increase::Internal::Type::RequestParameters::Converter
+        include Increase::Internal::Type::RequestParameters
+
+        attr_accessor transaction_id: String
+
+        attr_reader invoice: Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice?
+
+        def invoice=: (
+          Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice
+        ) -> Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice
+
+        attr_reader line_items: ::Array[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem]?
+
+        def line_items=: (
+          ::Array[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem]
+        ) -> ::Array[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem]
+
+        def initialize: (
+          transaction_id: String,
+          ?invoice: Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice,
+          ?line_items: ::Array[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem],
+          ?request_options: Increase::request_opts
+        ) -> void
+
+        def to_hash: -> {
+          transaction_id: String,
+          invoice: Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice,
+          line_items: ::Array[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem],
+          request_options: Increase::RequestOptions
+        }
+
+        type invoice =
+          {
+            discount_amount: Integer,
+            duty_tax_amount: Integer,
+            order_date: Date,
+            shipping_amount: Integer,
+            shipping_destination_country_code: String,
+            shipping_destination_postal_code: String,
+            shipping_source_postal_code: String,
+            shipping_tax_amount: Integer,
+            shipping_tax_rate: String,
+            unique_value_added_tax_invoice_reference: String
+          }
+
+        class Invoice < Increase::Internal::Type::BaseModel
+          attr_reader discount_amount: Integer?
+
+          def discount_amount=: (Integer) -> Integer
+
+          attr_reader duty_tax_amount: Integer?
+
+          def duty_tax_amount=: (Integer) -> Integer
+
+          attr_reader order_date: Date?
+
+          def order_date=: (Date) -> Date
+
+          attr_reader shipping_amount: Integer?
+
+          def shipping_amount=: (Integer) -> Integer
+
+          attr_reader shipping_destination_country_code: String?
+
+          def shipping_destination_country_code=: (String) -> String
+
+          attr_reader shipping_destination_postal_code: String?
+
+          def shipping_destination_postal_code=: (String) -> String
+
+          attr_reader shipping_source_postal_code: String?
+
+          def shipping_source_postal_code=: (String) -> String
+
+          attr_reader shipping_tax_amount: Integer?
+
+          def shipping_tax_amount=: (Integer) -> Integer
+
+          attr_reader shipping_tax_rate: String?
+
+          def shipping_tax_rate=: (String) -> String
+
+          attr_reader unique_value_added_tax_invoice_reference: String?
+
+          def unique_value_added_tax_invoice_reference=: (String) -> String
+
+          def initialize: (
+            ?discount_amount: Integer,
+            ?duty_tax_amount: Integer,
+            ?order_date: Date,
+            ?shipping_amount: Integer,
+            ?shipping_destination_country_code: String,
+            ?shipping_destination_postal_code: String,
+            ?shipping_source_postal_code: String,
+            ?shipping_tax_amount: Integer,
+            ?shipping_tax_rate: String,
+            ?unique_value_added_tax_invoice_reference: String
+          ) -> void
+
+          def to_hash: -> {
+            discount_amount: Integer,
+            duty_tax_amount: Integer,
+            order_date: Date,
+            shipping_amount: Integer,
+            shipping_destination_country_code: String,
+            shipping_destination_postal_code: String,
+            shipping_source_postal_code: String,
+            shipping_tax_amount: Integer,
+            shipping_tax_rate: String,
+            unique_value_added_tax_invoice_reference: String
+          }
+        end
+
+        type line_item =
+          {
+            discount_amount: Integer,
+            item_commodity_code: String,
+            item_descriptor: String,
+            item_quantity: String,
+            product_code: String,
+            sales_tax_amount: Integer,
+            sales_tax_rate: String,
+            total_amount: Integer,
+            unit_cost: String,
+            unit_of_measure_code: String
+          }
+
+        class LineItem < Increase::Internal::Type::BaseModel
+          attr_reader discount_amount: Integer?
+
+          def discount_amount=: (Integer) -> Integer
+
+          attr_reader item_commodity_code: String?
+
+          def item_commodity_code=: (String) -> String
+
+          attr_reader item_descriptor: String?
+
+          def item_descriptor=: (String) -> String
+
+          attr_reader item_quantity: String?
+
+          def item_quantity=: (String) -> String
+
+          attr_reader product_code: String?
+
+          def product_code=: (String) -> String
+
+          attr_reader sales_tax_amount: Integer?
+
+          def sales_tax_amount=: (Integer) -> Integer
+
+          attr_reader sales_tax_rate: String?
+
+          def sales_tax_rate=: (String) -> String
+
+          attr_reader total_amount: Integer?
+
+          def total_amount=: (Integer) -> Integer
+
+          attr_reader unit_cost: String?
+
+          def unit_cost=: (String) -> String
+
+          attr_reader unit_of_measure_code: String?
+
+          def unit_of_measure_code=: (String) -> String
+
+          def initialize: (
+            ?discount_amount: Integer,
+            ?item_commodity_code: String,
+            ?item_descriptor: String,
+            ?item_quantity: String,
+            ?product_code: String,
+            ?sales_tax_amount: Integer,
+            ?sales_tax_rate: String,
+            ?total_amount: Integer,
+            ?unit_cost: String,
+            ?unit_of_measure_code: String
+          ) -> void
+
+          def to_hash: -> {
+            discount_amount: Integer,
+            item_commodity_code: String,
+            item_descriptor: String,
+            item_quantity: String,
+            product_code: String,
+            sales_tax_amount: Integer,
+            sales_tax_rate: String,
+            total_amount: Integer,
+            unit_cost: String,
+            unit_of_measure_code: String
+          }
+        end
+      end
+    end
+  end
+end

data/sig/increase/resources/simulations/card_purchase_supplements.rbs

@@ -0,0 +1,16 @@
+module Increase
+  module Resources
+    class Simulations
+      class CardPurchaseSupplements
+        def create: (
+          transaction_id: String,
+          ?invoice: Increase::Simulations::CardPurchaseSupplementCreateParams::Invoice,
+          ?line_items: ::Array[Increase::Simulations::CardPurchaseSupplementCreateParams::LineItem],
+          ?request_options: Increase::request_opts
+        ) -> Increase::CardPurchaseSupplement
+
+        def initialize: (client: Increase::Client) -> void
+      end
+    end
+  end
+end

data/sig/increase/resources/simulations.rbs

@@ -21,6 +21,8 @@ module Increase
 
       attr_reader card_authentications: Increase::Resources::Simulations::CardAuthentications
 
+      attr_reader card_purchase_supplements: Increase::Resources::Simulations::CardPurchaseSupplements
+
       attr_reader card_disputes: Increase::Resources::Simulations::CardDisputes
 
       attr_reader physical_cards: Increase::Resources::Simulations::PhysicalCards

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: increase
 version: !ruby/object:Gem::Version
-  version: 1.294.0
+  version: 1.295.0
 platform: ruby
 authors:
 - Increase
@@ -338,6 +338,7 @@ files:
 - lib/increase/models/simulations/card_dispute_action_params.rb
 - lib/increase/models/simulations/card_fuel_confirmation_create_params.rb
 - lib/increase/models/simulations/card_increment_create_params.rb
+- lib/increase/models/simulations/card_purchase_supplement_create_params.rb
 - lib/increase/models/simulations/card_refund_create_params.rb
 - lib/increase/models/simulations/card_reversal_create_params.rb
 - lib/increase/models/simulations/card_settlement_create_params.rb
@@ -455,6 +456,7 @@ files:
 - lib/increase/resources/simulations/card_disputes.rb
 - lib/increase/resources/simulations/card_fuel_confirmations.rb
 - lib/increase/resources/simulations/card_increments.rb
+- lib/increase/resources/simulations/card_purchase_supplements.rb
 - lib/increase/resources/simulations/card_refunds.rb
 - lib/increase/resources/simulations/card_reversals.rb
 - lib/increase/resources/simulations/card_settlements.rb
@@ -759,6 +761,7 @@ files:
 - rbi/increase/models/simulations/card_dispute_action_params.rbi
 - rbi/increase/models/simulations/card_fuel_confirmation_create_params.rbi
 - rbi/increase/models/simulations/card_increment_create_params.rbi
+- rbi/increase/models/simulations/card_purchase_supplement_create_params.rbi
 - rbi/increase/models/simulations/card_refund_create_params.rbi
 - rbi/increase/models/simulations/card_reversal_create_params.rbi
 - rbi/increase/models/simulations/card_settlement_create_params.rbi
@@ -876,6 +879,7 @@ files:
 - rbi/increase/resources/simulations/card_disputes.rbi
 - rbi/increase/resources/simulations/card_fuel_confirmations.rbi
 - rbi/increase/resources/simulations/card_increments.rbi
+- rbi/increase/resources/simulations/card_purchase_supplements.rbi
 - rbi/increase/resources/simulations/card_refunds.rbi
 - rbi/increase/resources/simulations/card_reversals.rbi
 - rbi/increase/resources/simulations/card_settlements.rbi
@@ -1179,6 +1183,7 @@ files:
 - sig/increase/models/simulations/card_dispute_action_params.rbs
 - sig/increase/models/simulations/card_fuel_confirmation_create_params.rbs
 - sig/increase/models/simulations/card_increment_create_params.rbs
+- sig/increase/models/simulations/card_purchase_supplement_create_params.rbs
 - sig/increase/models/simulations/card_refund_create_params.rbs
 - sig/increase/models/simulations/card_reversal_create_params.rbs
 - sig/increase/models/simulations/card_settlement_create_params.rbs
@@ -1296,6 +1301,7 @@ files:
 - sig/increase/resources/simulations/card_disputes.rbs
 - sig/increase/resources/simulations/card_fuel_confirmations.rbs
 - sig/increase/resources/simulations/card_increments.rbs
+- sig/increase/resources/simulations/card_purchase_supplements.rbs
 - sig/increase/resources/simulations/card_refunds.rbs
 - sig/increase/resources/simulations/card_reversals.rbs
 - sig/increase/resources/simulations/card_settlements.rbs