square.rb 44.1.0.20250924 → 45.0.1.20260122

data/lib/square/types/retrieve_merchant_custom_attribute_definition_response.rb

@@ -2,12 +2,12 @@
 
 module Square
   module Types
-    # Represents a [RetrieveMerchantCustomAttributeDefinition](api-endpoint:MerchantCustomAttributes-RetrieveMerchantCustomAttributeDefinition) response.
+    # Represents a
+    # [RetrieveMerchantCustomAttributeDefinition](api-endpoint:MerchantCustomAttributes-RetrieveMerchantCustomAttributeDefinition)
+    # response.
     # Either `custom_attribute_definition` or `errors` is present in the response.
     class RetrieveMerchantCustomAttributeDefinitionResponse < Internal::Types::Model
-      field :custom_attribute_definition, lambda {
-        Square::Types::CustomAttributeDefinition
-      }, optional: true, nullable: false
+      field :custom_attribute_definition, -> { Square::Types::CustomAttributeDefinition }, optional: true, nullable: false
       field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
     end
   end

data/lib/square/types/retrieve_merchant_custom_attribute_response.rb

@@ -2,7 +2,8 @@
 
 module Square
   module Types
-    # Represents a [RetrieveMerchantCustomAttribute](api-endpoint:MerchantCustomAttributes-RetrieveMerchantCustomAttribute) response.
+    # Represents a
+    # [RetrieveMerchantCustomAttribute](api-endpoint:MerchantCustomAttributes-RetrieveMerchantCustomAttribute) response.
     # Either `custom_attribute_definition` or `errors` is present in the response.
     class RetrieveMerchantCustomAttributeResponse < Internal::Types::Model
       field :custom_attribute, -> { Square::Types::CustomAttribute }, optional: true, nullable: false

data/lib/square/types/retrieve_order_custom_attribute_definition_response.rb

@@ -4,9 +4,7 @@ module Square
   module Types
     # Represents a response from getting an order custom attribute definition.
     class RetrieveOrderCustomAttributeDefinitionResponse < Internal::Types::Model
-      field :custom_attribute_definition, lambda {
-        Square::Types::CustomAttributeDefinition
-      }, optional: true, nullable: false
+      field :custom_attribute_definition, -> { Square::Types::CustomAttributeDefinition }, optional: true, nullable: false
       field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
     end
   end

data/lib/square/types/retrieve_transfer_order_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # Response containing the requested transfer order
+    class RetrieveTransferOrderResponse < Internal::Types::Model
+      field :transfer_order, -> { Square::Types::TransferOrder }, optional: true, nullable: false
+      field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/scheduled_shift_filter.rb

@@ -7,15 +7,11 @@ module Square
     class ScheduledShiftFilter < Internal::Types::Model
       field :location_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
       field :start, -> { Square::Types::TimeRange }, optional: true, nullable: false
-      field :end_, -> { Square::Types::TimeRange }, optional: true, nullable: false
+      field :end_, -> { Square::Types::TimeRange }, optional: true, nullable: false, api_name: "end"
       field :workday, -> { Square::Types::ScheduledShiftWorkday }, optional: true, nullable: false
       field :team_member_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
-      field :assignment_status, lambda {
-        Square::Types::ScheduledShiftFilterAssignmentStatus
-      }, optional: true, nullable: false
-      field :scheduled_shift_statuses, lambda {
-        Internal::Types::Array[Square::Types::ScheduledShiftFilterScheduledShiftStatus]
-      }, optional: true, nullable: false
+      field :assignment_status, -> { Square::Types::ScheduledShiftFilterAssignmentStatus }, optional: true, nullable: false
+      field :scheduled_shift_statuses, -> { Internal::Types::Array[Square::Types::ScheduledShiftFilterScheduledShiftStatus] }, optional: true, nullable: false
     end
   end
 end

data/lib/square/types/scheduled_shift_workday.rb

@@ -6,9 +6,7 @@ module Square
     # a `Shift` must start or end in before passing the filter condition.
     class ScheduledShiftWorkday < Internal::Types::Model
       field :date_range, -> { Square::Types::DateRange }, optional: true, nullable: false
