whop_sdk 2.5.0 → 2.7.0

data/lib/whop_sdk/partners/businesses/types/resend_invite_businesses_response_status.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        module ResendInviteBusinessesResponseStatus
+          extend Whop_sdk::Internal::Types::Enum
+
+          ACTIVE = "active"
+          REMOVED = "removed"
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/businesses/types/resend_invite_businesses_response_volume_usd.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        class ResendInviteBusinessesResponseVolumeUsd < Internal::Types::Model
+          field :attributed, -> { String }, optional: false, nullable: false
+
+          field :awaiting_settlement, -> { String }, optional: false, nullable: false
+
+          field :last30d, -> { String }, optional: false, nullable: false, api_name: "last_30d"
+
+          field :settled, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/businesses/types/retrieve_businesses_response.rb

@@ -11,8 +11,14 @@ module Whop_sdk
 
           field :commission_advance, -> { Whop_sdk::Types::PartnerAdvance }, optional: true, nullable: false
 
+          field :commission_advance_projections_allowed, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+          field :commission_advance_rate, -> { String }, optional: true, nullable: false
+
           field :created_at, -> { String }, optional: false, nullable: false
 
+          field :deal_closed_reason, -> { String }, optional: false, nullable: true
+
           field :earnings_usd, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponseEarningsUsd }, optional: false, nullable: false
 
           field :first_tier_partner, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponseFirstTierPartner }, optional: false, nullable: true
@@ -27,10 +33,14 @@ module Whop_sdk
 
           field :payout_percentages, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponsePayoutPercentages }, optional: false, nullable: false
 
+          field :pending_owner_invites, -> { Internal::Types::Array[Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponsePendingOwnerInvitesItem] }, optional: true, nullable: false
+
           field :referral_expires_at, -> { String }, optional: false, nullable: true
 
           field :referral_started_at, -> { String }, optional: false, nullable: true
 
+          field :referring_business, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponseReferringBusiness }, optional: true, nullable: false
+
           field :second_tier_partner, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponseSecondTierPartner }, optional: false, nullable: true
 
           field :status, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponseStatus }, optional: false, nullable: false

data/lib/whop_sdk/partners/businesses/types/retrieve_businesses_response_pending_owner_invites_item.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        class RetrieveBusinessesResponsePendingOwnerInvitesItem < Internal::Types::Model
+          field :email, -> { String }, optional: false, nullable: false
+
+          field :id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/businesses/types/retrieve_businesses_response_referring_business.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        # The partner business whose team member made this referral, the one its commission is paid to. Null for a solo
+        # partner's referral.
+        class RetrieveBusinessesResponseReferringBusiness < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :logo_url, -> { String }, optional: false, nullable: true
+
+          field :route, -> { String }, optional: false, nullable: false
+
+          field :title, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/businesses/types/update_businesses_request.rb

@@ -7,9 +7,11 @@ module Whop_sdk
         class UpdateBusinessesRequest < Internal::Types::Model
           field :id, -> { String }, optional: false, nullable: false
 
-          field :annual_ads_usd, -> { String }, optional: false, nullable: false
+          field :annual_processing_usd, -> { String }, optional: true, nullable: false
 
-          field :annual_processing_usd, -> { String }, optional: false, nullable: false
+          field :deal_closed_reason, -> { String }, optional: true, nullable: false
+
+          field :withdraw_projections, -> { Internal::Types::Boolean }, optional: true, nullable: false
         end
       end
     end

data/lib/whop_sdk/partners/client.rb

@@ -50,6 +50,44 @@ module Whop_sdk
         end
       end
 
+      # Lists, per income stream, the fee a business the caller refers would be charged, how low the caller may price
+      # it, and the commission the caller earns on that stream. Answers for a referral that does not exist yet, so a
+      # referral flow can price the deal before the business is created. Requires `partner:fees:update`, since the
+      # floors a partner may price down to are only for a credential that can set them.
+      #
+      # @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
+      #
+      # @example
+      #   client.partners.fee_options
+      #
+      # @return [Whop_sdk::Partners::Types::FeeOptionsPartnersResponse]
+      def fee_options(request_options: {}, **_params)
+        request = Whop_sdk::Internal::JSON::Request.new(
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+          method: "GET",
+          path: "partners/fee_options",
+          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::Partners::Types::FeeOptionsPartnersResponse.load(response.body))
+        else
+          error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Ranks referrers by partner business earnings over the chosen `period`, all-time by default. Authentication is
       # optional: authenticated callers also get their own standing, anonymous callers get the rankings alone.
       #

