whop_sdk 2.6.0 → 2.7.0

data/lib/whop_sdk/accounts/client.rb

@@ -569,14 +569,19 @@ module Whop_sdk
         end
       end
 
+      # @return [Whop_sdk::CustomerTracking::Client]
+      def customer_tracking
+        @customer_tracking ||= Whop_sdk::Accounts::CustomerTracking::Client.new(client: @client, base_url: @base_url, environment: @environment)
+      end
+
       # @return [Whop_sdk::Fees::Client]
       def fees
         @fees ||= Whop_sdk::Accounts::Fees::Client.new(client: @client, base_url: @base_url, environment: @environment)
       end
 
-      # @return [Whop_sdk::FinancingApplications::Client]
-      def financing_applications
-        @financing_applications ||= Whop_sdk::Accounts::FinancingApplications::Client.new(client: @client, base_url: @base_url, environment: @environment)
+      # @return [Whop_sdk::FinancingProviders::Client]
+      def financing_providers
+        @financing_providers ||= Whop_sdk::Accounts::FinancingProviders::Client.new(client: @client, base_url: @base_url, environment: @environment)
       end
 
       # @return [Whop_sdk::Preferences::Client]

data/lib/whop_sdk/accounts/customer_tracking/client.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module CustomerTracking
+      class Client
+        # @param client [Whop_sdk::Internal::Http::RawClient]
+        # @param base_url [String, nil]
+        # @param environment [Hash[Symbol, String], nil]
+        #
+        # @return [void]
+        def initialize(client:, base_url: nil, environment: nil)
+          @client = client
+          @base_url = base_url
+          @environment = environment
+        end
+
+        # Retrieves the branding and support contacts the account's hosted customer tracking page and tracking Element
+        # display. Public by design, so no authentication is required. Returns 404 unless the account has turned
+        # customer tracking on in its preferences. Responses are never cached.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :account_id
+        #
+        # @example
+        #   client.accounts.customer_tracking.retrieve(account_id: "account_id")
+        #
+        # @return [Whop_sdk::Types::AccountCustomerTracking]
+        def retrieve(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "GET",
+            path: "accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/customer_tracking",
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Whop_sdk::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Whop_sdk::Types::AccountCustomerTracking.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/{financing_applications/types/create_financing_applications_request.rb → customer_tracking/types/retrieve_customer_tracking_request.rb}

@@ -2,9 +2,9 @@
 
 module Whop_sdk
   module Accounts
-    module FinancingApplications
+    module CustomerTracking
       module Types
-        class CreateFinancingApplicationsRequest < Internal::Types::Model
+        class RetrieveCustomerTrackingRequest < Internal::Types::Model
           field :account_id, -> { String }, optional: false, nullable: false
         end
       end

data/lib/whop_sdk/accounts/fees/types/update_fees_request.rb

@@ -7,6 +7,10 @@ module Whop_sdk
         class UpdateFeesRequest < Internal::Types::Model
           field :account_id, -> { String }, optional: false, nullable: false
 
+          field :ach_dispute, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestAchDispute }, optional: true, nullable: false
+
+          field :ach_return, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestAchReturn }, optional: true, nullable: false
+
           field :bank_deposit, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestBankDeposit }, optional: true, nullable: false
 
           field :billing, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestBilling }, optional: true, nullable: false
@@ -59,6 +63,10 @@ module Whop_sdk
 
           field :revshare, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestRevshare }, optional: true, nullable: false
 
+          field :sepa_dispute, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestSepaDispute }, optional: true, nullable: false
+
+          field :sepa_return, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestSepaReturn }, optional: true, nullable: false
+
           field :tax_calculation, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestTaxCalculation }, optional: true, nullable: false
 
           field :tax_service, -> { Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestTaxService }, optional: true, nullable: false