-      field :match_scheduled_shifts_by, lambda {
-        Square::Types::ScheduledShiftWorkdayMatcher
-      }, optional: true, nullable: false
+      field :match_scheduled_shifts_by, -> { Square::Types::ScheduledShiftWorkdayMatcher }, optional: true, nullable: false
       field :default_timezone, -> { String }, optional: true, nullable: false
     end
   end

data/lib/square/types/search_availability_filter.rb

@@ -6,9 +6,7 @@ module Square
     class SearchAvailabilityFilter < Internal::Types::Model
       field :start_at_range, -> { Square::Types::TimeRange }, optional: false, nullable: false
       field :location_id, -> { String }, optional: true, nullable: false
-      field :segment_filters, lambda {
-        Internal::Types::Array[Square::Types::SegmentFilter]
-      }, optional: true, nullable: false
+      field :segment_filters, -> { Internal::Types::Array[Square::Types::SegmentFilter] }, optional: true, nullable: false
       field :booking_id, -> { String }, optional: true, nullable: false
     end
   end

data/lib/square/types/search_catalog_items_response.rb

@@ -2,7 +2,8 @@
 
 module Square
   module Types
-    # Defines the response body returned from the [SearchCatalogItems](api-endpoint:Catalog-SearchCatalogItems) endpoint.
+    # Defines the response body returned from the [SearchCatalogItems](api-endpoint:Catalog-SearchCatalogItems)
+    # endpoint.
     class SearchCatalogItemsResponse < Internal::Types::Model
       field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
       field :items, -> { Internal::Types::Array[Square::Types::CatalogObject] }, optional: true, nullable: false

data/lib/square/types/search_catalog_objects_response.rb

@@ -6,9 +6,7 @@ module Square
       field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
       field :cursor, -> { String }, optional: true, nullable: false
       field :objects, -> { Internal::Types::Array[Square::Types::CatalogObject] }, optional: true, nullable: false
-      field :related_objects, lambda {
-        Internal::Types::Array[Square::Types::CatalogObject]
-      }, optional: true, nullable: false
+      field :related_objects, -> { Internal::Types::Array[Square::Types::CatalogObject] }, optional: true, nullable: false
       field :latest_time, -> { String }, optional: true, nullable: false
     end
   end

data/lib/square/types/search_events_sort_field.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    module SearchEventsSortField
+      # SearchEventsSortField is an alias for Object
+
+      # @option str [String]
+      #
+      # @return [untyped]
+      def self.load(str)
+        ::JSON.parse(str)
+      end
+
+      # @option value [untyped]
+      #
+      # @return [String]
+      def self.dump(value)
+        ::JSON.generate(value)
+      end
+    end
+  end
+end

data/lib/square/types/search_loyalty_accounts_request_loyalty_account_query.rb

@@ -4,9 +4,7 @@ module Square
   module Types
     # The search criteria for the loyalty accounts.
     class SearchLoyaltyAccountsRequestLoyaltyAccountQuery < Internal::Types::Model
-      field :mappings, lambda {
-        Internal::Types::Array[Square::Types::LoyaltyAccountMapping]
-      }, optional: true, nullable: false
+      field :mappings, -> { Internal::Types::Array[Square::Types::LoyaltyAccountMapping] }, optional: true, nullable: false
       field :customer_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
     end
   end

data/lib/square/types/search_loyalty_accounts_response.rb

@@ -5,9 +5,7 @@ module Square
     # A response that includes loyalty accounts that satisfy the search criteria.
     class SearchLoyaltyAccountsResponse < Internal::Types::Model
       field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
-      field :loyalty_accounts, lambda {
-        Internal::Types::Array[Square::Types::LoyaltyAccount]
-      }, optional: true, nullable: false
+      field :loyalty_accounts, -> { Internal::Types::Array[Square::Types::LoyaltyAccount] }, optional: true, nullable: false
       field :cursor, -> { String }, optional: true, nullable: false
     end
   end

data/lib/square/types/search_orders_date_time_filter.rb