data/lib/whop_sdk/partners/types/fee_options_partners_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Types
+      class FeeOptionsPartnersResponse < Internal::Types::Model
+        field :object, -> { Whop_sdk::Partners::Types::FeeOptionsPartnersResponseObject }, optional: false, nullable: false
+
+        field :streams, -> { Internal::Types::Array[Whop_sdk::Partners::Types::FeeOptionsPartnersResponseStreamsItem] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/types/fee_options_partners_response_object.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Types
+      module FeeOptionsPartnersResponseObject
+        extend Whop_sdk::Internal::Types::Enum
+
+        PARTNER_FEE_OPTIONS = "partner_fee_options"
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/types/fee_options_partners_response_streams_item.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Types
+      class FeeOptionsPartnersResponseStreamsItem < Internal::Types::Model
+        field :adjustable, -> { Internal::Types::Boolean }, optional: false, nullable: false
+
+        field :commission_percentage, -> { Integer }, optional: false, nullable: true
+
+        field :fee, -> { Whop_sdk::Partners::Types::FeeOptionsPartnersResponseStreamsItemFee }, optional: false, nullable: true
+
+        field :income_stream, -> { Whop_sdk::Partners::Types::FeeOptionsPartnersResponseStreamsItemIncomeStream }, optional: false, nullable: false
+
+        field :unadjustable_reason, -> { Whop_sdk::Partners::Types::FeeOptionsPartnersResponseStreamsItemUnadjustableReason }, optional: false, nullable: true
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/types/fee_options_partners_response_streams_item_fee.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Types
+      # The merchant fee behind this stream, or null when the business is charged nothing on it.
+      class FeeOptionsPartnersResponseStreamsItemFee < Internal::Types::Model
+        field :minimum_percentage, -> { Integer }, optional: false, nullable: false
+
+        field :percentage, -> { Integer }, optional: false, nullable: false
+
+        field :reference_region, -> { String }, optional: false, nullable: true
+
+        field :regions, -> { Internal::Types::Array[Whop_sdk::Partners::Types::FeeOptionsPartnersResponseStreamsItemFeeRegionsItem] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/types/fee_options_partners_response_streams_item_fee_regions_item.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Types
+      class FeeOptionsPartnersResponseStreamsItemFeeRegionsItem < Internal::Types::Model
+        field :minimum_percentage, -> { Integer }, optional: false, nullable: false
+
+        field :percentage, -> { Integer }, optional: false, nullable: false
+
+        field :region, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/types/fee_options_partners_response_streams_item_income_stream.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Types
+      module FeeOptionsPartnersResponseStreamsItemIncomeStream
+        extend Whop_sdk::Internal::Types::Enum
+
+        SALES = "sales"
+        TRANSFER = "transfer"
+        CARD_INTERCHANGE = "card_interchange"
+        AD_SPEND = "ad_spend"
+        WITHDRAWAL = "withdrawal"
+        ONBOARDING_REWARD = "onboarding_reward"
+        PARTNER_REWARD = "partner_reward"
+        VERIFIED_PARTNER_REFERRAL_PAYBACK = "verified_partner_referral_payback"
+      end
+    end
+  end
+end

data/lib/whop_sdk/partners/types/fee_options_partners_response_streams_item_unadjustable_reason.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Types
+      module FeeOptionsPartnersResponseStreamsItemUnadjustableReason
+        extend Whop_sdk::Internal::Types::Enum
+
+        NO_MERCHANT_FEE = "no_merchant_fee"
+        COMMISSION_FIXED = "commission_fixed"
+        NO_HEADROOM = "no_headroom"
+        FEE_UNAVAILABLE = "fee_unavailable"
+      end
+    end
+  end
+end

data/lib/whop_sdk/payment_method_domains/client.rb

@@ -14,7 +14,8 @@ module Whop_sdk
         @environment = environment
       end
 
-      # Lists the payment method domains registered for your account and its connected accounts.
+      # Lists the payment method domains registered for your account and its connected accounts. Deprecated: list
+      # domains with `GET /domains` and the `apple_pay` filter instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -88,7 +89,8 @@ module Whop_sdk
       # Registers a hostname with the wallet provider and attempts verification inline. Returns `verified` when the
       # provider fetched the domain-association file (for Apple Pay,
       # `/.well-known/apple-developer-merchantid-domain-association`), or `pending` when it could not: host the file,
-      # then retry with `POST /payment_method_domains/:id/verify`.
+      # then retry with `POST /payment_method_domains/:id/verify`. Deprecated: add Apple Pay with `POST /domains` and
+      # `apple_pay: {}` instead.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::PaymentMethodDomains::Types::CreatePaymentMethodDomainsRequest]
@@ -125,7 +127,8 @@ module Whop_sdk
         end
       end
 
-      # Retrieves a payment method domain to check its verification status.
+      # Retrieves a payment method domain to check its verification status. Deprecated: retrieve the domain with `GET
+      # /domains/{id}` instead, using the same ID.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -162,7 +165,9 @@ module Whop_sdk
         end
       end
 
-      # Unregisters a payment method domain so its wallet payment methods stop rendering there.
+      # Unregisters a payment method domain so its wallet payment methods stop rendering there. Deprecated: remove Apple
+      # Pay with `PATCH /domains/{id}` and `apple_pay: null` instead. `DELETE /domains/{id}` removes the whole domain,
+      # including any website on it.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -200,7 +205,8 @@ module Whop_sdk
       end
 
       # Re-attempts provider verification of a pending domain once the association file is hosted. Fails with a
-      # `bad_request` explaining what to fix; verifying an already `verified` domain is a no-op.
+      # `bad_request` explaining what to fix; verifying an already `verified` domain is a no-op. Deprecated: check the
+      # domain with `POST /domains/{id}/check` instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]

data/lib/whop_sdk/payment_quotes/client.rb

@@ -19,7 +19,7 @@ module Whop_sdk
       # from exactly what you send: no buyer is looked up, so no stored registration or purchase history applies. Pass
       # the quote's `id` as `quote_id` when you create the payment to charge exactly the purchase, promo code, and tax
       # shown here. A quote is priced once and may be consumed by one payment before `expires_at`. Cart entries must
-      # name existing variants with `plan_id`.
+      # name existing variants with `variant_id`.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequest]

data/lib/whop_sdk/payment_quotes/types/create_payment_quotes_request.rb

@@ -20,13 +20,13 @@ module Whop_sdk
 
         field :account_id, -> { String }, optional: false, nullable: false
 
-        field :plan, -> { Whop_sdk::Types::PaymentInputPlan }, optional: true, nullable: false
-
-        field :plan_id, -> { String }, optional: true, nullable: false
-
         field :promo_code, -> { String }, optional: true, nullable: false
 
         field :promo_code_id, -> { String }, optional: true, nullable: false
+
+        field :variant, -> { Whop_sdk::Types::PaymentInputVariant }, optional: true, nullable: false
+
+        field :variant_id, -> { String }, optional: true, nullable: false
       end
     end
   end

data/lib/whop_sdk/payment_quotes/types/create_payment_quotes_request_line_items_item.rb

@@ -4,9 +4,9 @@ module Whop_sdk
   module PaymentQuotes
     module Types
       class CreatePaymentQuotesRequestLineItemsItem < Internal::Types::Model
-        field :plan_id, -> { String }, optional: false, nullable: false
-
         field :quantity, -> { Integer }, optional: true, nullable: false
+
+        field :variant_id, -> { String }, optional: false, nullable: false
       end
     end
   end

data/lib/whop_sdk/payment_rules/types/create_payment_rules_request_conditions_all_item_field.rb

@@ -9,9 +9,16 @@ module Whop_sdk
         RISK_SCORE = "risk_score"
         AMOUNT_IN_USD = "amount_in_usd"
         CARD_COUNTRY = "card_country"
+        CARD_BRAND = "card_brand"
+        CARD_FUNDING = "card_funding"
         CARD_BIN = "card_bin"
+        BILLING_COUNTRY = "billing_country"
+        BILLING_POSTAL_CODE = "billing_postal_code"
+        BILLING_CITY = "billing_city"
         CUSTOMER_EMAIL = "customer_email"
+        EMAIL_DOMAIN = "email_domain"
         IP_ADDRESS = "ip_address"
+        IP_COUNTRY = "ip_country"
       end
     end
   end

data/lib/whop_sdk/payment_rules/types/replace_payment_rules_request_conditions_all_item_field.rb

@@ -9,9 +9,16 @@ module Whop_sdk
         RISK_SCORE = "risk_score"
         AMOUNT_IN_USD = "amount_in_usd"
         CARD_COUNTRY = "card_country"
+        CARD_BRAND = "card_brand"
+        CARD_FUNDING = "card_funding"
         CARD_BIN = "card_bin"
+        BILLING_COUNTRY = "billing_country"
+        BILLING_POSTAL_CODE = "billing_postal_code"
+        BILLING_CITY = "billing_city"
         CUSTOMER_EMAIL = "customer_email"
+        EMAIL_DOMAIN = "email_domain"
         IP_ADDRESS = "ip_address"
+        IP_COUNTRY = "ip_country"
       end
     end
   end

data/lib/whop_sdk/payments/client.rb

@@ -28,16 +28,32 @@ module Whop_sdk
       # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestMode, nil] :mode
       # @option params [String, nil] :account_id
       # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestStatus, nil] :status
+      # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestTrackingStatus, nil] :tracking_status
       # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestBillingReason, nil] :billing_reason
       # @option params [String, nil] :currency
       # @option params [String, nil] :user_id
       # @option params [String, nil] :query
+      # @option params [Boolean, nil] :include_connected_accounts
       # @option params [String, nil] :member_id
       # @option params [String, nil] :membership_id
       # @option params [String, nil] :product_id
-      # @option params [String, nil] :plan_id
+      # @option params [String, nil] :variant_id
       # @option params [String, nil] :created_before
       # @option params [String, nil] :created_after
+      # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestStatusesItem, nil] :statuses
+      # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestSubstatusesItem, nil] :substatuses
+      # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestBillingReasonsItem, nil] :billing_reasons
+      # @option params [String, nil] :currencies
+      # @option params [String, nil] :variant_ids
+      # @option params [String, nil] :product_ids
+      # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestPaymentMethodsItem, nil] :payment_methods
+      # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestTrackingStatesItem, nil] :tracking_states
+      # @option params [String, nil] :refunded_after
+      # @option params [String, nil] :refunded_before
+      # @option params [String, nil] :dispute_alerted_after
+      # @option params [String, nil] :dispute_alerted_before
+      # @option params [String, nil] :dispute_created_after
+      # @option params [String, nil] :dispute_created_before
       # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestOrder, nil] :order
       # @option params [Whop_sdk::Payments::Types::ListPaymentsRequestDirection, nil] :direction
       # @option params [Integer, nil] :first
@@ -46,7 +62,11 @@ module Whop_sdk
       # @option params [String, nil] :before
       #
       # @example
-      #   client.payments.list
+      #   client.payments.list(
+      #     currencies: ["eur"],
+      #     variant_ids: ["plan_xxxxxxxxxxxxx"],
+      #     product_ids: ["prod_xxxxxxxxxxxxx"]
+      #   )
       #
       # @return [Whop_sdk::Payments::Types::ListPaymentsResponse]
       def list(request_options: {}, **params)
@@ -55,16 +75,32 @@ module Whop_sdk
         query_params["mode"] = params[:mode] if params.key?(:mode)
         query_params["account_id"] = params[:account_id] if params.key?(:account_id)
         query_params["status"] = params[:status] if params.key?(:status)
+        query_params["tracking_status"] = params[:tracking_status] if params.key?(:tracking_status)
         query_params["billing_reason"] = params[:billing_reason] if params.key?(:billing_reason)
         query_params["currency"] = params[:currency] if params.key?(:currency)
         query_params["user_id"] = params[:user_id] if params.key?(:user_id)
         query_params["query"] = params[:query] if params.key?(:query)
+        query_params["include_connected_accounts"] = params[:include_connected_accounts] if params.key?(:include_connected_accounts)
         query_params["member_id"] = params[:member_id] if params.key?(:member_id)
         query_params["membership_id"] = params[:membership_id] if params.key?(:membership_id)
         query_params["product_id"] = params[:product_id] if params.key?(:product_id)
-        query_params["plan_id"] = params[:plan_id] if params.key?(:plan_id)
+        query_params["variant_id"] = params[:variant_id] if params.key?(:variant_id)
         query_params["created_before"] = params[:created_before] if params.key?(:created_before)
         query_params["created_after"] = params[:created_after] if params.key?(:created_after)
+        query_params["statuses"] = params[:statuses] if params.key?(:statuses)
+        query_params["substatuses"] = params[:substatuses] if params.key?(:substatuses)
+        query_params["billing_reasons"] = params[:billing_reasons] if params.key?(:billing_reasons)
+        query_params["currencies"] = params[:currencies] if params.key?(:currencies)
+        query_params["variant_ids"] = params[:variant_ids] if params.key?(:variant_ids)
+        query_params["product_ids"] = params[:product_ids] if params.key?(:product_ids)
+        query_params["payment_methods"] = params[:payment_methods] if params.key?(:payment_methods)
+        query_params["tracking_states"] = params[:tracking_states] if params.key?(:tracking_states)
+        query_params["refunded_after"] = params[:refunded_after] if params.key?(:refunded_after)
+        query_params["refunded_before"] = params[:refunded_before] if params.key?(:refunded_before)
+        query_params["dispute_alerted_after"] = params[:dispute_alerted_after] if params.key?(:dispute_alerted_after)
+        query_params["dispute_alerted_before"] = params[:dispute_alerted_before] if params.key?(:dispute_alerted_before)
+        query_params["dispute_created_after"] = params[:dispute_created_after] if params.key?(:dispute_created_after)
+        query_params["dispute_created_before"] = params[:dispute_created_before] if params.key?(:dispute_created_before)
         query_params["order"] = params[:order] if params.key?(:order)
         query_params["direction"] = params[:direction] if params.key?(:direction)
         query_params["first"] = params[:first] if params.key?(:first)
@@ -141,6 +177,90 @@ module Whop_sdk
         end
       end
 
+      # Totals up the same payments the list returns, so you can build status tabs and filter options without paging
+      # through them. Takes the same filters as List Payments.
+      #
+      # @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 [Whop_sdk::Payments::Types::SummaryPaymentsRequestGroupsItem, nil] :groups
+      # @option params [String, nil] :account_id
+      # @option params [Whop_sdk::Payments::Types::SummaryPaymentsRequestStatusesItem, nil] :statuses
+      # @option params [Whop_sdk::Payments::Types::SummaryPaymentsRequestSubstatusesItem, nil] :substatuses
+      # @option params [Whop_sdk::Payments::Types::SummaryPaymentsRequestBillingReasonsItem, nil] :billing_reasons
+      # @option params [String, nil] :currencies
+      # @option params [String, nil] :variant_ids
+      # @option params [String, nil] :product_ids
+      # @option params [Whop_sdk::Payments::Types::SummaryPaymentsRequestPaymentMethodsItem, nil] :payment_methods
+      # @option params [Whop_sdk::Payments::Types::SummaryPaymentsRequestTrackingStatesItem, nil] :tracking_states
+      # @option params [String, nil] :created_after
+      # @option params [String, nil] :created_before
+      # @option params [String, nil] :refunded_after
+      # @option params [String, nil] :refunded_before
+      # @option params [String, nil] :dispute_alerted_after
+      # @option params [String, nil] :dispute_alerted_before
+      # @option params [String, nil] :dispute_created_after
+      # @option params [String, nil] :dispute_created_before
+      # @option params [String, nil] :query
+      # @option params [Boolean, nil] :include_connected_accounts
+      #
+      # @example
+      #   client.payments.summary(
+      #     currencies: ["usd"],
+      #     variant_ids: ["plan_xxxxxxxxxxxxx"],
+      #     product_ids: ["prod_xxxxxxxxxxxxx"]
+      #   )
+      #
+      # @return [Whop_sdk::Payments::Types::SummaryPaymentsResponse]
+      def summary(request_options: {}, **params)
+        params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["groups"] = params[:groups] if params.key?(:groups)
+        query_params["account_id"] = params[:account_id] if params.key?(:account_id)
+        query_params["statuses"] = params[:statuses] if params.key?(:statuses)
+        query_params["substatuses"] = params[:substatuses] if params.key?(:substatuses)
+        query_params["billing_reasons"] = params[:billing_reasons] if params.key?(:billing_reasons)
+        query_params["currencies"] = params[:currencies] if params.key?(:currencies)
+        query_params["variant_ids"] = params[:variant_ids] if params.key?(:variant_ids)
+        query_params["product_ids"] = params[:product_ids] if params.key?(:product_ids)
+        query_params["payment_methods"] = params[:payment_methods] if params.key?(:payment_methods)
+        query_params["tracking_states"] = params[:tracking_states] if params.key?(:tracking_states)
+        query_params["created_after"] = params[:created_after] if params.key?(:created_after)
+        query_params["created_before"] = params[:created_before] if params.key?(:created_before)
+        query_params["refunded_after"] = params[:refunded_after] if params.key?(:refunded_after)
+        query_params["refunded_before"] = params[:refunded_before] if params.key?(:refunded_before)
+        query_params["dispute_alerted_after"] = params[:dispute_alerted_after] if params.key?(:dispute_alerted_after)
+        query_params["dispute_alerted_before"] = params[:dispute_alerted_before] if params.key?(:dispute_alerted_before)
+        query_params["dispute_created_after"] = params[:dispute_created_after] if params.key?(:dispute_created_after)
+        query_params["dispute_created_before"] = params[:dispute_created_before] if params.key?(:dispute_created_before)
+        query_params["query"] = params[:query] if params.key?(:query)
+        query_params["include_connected_accounts"] = params[:include_connected_accounts] if params.key?(:include_connected_accounts)
+
+        request = Whop_sdk::Internal::JSON::Request.new(
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+          method: "GET",
+          path: "payments/summary",
+          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)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Payments::Types::SummaryPaymentsResponse.load(response.body))
+        else
+          error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Returns one payment, including every purchased line item with its quantity and subtotal. Related records are ids
       # — resolve a variant, membership, member or shipment on its own endpoint, and list this payment's refunds,
       # disputes or Resolution Center cases with `?payment_id=`.
@@ -463,8 +583,8 @@ module Whop_sdk
       # Charges the saved card again, with the buyer present, for a payment their bank declined until they authenticate
       # (such as with 3DS). Retrieve the payment afterward to get the bank's challenge from `next_action`; once the
       # buyer completes it, they land on `return_url`, or on Whop's hosted verification page if none was given. Only the
-      # buyer can call this, with the payment's `client_secret`, an OAuth token for their own account with the
-      # `member:payment_methods:use` scope, or the token from a verified `payment` session intent. An API key gets a
+      # buyer can call this, with the payment's `client_secret` in the body, an OAuth token for their own account with
+      # the `member:payment_methods:use` scope, or the token from a verified `payment` session intent. An API key gets a
       # `403`. Has no effect on a payment that is not waiting on authentication.
       #
       # @param request_options [Hash]
@@ -508,7 +628,8 @@ module Whop_sdk
       end
 
       # Changes where the buyer lands after completing an off-site step, up until they return. Accepts either a secret
-      # key or the payment's own `client_secret`, so the surface that knows the final destination can set it.
+      # key or the payment's own `client_secret` in the body, so the surface that knows the final destination can set
+      # it.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::Payments::Types::UpdateReturnURLPaymentsRequest]
@@ -555,7 +676,7 @@ module Whop_sdk
 
       # Retrieves how far a payment has got and what the buyer must do next, if anything. A payment is collected in the
       # background, so poll this rather than reading the create response. Accepts either a secret key or the payment's
-      # own `client_secret`, so the surface collecting the payment can poll it directly.
+      # own `client_secret` as a query parameter, so the surface collecting the payment can poll it directly.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -565,6 +686,7 @@ module Whop_sdk
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :payment_id
+      # @option params [String, nil] :client_secret
       #
       # @example
       #   client.payments.retrieve_status(payment_id: "payment_id")
@@ -572,10 +694,14 @@ module Whop_sdk
       # @return [Whop_sdk::Types::PaymentStatus]
       def retrieve_status(request_options: {}, **params)
         params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["client_secret"] = params[:client_secret] if params.key?(:client_secret)
+
         request = Whop_sdk::Internal::JSON::Request.new(
           base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "GET",
           path: "payments/#{URI.encode_uri_component(params[:payment_id].to_s)}/status",
+          query: query_params,
           request_options: request_options
         )
         begin