data/lib/whop_sdk/accounts/fees/types/update_fees_request_ach_dispute.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        # The fields of a fee the caller may change. Only the keys sent are replaced.
+        class UpdateFeesRequestAchDispute < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+
+          field :regions, -> { Internal::Types::Hash[String, Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestAchDisputeRegionsValue] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/fees/types/update_fees_request_ach_dispute_regions_value.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        class UpdateFeesRequestAchDisputeRegionsValue < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/fees/types/update_fees_request_ach_return.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        # The fields of a fee the caller may change. Only the keys sent are replaced.
+        class UpdateFeesRequestAchReturn < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+
+          field :regions, -> { Internal::Types::Hash[String, Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestAchReturnRegionsValue] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/fees/types/update_fees_request_ach_return_regions_value.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        class UpdateFeesRequestAchReturnRegionsValue < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/fees/types/update_fees_request_sepa_dispute.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        # The fields of a fee the caller may change. Only the keys sent are replaced.
+        class UpdateFeesRequestSepaDispute < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+
+          field :regions, -> { Internal::Types::Hash[String, Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestSepaDisputeRegionsValue] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/fees/types/update_fees_request_sepa_dispute_regions_value.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        class UpdateFeesRequestSepaDisputeRegionsValue < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/fees/types/update_fees_request_sepa_return.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        # The fields of a fee the caller may change. Only the keys sent are replaced.
+        class UpdateFeesRequestSepaReturn < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+
+          field :regions, -> { Internal::Types::Hash[String, Whop_sdk::Accounts::Fees::Types::UpdateFeesRequestSepaReturnRegionsValue] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/fees/types/update_fees_request_sepa_return_regions_value.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Fees
+      module Types
+        class UpdateFeesRequestSepaReturnRegionsValue < Internal::Types::Model
+          field :fixed, -> { Integer }, optional: true, nullable: false
+
+          field :percentage, -> { Integer }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/financing_providers/client.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module FinancingProviders
+      class Client
+        # @param client [Whop_sdk::Internal::Http::RawClient]
+        # @param base_url [String, nil]
+        # @param environment [Hash[Symbol, String], nil]
+        #
+        # @return [void]
+        def initialize(client:, base_url: nil, environment: nil)
+          @client = client
+          @base_url = base_url
+          @environment = environment
+        end
+
+        # Lists every financing provider and where it stands for an account: whether checkout offers it, what the
+        # merchant can do to turn it on, and why it is off.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :account_id
+        # @option params [Whop_sdk::Accounts::FinancingProviders::Types::ListFinancingProvidersRequestStatus, nil] :status
+        # @option params [Integer, nil] :first
+        # @option params [String, nil] :after
+        # @option params [Integer, nil] :last
+        # @option params [String, nil] :before
+        #
+        # @example
+        #   client.accounts.financing_providers.list(account_id: "account_id")
+        #
+        # @return [Whop_sdk::Accounts::FinancingProviders::Types::ListFinancingProvidersResponse]
+        def list(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["status"] = params[:status] if params.key?(:status)
+          query_params["first"] = params[:first] if params.key?(:first)
+          query_params["after"] = params[:after] if params.key?(:after)
+          query_params["last"] = params[:last] if params.key?(:last)
+          query_params["before"] = params[:before] if params.key?(:before)
+
+          Whop_sdk::Internal::CursorItemIterator.new(
+            cursor_field: :end_cursor,
+            item_field: :data,
+            initial_cursor: query_params["after"]
+          ) do |next_cursor|
+            query_params["after"] = next_cursor
+            request = Whop_sdk::Internal::JSON::Request.new(
+              base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+              method: "GET",
+              path: "accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/financing_providers",
+              query: query_params,
+              request_options: request_options
+            )
+            begin
+              response = @client.send(request)
+            rescue Net::HTTPRequestTimeout
+              raise Whop_sdk::Errors::TimeoutError
+            end
+            code = response.code.to_i
+            if code.between?(200, 299)
+              parsed_response = (response.body.to_s.empty? ? nil : Whop_sdk::Accounts::FinancingProviders::Types::ListFinancingProvidersResponse.load(response.body))
+              [parsed_response, response]
+            else
+              error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+              raise error_class.new(response.body, code: code)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/financing_providers/types/list_financing_providers_request.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module FinancingProviders
+      module Types
+        class ListFinancingProvidersRequest < Internal::Types::Model
+          field :account_id, -> { String }, optional: false, nullable: false
+
+          field :status, -> { Whop_sdk::Accounts::FinancingProviders::Types::ListFinancingProvidersRequestStatus }, optional: true, nullable: false
+
+          field :first, -> { Integer }, optional: true, nullable: false
+
+          field :after, -> { String }, optional: true, nullable: false
+
+          field :last, -> { Integer }, optional: true, nullable: false
+
+          field :before, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/financing_providers/types/list_financing_providers_request_status.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module FinancingProviders
+      module Types
+        module ListFinancingProvidersRequestStatus
+          extend Whop_sdk::Internal::Types::Enum
+
+          ELIGIBLE = "eligible"
+          NEEDS_ACTION = "needs_action"
+          IN_REVIEW = "in_review"
+          ACTIVE = "active"
+          INACTIVE = "inactive"
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/financing_providers/types/list_financing_providers_response.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module FinancingProviders
+      module Types
+        class ListFinancingProvidersResponse < Internal::Types::Model
+          field :data, -> { Internal::Types::Array[Whop_sdk::Types::FinancingProvider] }, optional: false, nullable: false
+
+          field :page_info, -> { Whop_sdk::Accounts::FinancingProviders::Types::ListFinancingProvidersResponsePageInfo }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/{financing_applications/types/list_financing_applications_response_page_info.rb → financing_providers/types/list_financing_providers_response_page_info.rb}

@@ -2,9 +2,9 @@
 
 module Whop_sdk
   module Accounts
-    module FinancingApplications
+    module FinancingProviders
       module Types
-        class ListFinancingApplicationsResponsePageInfo < Internal::Types::Model
+        class ListFinancingProvidersResponsePageInfo < Internal::Types::Model
           field :end_cursor, -> { String }, optional: false, nullable: true
 
           field :has_next_page, -> { Internal::Types::Boolean }, optional: false, nullable: false

data/lib/whop_sdk/accounts/preferences/client.rb

@@ -61,10 +61,11 @@ module Whop_sdk
         # | --- | --- |
         # | `ads_payment_methods`, `ads_reporting_currency`, `ads_scheduling_timezone`, `ads_triple_whale_integration`,
         # `ads_certifications` | `ad_campaign:create` |
-        # | `cards_auto_top_up`, `cards_notifications` | `payout:account:update` |
+        # | `cards_auto_top_up`, `cards_notifications`, `covers_connected_account_negative_balances` |
+        # `payout:account:update` |
         # | `dispute_fighter_enabled` | `payment:dispute` |
         # | `economic_intelligence_duration_key`, `economic_intelligence_auto_renew` | `company:update` |
-        # | `feedback_options` | `company:manage_checkout` |
+        # | `feedback_options`, `customer_tracking` | `company:manage_checkout` |
         #
         # When updating preferences from multiple rows, all corresponding scopes are required for the account.
         #

data/lib/whop_sdk/accounts/preferences/types/retrieve_preferences_response.rb

@@ -21,6 +21,10 @@ module Whop_sdk
 
           field :cards_notifications, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
+          field :covers_connected_account_negative_balances, -> { Internal::Types::Boolean }, optional: false, nullable: true
+
+          field :customer_tracking, -> { Whop_sdk::Types::CustomerTrackingPreferences }, optional: false, nullable: true
+
           field :dispute_fighter_enabled, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
           field :economic_intelligence, -> { Internal::Types::Boolean }, optional: false, nullable: false

data/lib/whop_sdk/accounts/preferences/types/update_preferences_request.rb

@@ -21,6 +21,10 @@ module Whop_sdk
 
           field :cards_notifications, -> { Internal::Types::Boolean }, optional: true, nullable: false
 
+          field :covers_connected_account_negative_balances, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+          field :customer_tracking, -> { Whop_sdk::Accounts::Preferences::Types::UpdatePreferencesRequestCustomerTracking }, optional: true, nullable: false
+
           field :dispute_fighter_enabled, -> { Internal::Types::Boolean }, optional: true, nullable: false
 
           field :economic_intelligence_auto_renew, -> { Internal::Types::Boolean }, optional: true, nullable: false

data/lib/whop_sdk/accounts/preferences/types/update_preferences_request_customer_tracking.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Accounts
+    module Preferences
+      module Types
+        # Customer tracking settings for the hosted tracking page and Element, replaced as a whole: fields left out are
+        # saved as unset. Pass null to clear them, which turns tracking off. Tracking is off unless `enabled` is `true`.
+        # Requires the `company:manage_checkout` scope on your API key.
+        class UpdatePreferencesRequestCustomerTracking < Internal::Types::Model
+          field :accent_color, -> { String }, optional: true, nullable: false
+
+          field :enabled, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+          field :show_business_name, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+          field :show_logo, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+          field :support_email, -> { String }, optional: true, nullable: false
+
+          field :support_url, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/accounts/preferences/types/update_preferences_response.rb

@@ -21,6 +21,10 @@ module Whop_sdk
 
           field :cards_notifications, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
+          field :covers_connected_account_negative_balances, -> { Internal::Types::Boolean }, optional: false, nullable: true
+
+          field :customer_tracking, -> { Whop_sdk::Types::CustomerTrackingPreferences }, optional: false, nullable: true
+
           field :dispute_fighter_enabled, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
           field :economic_intelligence, -> { Internal::Types::Boolean }, optional: false, nullable: false

data/lib/whop_sdk/accounts/types/transfer_ownership_accounts_request.rb

@@ -12,6 +12,8 @@ module Whop_sdk
 
         field :identifier, -> { String }, optional: false, nullable: false
 
+        field :member_id, -> { String }, optional: true, nullable: false
+
         field :message, -> { String }, optional: true, nullable: false
       end
     end

data/lib/whop_sdk/ad_campaigns/client.rb

@@ -107,7 +107,7 @@ module Whop_sdk
       # @example
       #   client.ad_campaigns.create(
       #     objective: "awareness",
-      #     platform: "meta",
+      #     platform: "whop",
       #     title: "Now hiring mobile detailers — Austin"
       #   )
       #
@@ -221,7 +221,7 @@ module Whop_sdk
       end
 
       # Updates an ad campaign's settings, or launches a draft campaign by setting `status` to `active`. The objective
-      # and desired cost per result are fixed at creation and cannot be changed.
+      # is fixed at creation and cannot be changed.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::AdCampaigns::Types::UpdateAdCampaignsRequest]

data/lib/whop_sdk/ad_campaigns/types/create_ad_campaigns_request_platform.rb

@@ -6,7 +6,7 @@ module Whop_sdk
       module CreateAdCampaignsRequestPlatform
         extend Whop_sdk::Internal::Types::Enum
 
-        META = "meta"
+        WHOP = "whop"
       end
     end
   end

data/lib/whop_sdk/ad_campaigns/types/post_ad_campaign_payment_failed_payload_data_delivery_status.rb

@@ -13,6 +13,7 @@ module Whop_sdk
         NO_AD_GROUPS = "no_ad_groups"
         NO_ADS = "no_ads"
         PAUSED = "paused"
+        IN_REVIEW = "in_review"
         LEARNING = "learning"
         PROCESSING = "processing"
         ISSUES = "issues"

data/lib/whop_sdk/ad_campaigns/types/post_ad_campaign_updated_payload_data_delivery_status.rb

@@ -13,6 +13,7 @@ module Whop_sdk
         NO_AD_GROUPS = "no_ad_groups"
         NO_ADS = "no_ads"
         PAUSED = "paused"
+        IN_REVIEW = "in_review"
         LEARNING = "learning"
         PROCESSING = "processing"
         ISSUES = "issues"

data/lib/whop_sdk/ad_campaigns/types/update_ad_campaigns_request.rb

@@ -20,6 +20,8 @@ module Whop_sdk
 
         field :campaign_type, -> { Whop_sdk::AdCampaigns::Types::UpdateAdCampaignsRequestCampaignType }, optional: true, nullable: false
 
+        field :desired_cost_per_result, -> { Integer }, optional: true, nullable: false
+
         field :ends_at, -> { String }, optional: true, nullable: false
 
         field :special_ad_categories, -> { Internal::Types::Array[Whop_sdk::AdCampaigns::Types::UpdateAdCampaignsRequestSpecialAdCategoriesItem] }, optional: true, nullable: false

data/lib/whop_sdk/ad_pixels/client.rb

@@ -77,7 +77,9 @@ module Whop_sdk
 
       # Add your pixel for a business whose campaigns you claimed. Whop checks the access token with the ad platform,
       # then sends the pixel the conversions credited to your claimed campaigns for that business. Each business takes
-      # one pixel, and each pixel can serve one business.
+      # one pixel per ad platform, and each pixel can serve one business. On Google, the pixel is your Google Ads
+      # account, which can serve several businesses, and Whop creates its conversion actions there with your service
+      # account key.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::AdPixels::Types::CreateAdPixelsRequest]

data/lib/whop_sdk/ad_pixels/types/create_ad_pixels_request_platform.rb

@@ -7,6 +7,8 @@ module Whop_sdk
         extend Whop_sdk::Internal::Types::Enum
 
         META = "meta"
+        TIKTOK = "tiktok"
+        GOOGLE = "google"
       end
     end
   end

data/lib/whop_sdk/ads/client.rb

@@ -14,6 +14,54 @@ module Whop_sdk
         @environment = environment
       end
 
+      # Records a runner's stats for one of their ads in one hour, and pays them for the spend. Send the ad's totals so
+      # far for an hour that started in the last 24 hours; they replace what the ad held for that hour, and its ad
+      # group's and campaign's hours are rebuilt from their ads. The spend can go up but never down. Reporting on a
+      # campaign starts with the hour of its first recorded report; earlier hours are refused. Spend over what is left
+      # of a budget (the runner's share of the day, the campaign's daily budget or the ad group's budget) is refused
+      # with the most the ad can record. Takes the runner's Whop session or a user OAuth token with
+      # `ad_campaign:update`. A token without that scope gets a 403, and anyone not holding the ad's campaign gets a
+      # 404.
+      #
+      # @param request_options [Hash]
+      # @param params [Whop_sdk::Ads::Types::ReportStatsAdsRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @example
+      #   client.ads.report_stats(
+      #     ad_id: "ad_xxxxxxxxxxxxxx",
+      #     hour_started_at: "2026-01-01T12:00:00Z",
+      #     spend: 1.1
+      #   )
+      #
+      # @return [Whop_sdk::Types::AdStat]
+      def report_stats(request_options: {}, **params)
+        params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+        request = Whop_sdk::Internal::JSON::Request.new(
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+          method: "POST",
+          path: "ad_stats",
+          body: Whop_sdk::Ads::Types::ReportStatsAdsRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Whop_sdk::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::AdStat.load(response.body))
+        else
+          error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Lists the ads for an account, with stats over the requested window.
       #
       # @param request_options [Hash]