@@ -15,7 +15,8 @@ module Square
     # to the same field you filter for. For example, if you set the `CLOSED_AT` field
     # in `DateTimeFilter`, you must set the `sort_field` in `SearchOrdersSort` to
     # `CLOSED_AT`. Otherwise, `SearchOrders` throws an error.
-    # [Learn more about filtering orders by time range.](https://developer.squareup.com/docs/orders-api/manage-orders/search-orders#important-note-about-filtering-orders-by-time-range)
+    # [Learn more about filtering orders by time
+    # range.](https://developer.squareup.com/docs/orders-api/manage-orders/search-orders#important-note-about-filtering-orders-by-time-range)
     class SearchOrdersDateTimeFilter < Internal::Types::Model
       field :created_at, -> { Square::Types::TimeRange }, optional: true, nullable: false
       field :updated_at, -> { Square::Types::TimeRange }, optional: true, nullable: false

data/lib/square/types/search_orders_fulfillment_filter.rb

@@ -4,12 +4,8 @@ module Square
   module Types
     # Filter based on [order fulfillment](entity:Fulfillment) information.
     class SearchOrdersFulfillmentFilter < Internal::Types::Model
-      field :fulfillment_types, lambda {
-        Internal::Types::Array[Square::Types::FulfillmentType]
-      }, optional: true, nullable: false
-      field :fulfillment_states, lambda {
-        Internal::Types::Array[Square::Types::FulfillmentState]
-      }, optional: true, nullable: false
+      field :fulfillment_types, -> { Internal::Types::Array[Square::Types::FulfillmentType] }, optional: true, nullable: false
+      field :fulfillment_states, -> { Internal::Types::Array[Square::Types::FulfillmentState] }, optional: true, nullable: false
     end
   end
 end

data/lib/square/types/search_orders_source_filter.rb

@@ -5,6 +5,8 @@ module Square
     # A filter based on order `source` information.
     class SearchOrdersSourceFilter < Internal::Types::Model
       field :source_names, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      field :source_application_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      field :source_client_ous, -> { Internal::Types::Array[String] }, optional: true, nullable: false
     end
   end
 end

data/lib/square/types/search_scheduled_shifts_response.rb

@@ -5,9 +5,7 @@ module Square
     # Represents a [SearchScheduledShifts](api-endpoint:Labor-SearchScheduledShifts) response.
     # Either `scheduled_shifts` or `errors` is present in the response.
     class SearchScheduledShiftsResponse < Internal::Types::Model
-      field :scheduled_shifts, lambda {
-        Internal::Types::Array[Square::Types::ScheduledShift]
-      }, optional: true, nullable: false
+      field :scheduled_shifts, -> { Internal::Types::Array[Square::Types::ScheduledShift] }, optional: true, nullable: false
       field :cursor, -> { String }, optional: true, nullable: false
       field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
     end

data/lib/square/types/search_transfer_orders_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # Response for searching transfer orders
+    class SearchTransferOrdersResponse < Internal::Types::Model
+      field :transfer_orders, -> { Internal::Types::Array[Square::Types::TransferOrder] }, optional: true, nullable: false
+      field :cursor, -> { String }, optional: true, nullable: false
+      field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/shift_filter.rb

@@ -5,13 +5,14 @@ module Square
     # Defines a filter used in a search for `Shift` records. `AND` logic is
     # used by Square's servers to apply each filter property specified.
     #
-    # Deprecated at Square API version 2025-05-21. See the [migration notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
+    # Deprecated at Square API version 2025-05-21. See the [migration
+    # notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
     class ShiftFilter < Internal::Types::Model
       field :location_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
       field :employee_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
       field :status, -> { Square::Types::ShiftFilterStatus }, optional: true, nullable: false
       field :start, -> { Square::Types::TimeRange }, optional: true, nullable: false
-      field :end_, -> { Square::Types::TimeRange }, optional: true, nullable: false
+      field :end_, -> { Square::Types::TimeRange }, optional: true, nullable: false, api_name: "end"
       field :workday, -> { Square::Types::ShiftWorkday }, optional: true, nullable: false
       field :team_member_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
     end

data/lib/square/types/shift_query.rb

@@ -4,7 +4,8 @@ module Square
   module Types
     # The parameters of a `Shift` search query, which includes filter and sort options.
     #
-    # Deprecated at Square API version 2025-05-21. See the [migration notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
+    # Deprecated at Square API version 2025-05-21. See the [migration
+    # notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
     class ShiftQuery < Internal::Types::Model
       field :filter, -> { Square::Types::ShiftFilter }, optional: true, nullable: false
       field :sort, -> { Square::Types::ShiftSort }, optional: true, nullable: false

data/lib/square/types/shift_sort.rb

@@ -4,7 +4,8 @@ module Square
   module Types
     # Sets the sort order of search results.
     #
-    # Deprecated at Square API version 2025-05-21. See the [migration notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
+    # Deprecated at Square API version 2025-05-21. See the [migration
+    # notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
     class ShiftSort < Internal::Types::Model
       field :field, -> { Square::Types::ShiftSortField }, optional: true, nullable: false
       field :order, -> { Square::Types::SortOrder }, optional: true, nullable: false

data/lib/square/types/shift_wage.rb

@@ -4,7 +4,8 @@ module Square
   module Types
     # The hourly wage rate used to compensate an employee for this shift.
     #
-    # Deprecated at Square API version 2025-05-21. See the [migration notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
+    # Deprecated at Square API version 2025-05-21. See the [migration
+    # notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
     class ShiftWage < Internal::Types::Model
       field :title, -> { String }, optional: true, nullable: false
       field :hourly_rate, -> { Square::Types::Money }, optional: true, nullable: false

data/lib/square/types/shift_workday.rb

@@ -5,7 +5,8 @@ module Square
     # A `Shift` search query filter parameter that sets a range of days that
     # a `Shift` must start or end in before passing the filter condition.
     #
-    # Deprecated at Square API version 2025-05-21. See the [migration notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
+    # Deprecated at Square API version 2025-05-21. See the [migration
+    # notes](https://developer.squareup.com/docs/labor-api/what-it-does#migration-notes).
     class ShiftWorkday < Internal::Types::Model
       field :date_range, -> { Square::Types::DateRange }, optional: true, nullable: false
       field :match_shifts_by, -> { Square::Types::ShiftWorkdayMatcher }, optional: true, nullable: false

data/lib/square/types/snippet.rb

@@ -2,7 +2,8 @@
 
 module Square
   module Types
-    # Represents the snippet that is added to a Square Online site. The snippet code is injected into the `head` element of all pages on the site, except for checkout pages.
+    # Represents the snippet that is added to a Square Online site. The snippet code is injected into the `head` element
+    # of all pages on the site, except for checkout pages.
     class Snippet < Internal::Types::Model
       field :id, -> { String }, optional: true, nullable: false
       field :site_id, -> { String }, optional: true, nullable: false

data/lib/square/types/standard_unit_description_group.rb

@@ -4,9 +4,7 @@ module Square
   module Types
     # Group of standard measurement units.
     class StandardUnitDescriptionGroup < Internal::Types::Model
-      field :standard_unit_descriptions, lambda {
-        Internal::Types::Array[Square::Types::StandardUnitDescription]
-      }, optional: true, nullable: false
+      field :standard_unit_descriptions, -> { Internal::Types::Array[Square::Types::StandardUnitDescription] }, optional: true, nullable: false
       field :language_code, -> { String }, optional: true, nullable: false
     end
   end

data/lib/square/types/start_transfer_order_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # Response for starting a transfer order.
+    class StartTransferOrderResponse < Internal::Types::Model
+      field :transfer_order, -> { Square::Types::TransferOrder }, optional: true, nullable: false
+      field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/subscription_event.rb

@@ -5,9 +5,7 @@ module Square
     # Describes changes to a subscription and the subscription status.
     class SubscriptionEvent < Internal::Types::Model
       field :id, -> { String }, optional: false, nullable: false
-      field :subscription_event_type, lambda {
-        Square::Types::SubscriptionEventSubscriptionEventType
-      }, optional: false, nullable: false
+      field :subscription_event_type, -> { Square::Types::SubscriptionEventSubscriptionEventType }, optional: false, nullable: false
       field :effective_date, -> { String }, optional: false, nullable: false
       field :monthly_billing_anchor_date, -> { Integer }, optional: true, nullable: false
       field :info, -> { Square::Types::SubscriptionEventInfo }, optional: true, nullable: false

data/lib/square/types/subscription_phase.rb

@@ -2,7 +2,8 @@
 
 module Square
   module Types
-    # Describes a phase in a subscription plan variation. For more information, see [Subscription Plans and Variations](https://developer.squareup.com/docs/subscriptions-api/plans-and-variations).
+    # Describes a phase in a subscription plan variation. For more information, see [Subscription Plans and
+    # Variations](https://developer.squareup.com/docs/subscriptions-api/plans-and-variations).
     class SubscriptionPhase < Internal::Types::Model
       field :uid, -> { String }, optional: true, nullable: false
       field :cadence, -> { Square::Types::SubscriptionCadence }, optional: false, nullable: false

data/lib/square/types/subscription_test_result.rb

@@ -2,14 +2,16 @@
 
 module Square
   module Types
-    # Represents the details of a webhook subscription, including notification URL,
-    # event types, and signature key.
+    # Represents the result of testing a webhook subscription. Note: The actual API returns these fields at the root
+    # level of TestWebhookSubscriptionResponse, not nested under this object.
     class SubscriptionTestResult < Internal::Types::Model
       field :id, -> { String }, optional: true, nullable: false
       field :status_code, -> { Integer }, optional: true, nullable: false
-      field :payload, -> { String }, optional: true, nullable: false
+      field :payload, -> { Internal::Types::Hash[String, Object] }, optional: true, nullable: false
       field :created_at, -> { String }, optional: true, nullable: false
       field :updated_at, -> { String }, optional: true, nullable: false
+      field :notification_url, -> { String }, optional: true, nullable: false
+      field :passes_filter, -> { Internal::Types::Boolean }, optional: true, nullable: false
     end
   end
 end

data/lib/square/types/team_member_assigned_locations.rb

@@ -4,9 +4,7 @@ module Square
   module Types
     # An object that represents a team member's assignment to locations.
     class TeamMemberAssignedLocations < Internal::Types::Model
-      field :assignment_type, lambda {
-        Square::Types::TeamMemberAssignedLocationsAssignmentType
-      }, optional: true, nullable: false
+      field :assignment_type, -> { Square::Types::TeamMemberAssignedLocationsAssignmentType }, optional: true, nullable: false
       field :location_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
     end
   end

data/lib/square/types/team_member_booking_profile.rb

@@ -2,7 +2,8 @@
 
 module Square
   module Types
-    # The booking profile of a seller's team member, including the team member's ID, display name, description and whether the team member can be booked as a service provider.
+    # The booking profile of a seller's team member, including the team member's ID, display name, description and
+    # whether the team member can be booked as a service provider.
     class TeamMemberBookingProfile < Internal::Types::Model
       field :team_member_id, -> { String }, optional: true, nullable: false
       field :description, -> { String }, optional: true, nullable: false

data/lib/square/types/tender.rb

@@ -17,13 +17,9 @@ module Square
       field :card_details, -> { Square::Types::TenderCardDetails }, optional: true, nullable: false
       field :cash_details, -> { Square::Types::TenderCashDetails }, optional: true, nullable: false
       field :bank_account_details, -> { Square::Types::TenderBankAccountDetails }, optional: true, nullable: false
-      field :buy_now_pay_later_details, lambda {
-        Square::Types::TenderBuyNowPayLaterDetails
-      }, optional: true, nullable: false
+      field :buy_now_pay_later_details, -> { Square::Types::TenderBuyNowPayLaterDetails }, optional: true, nullable: false
       field :square_account_details, -> { Square::Types::TenderSquareAccountDetails }, optional: true, nullable: false
-      field :additional_recipients, lambda {
-        Internal::Types::Array[Square::Types::AdditionalRecipient]
-      }, optional: true, nullable: false
+      field :additional_recipients, -> { Internal::Types::Array[Square::Types::AdditionalRecipient] }, optional: true, nullable: false
       field :payment_id, -> { String }, optional: true, nullable: false
     end
   end

data/lib/square/types/tender_buy_now_pay_later_details.rb

@@ -4,9 +4,7 @@ module Square
   module Types
     # Represents the details of a tender with `type` `BUY_NOW_PAY_LATER`.
     class TenderBuyNowPayLaterDetails < Internal::Types::Model
-      field :buy_now_pay_later_brand, lambda {
-        Square::Types::TenderBuyNowPayLaterDetailsBrand
-      }, optional: true, nullable: false
+      field :buy_now_pay_later_brand, -> { Square::Types::TenderBuyNowPayLaterDetailsBrand }, optional: true, nullable: false
       field :status, -> { Square::Types::TenderBuyNowPayLaterDetailsStatus }, optional: true, nullable: false
     end
   end

data/lib/square/types/terminal_refund.rb

@@ -2,7 +2,8 @@
 
 module Square
   module Types
-    # Represents a payment refund processed by the Square Terminal. Only supports Interac (Canadian debit network) payment refunds.
+    # Represents a payment refund processed by the Square Terminal. Only supports Interac (Canadian debit network)
+    # payment refunds.
     class TerminalRefund < Internal::Types::Model
       field :id, -> { String }, optional: true, nullable: false
       field :refund_id, -> { String }, optional: true, nullable: false

data/lib/square/types/test_webhook_subscription_response.rb

@@ -2,14 +2,14 @@
 
 module Square
   module Types
-    # Defines the fields that are included in the response body of
-    # a request to the [TestWebhookSubscription](api-endpoint:WebhookSubscriptions-TestWebhookSubscription) endpoint.
-    #
-    # Note: If there are errors processing the request, the [SubscriptionTestResult](entity:SubscriptionTestResult) field is not
-    # present.
+    # Defines the fields that are included in the response body of a request to the TestWebhookSubscription endpoint.
     class TestWebhookSubscriptionResponse < Internal::Types::Model
       field :errors, -> { Internal::Types::Array[Square::Types::Error] }, optional: true, nullable: false
       field :subscription_test_result, -> { Square::Types::SubscriptionTestResult }, optional: true, nullable: false
+      field :notification_url, -> { String }, optional: true, nullable: false
+      field :status_code, -> { Integer }, optional: true, nullable: false
+      field :passes_filter, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      field :payload, -> { Internal::Types::Hash[String, Object] }, optional: true, nullable: false
     end
   end
 end

data/lib/square/types/timecard_filter.rb

@@ -8,7 +8,7 @@ module Square
       field :location_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
       field :status, -> { Square::Types::TimecardFilterStatus }, optional: true, nullable: false
       field :start, -> { Square::Types::TimeRange }, optional: true, nullable: false
-      field :end_, -> { Square::Types::TimeRange }, optional: true, nullable: false
+      field :end_, -> { Square::Types::TimeRange }, optional: true, nullable: false, api_name: "end"
       field :workday, -> { Square::Types::TimecardWorkday }, optional: true, nullable: false
       field :team_member_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
     end

data/lib/square/types/transfer_order.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # Represents a transfer order for moving [CatalogItemVariation](entity:CatalogItemVariation)s
+    # between [Location](entity:Location)s. Transfer orders track the entire lifecycle of an inventory
+    # transfer, including:
+    # - What items and quantities are being moved
+    # - Source and destination locations
+    # - Current [TransferOrderStatus](entity:TransferOrderStatus)
+    # - Shipping information and tracking
+    # - Which [TeamMember](entity:TeamMember) initiated the transfer
+    #
+    # This object is commonly used to:
+    # - Track [CatalogItemVariation](entity:CatalogItemVariation) movements between [Location](entity:Location)s
+    # - Reconcile expected vs received quantities
+    # - Monitor transfer progress and shipping status
+    # - Audit inventory movement history
+    class TransferOrder < Internal::Types::Model
+      field :id, -> { String }, optional: true, nullable: false
+      field :source_location_id, -> { String }, optional: true, nullable: false
+      field :destination_location_id, -> { String }, optional: true, nullable: false
+      field :status, -> { Square::Types::TransferOrderStatus }, optional: true, nullable: false
+      field :created_at, -> { String }, optional: true, nullable: false
+      field :updated_at, -> { String }, optional: true, nullable: false
+      field :expected_at, -> { String }, optional: true, nullable: false
+      field :completed_at, -> { String }, optional: true, nullable: false
+      field :notes, -> { String }, optional: true, nullable: false
+      field :tracking_number, -> { String }, optional: true, nullable: false
+      field :created_by_team_member_id, -> { String }, optional: true, nullable: false
+      field :line_items, -> { Internal::Types::Array[Square::Types::TransferOrderLine] }, optional: true, nullable: false
+      field :version, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/transfer_order_created_event.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # Published when a transfer_order is created.
+    class TransferOrderCreatedEvent < Internal::Types::Model
+      field :merchant_id, -> { String }, optional: true, nullable: false
+      field :type, -> { String }, optional: true, nullable: false
+      field :event_id, -> { String }, optional: true, nullable: false
+      field :created_at, -> { String }, optional: true, nullable: false
+      field :data, -> { Square::Types::TransferOrderCreatedEventData }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/transfer_order_created_event_data.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    class TransferOrderCreatedEventData < Internal::Types::Model
+      field :type, -> { String }, optional: true, nullable: false
+      field :id, -> { String }, optional: true, nullable: false
+      field :object, -> { Square::Types::TransferOrderCreatedEventObject }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/transfer_order_created_event_object.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    class TransferOrderCreatedEventObject < Internal::Types::Model
+      field :transfer_order, -> { Square::Types::TransferOrder }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/transfer_order_deleted_event.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # Published when a transfer_order is deleted.
+    class TransferOrderDeletedEvent < Internal::Types::Model
+      field :merchant_id, -> { String }, optional: true, nullable: false
+      field :type, -> { String }, optional: true, nullable: false
+      field :event_id, -> { String }, optional: true, nullable: false
+      field :created_at, -> { String }, optional: true, nullable: false
+      field :data, -> { Square::Types::TransferOrderDeletedEventData }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/transfer_order_deleted_event_data.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    class TransferOrderDeletedEventData < Internal::Types::Model
+      field :type, -> { String }, optional: true, nullable: false
+      field :id, -> { String }, optional: true, nullable: false
+      field :deleted, -> { Internal::Types::Boolean }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/transfer_order_filter.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # Filter criteria for searching transfer orders
+    class TransferOrderFilter < Internal::Types::Model
+      field :source_location_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      field :destination_location_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      field :statuses, -> { Internal::Types::Array[Square::Types::TransferOrderStatus] }, optional: true, nullable: false
+    end
+  end
+end

data/lib/square/types/transfer_order_goods_receipt.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    # The goods receipt details for a transfer order. This object represents a single receipt
+    # of goods against a transfer order, tracking:
+    #
+    # - Which [CatalogItemVariation](entity:CatalogItemVariation)s were received
+    # - Quantities received in good condition
+    # - Quantities damaged during transit/handling
+    # - Quantities canceled during receipt
+    #
+    # Multiple goods receipts can be created for a single transfer order to handle:
+    # - Partial deliveries
+    # - Multiple shipments
+    # - Split receipts across different dates
+    # - Cancellations of specific quantities
+    #
+    # Each receipt automatically:
+    # - Updates the transfer order status
+    # - Adjusts received quantities
+    # - Updates inventory levels at both source and destination [Location](entity:Location)s
+    class TransferOrderGoodsReceipt < Internal::Types::Model
+      field :line_items, -> { Internal::Types::Array[Square::Types::TransferOrderGoodsReceiptLineItem] }, optional: true, nullable: false
+    end
+  end
+end