whop_sdk 2.3.0 → 2.5.0

data/lib/whop_sdk/partners/businesses/client.rb

@@ -25,6 +25,7 @@ module Whop_sdk
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String, nil] :referring_account_id
+        # @option params [Whop_sdk::Partners::Businesses::Types::ListBusinessesRequestAdvanceStatus, nil] :advance_status
         # @option params [Whop_sdk::Partners::Businesses::Types::ListBusinessesRequestStatus, nil] :status
         # @option params [Boolean, nil] :has_earnings
         # @option params [Integer, nil] :first
@@ -48,6 +49,7 @@ module Whop_sdk
           params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
           query_params = {}
           query_params["referring_account_id"] = params[:referring_account_id] if params.key?(:referring_account_id)
+          query_params["advance_status"] = params[:advance_status] if params.key?(:advance_status)
           query_params["status"] = params[:status] if params.key?(:status)
           query_params["has_earnings"] = params[:has_earnings] if params.key?(:has_earnings)
           query_params["first"] = params[:first] if params.key?(:first)
@@ -129,6 +131,103 @@ module Whop_sdk
           end
         end
 
+        # Save annual projections for a business referred by the authenticated partner. Projections cannot be changed
+        # after saving; repeating the same values is allowed. Public API access requires a partner OAuth token; business
+        # API keys are not supported.
+        #
+        # @param request_options [Hash]
+        # @param params [Whop_sdk::Partners::Businesses::Types::UpdateBusinessesRequest]
+        # @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] :id
+        #
+        # @example
+        #   client.partners.businesses.update(
+        #     id: "id",
+        #     annual_ads_usd: "120000",
+        #     annual_processing_usd: "1200000"
+        #   )
+        #
+        # @return [Whop_sdk::Partners::Businesses::Types::UpdateBusinessesResponse]
+        def update(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          request_data = Whop_sdk::Partners::Businesses::Types::UpdateBusinessesRequest.new(params).to_h
+          non_body_param_names = %w[id]
+          body = request_data.except(*non_body_param_names)
+
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "PATCH",
+            path: "partners/businesses/#{URI.encode_uri_component(params[:id].to_s)}",
+            body: body,
+            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::Businesses::Types::UpdateBusinessesResponse.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Accept the authenticated partner's CPA offer with the reviewed terms and signed offer token. Public API access
+        # requires a partner OAuth token; business API keys are not supported.
+        #
+        # @param request_options [Hash]
+        # @param params [Whop_sdk::Partners::Businesses::Types::AcceptCommissionAdvanceBusinessesRequest]
+        # @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] :id
+        #
+        # @example
+        #   client.partners.businesses.accept_commission_advance(
+        #     id: "id",
+        #     acknowledgments: %w[commission_replacement clawback term],
+        #     expected_amount_usd: "1439.99",
+        #     offer_token: "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        #     terms_version: "2026-01-01"
+        #   )
+        #
+        # @return [Whop_sdk::Partners::Businesses::Types::AcceptCommissionAdvanceBusinessesResponse]
+        def accept_commission_advance(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          request_data = Whop_sdk::Partners::Businesses::Types::AcceptCommissionAdvanceBusinessesRequest.new(params).to_h
+          non_body_param_names = %w[id]
+          body = request_data.except(*non_body_param_names)
+
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "POST",
+            path: "partners/businesses/#{URI.encode_uri_component(params[:id].to_s)}/accept_commission_advance",
+            body: body,
+            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::Businesses::Types::AcceptCommissionAdvanceBusinessesResponse.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
         # @return [Whop_sdk::Earnings::Client]
         def earnings
           @earnings ||= Whop_sdk::Partners::Businesses::Earnings::Client.new(client: @client, base_url: @base_url, environment: @environment)

data/lib/whop_sdk/partners/businesses/earnings/types/list_earnings_request_income_source_item.rb

@@ -16,6 +16,7 @@ module Whop_sdk
             ONBOARDING_REWARD = "onboarding_reward"
             PARTNER_REWARD = "partner_reward"
             VERIFIED_PARTNER_REFERRAL_PAYBACK = "verified_partner_referral_payback"
+            COMMISSION_ADVANCE = "commission_advance"
           end
         end
       end

data/lib/whop_sdk/partners/businesses/earnings/types/list_earnings_response_data_item_income_source.rb

@@ -16,6 +16,7 @@ module Whop_sdk
             ONBOARDING_REWARD = "onboarding_reward"
             PARTNER_REWARD = "partner_reward"
             VERIFIED_PARTNER_REFERRAL_PAYBACK = "verified_partner_referral_payback"
+            COMMISSION_ADVANCE = "commission_advance"
           end
         end
       end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        class AcceptCommissionAdvanceBusinessesRequest < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :acknowledgments, -> { Internal::Types::Array[Whop_sdk::Partners::Businesses::Types::AcceptCommissionAdvanceBusinessesRequestAcknowledgmentsItem] }, optional: false, nullable: false
+
+          field :expected_amount_usd, -> { String }, optional: false, nullable: false
+
+          field :offer_token, -> { String }, optional: false, nullable: false
+
+          field :terms_version, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        module AcceptCommissionAdvanceBusinessesRequestAcknowledgmentsItem
+          extend Whop_sdk::Internal::Types::Enum
+
+          COMMISSION_REPLACEMENT = "commission_replacement"
+          CLAWBACK = "clawback"
+          TERM = "term"
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -7,6 +7,8 @@ module Whop_sdk
         class ListBusinessesRequest < Internal::Types::Model
           field :referring_account_id, -> { String }, optional: true, nullable: false
 
+          field :advance_status, -> { Whop_sdk::Partners::Businesses::Types::ListBusinessesRequestAdvanceStatus }, optional: true, nullable: false
+
           field :status, -> { Whop_sdk::Partners::Businesses::Types::ListBusinessesRequestStatus }, optional: true, nullable: false
 
           field :has_earnings, -> { Internal::Types::Boolean }, optional: true, nullable: false

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        module ListBusinessesRequestAdvanceStatus
+          extend Whop_sdk::Internal::Types::Enum
+
+          PROJECTED = "projected"
+          AVAILABLE = "available"
+          ACCEPTED = "accepted"
+          FUNDED = "funded"
+          CLAWED_BACK = "clawed_back"
+          COMPLETED = "completed"
+          EXPIRED = "expired"
+          OFFERED = "offered"
+        end
+      end
+    end
+  end
+end

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

@@ -9,6 +9,8 @@ module Whop_sdk
 
           field :blueprint_partner, -> { Whop_sdk::Partners::Businesses::Types::ListBusinessesResponseDataItemBlueprintPartner }, optional: false, nullable: true
 
+          field :commission_advance, -> { Whop_sdk::Types::PartnerAdvance }, optional: true, nullable: false
+
           field :created_at, -> { String }, optional: false, nullable: false
 
           field :earnings_usd, -> { Whop_sdk::Partners::Businesses::Types::ListBusinessesResponseDataItemEarningsUsd }, optional: false, nullable: false

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

@@ -9,6 +9,8 @@ module Whop_sdk
 
           field :blueprint_partner, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponseBlueprintPartner }, optional: false, nullable: true
 
+          field :commission_advance, -> { Whop_sdk::Types::PartnerAdvance }, optional: true, nullable: false
+
           field :created_at, -> { String }, optional: false, nullable: false
 
           field :earnings_usd, -> { Whop_sdk::Partners::Businesses::Types::RetrieveBusinessesResponseEarningsUsd }, optional: false, nullable: false

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Partners
+    module Businesses
+      module Types
+        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: false, nullable: false
+        end
+      end
+    end
+  end
+end

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

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

data/lib/whop_sdk/partners/client.rb

@@ -50,9 +50,8 @@ module Whop_sdk
         end
       end
 
-      # Ranks referrers by partner business earnings — all-time by default, or over the current day, month, year, or
-      # trailing 30 days. Authentication is optional: authenticated callers also get their own standing, anonymous
-      # callers get the rankings alone.
+      # 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.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -94,8 +93,7 @@ module Whop_sdk
       end
 
       # Lists the users the caller referred onto Whop, newest first by default, each with the caller's total affiliate
-      # earnings from that user across all tiers. Earnings sorting uses cached totals. Authorized staff can set
-      # user_id=global to list referrals across partners, with earnings for each user's current primary referrer.
+      # earnings from that user across all tiers.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -104,7 +102,6 @@ module Whop_sdk
       # @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::Partners::Types::ReferredUsersPartnersRequestUserID, nil] :user_id
       # @option params [String, nil] :earning_partner_id
       # @option params [String, nil] :earning_partner_username
       # @option params [String, nil] :referring_account_id
@@ -125,7 +122,6 @@ module Whop_sdk
       def referred_users(request_options: {}, **params)
         params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
         query_params = {}
-        query_params["user_id"] = params[:user_id] if params.key?(:user_id)
         query_params["earning_partner_id"] = params[:earning_partner_id] if params.key?(:earning_partner_id)
         query_params["earning_partner_username"] = params[:earning_partner_username] if params.key?(:earning_partner_username)
         query_params["referring_account_id"] = params[:referring_account_id] if params.key?(:referring_account_id)
@@ -168,10 +164,9 @@ module Whop_sdk
         end
       end
 
-      # Retrieves the authenticated user's public profile, enrollment date, partner verification timestamp, verification
-      # waitlist status, partner certification completion, active direct business referral count, and default payout
-      # rates. Use me or the authenticated user's own user ID; other users are not accessible. Users who have not
-      # enrolled have a null joined_at. Create and manage referral links through /partner_referral_requests.
+      # Retrieves the authenticated user's partner profile: enrollment and verification status, certification
+      # completion, active direct business referral count, and default payout rates. Other users' profiles are not
+      # accessible. To create and manage referral links, use `/partner_referral_requests`.
       #
       # @param request_options [Hash]
       # @param params [Hash]

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

@@ -4,8 +4,6 @@ module Whop_sdk
   module Partners
     module Types
       class ReferredUsersPartnersRequest < Internal::Types::Model
-        field :user_id, -> { Whop_sdk::Partners::Types::ReferredUsersPartnersRequestUserID }, optional: true, nullable: false
-
         field :earning_partner_id, -> { String }, optional: true, nullable: false
 
         field :earning_partner_username, -> { String }, optional: true, nullable: false

data/lib/whop_sdk/payment_method_domains/client.rb

@@ -14,8 +14,7 @@ module Whop_sdk
         @environment = environment
       end
 
-      # Lists payment method domains. Without `account_id`, returns the caller's own domains and those of every
-      # connected account.
+      # Lists the payment method domains registered for your account and its connected accounts.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -88,8 +87,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 the verify endpoint.
+      # `/.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`.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::PaymentMethodDomains::Types::CreatePaymentMethodDomainsRequest]
@@ -100,7 +99,7 @@ module Whop_sdk
       # @option request_options [Integer] :timeout_in_seconds
       #
       # @example
-      #   client.payment_method_domains.create(hostname: "pending.shinetime.example")
+      #   client.payment_method_domains.create(hostname: "pending.shinetime.com")
       #
       # @return [Whop_sdk::Types::PaymentMethodDomain]
       def create(request_options: {}, **params)

data/lib/whop_sdk/payment_methods/client.rb

@@ -14,9 +14,8 @@ module Whop_sdk
         @environment = environment
       end
 
-      # Returns a paginated list of payment methods for a member or company, or for the authenticated user when neither
-      # is given, with optional filtering by creation date. A payment method is a stored representation of how a
-      # customer intends to pay, such as a card, bank account, or digital wallet.
+      # Returns a paginated list of saved payment methods for a member or account, or for the authenticated user when
+      # you pass neither.
       #
       # Required permissions:
       #  - `member:payment_methods:read`
@@ -105,8 +104,8 @@ module Whop_sdk
         end
       end
 
-      # Retrieves the details of an existing payment method. Addresses a member's wallet when member_id or account_id is
-      # given, otherwise your own.
+      # Retrieves a saved payment method from a member's wallet when you pass `member_id` or `account_id`, or from your
+      # own otherwise.
       #
       # Required permissions:
       #  - `member:payment_methods:read`

data/lib/whop_sdk/payment_quotes/client.rb

@@ -14,14 +14,12 @@ module Whop_sdk
         @environment = environment
       end
 
-      # Prices a purchase the way a payment for it will be charged, for a buyer located by the shipping address, then
-      # the billing address, then the IP address you pass. The body is the `PaymentInput` a payment takes plus where the
-      # buyer is (`address`, `shipping_address`, `tax_ids`, `ip_address`); a seller that collects no tax on the purchase
-      # can be quoted without them. The purchase is priced from exactly what you send: no buyer is looked up, so no
-      # stored registration or purchase history applies. Quote what you are about to charge and pass the quote's `id` as
-      # `quote_id` when you create the payment: it then charges exactly the purchase, promo code and tax shown here. A
-      # quote is priced once, in the plans' own currency or the `presentment_currency` you ask for, and may be consumed
-      # by one payment before `expires_at`.
+      # Prices a purchase the way a payment for it will be charged. The body is the `PaymentInput` a payment takes plus
+      # where the buyer is, which a seller that collects no tax on the purchase can leave out. The purchase is priced
+      # 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`.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequest]
@@ -58,8 +56,8 @@ module Whop_sdk
         end
       end
 
-      # Retrieves a payment quote, including the payment holding it (`payment_id`, whose `status` says whether it
-      # collected) and when it expires.
+      # Retrieves a payment quote. Use it to check which payment holds the quote, through `payment_id`, and when it
+      # expires.
       #
       # @param request_options [Hash]
       # @param params [Hash]

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

@@ -8,6 +8,10 @@ module Whop_sdk
 
         field :ip_address, -> { String }, optional: true, nullable: false
 
+        field :line_items, -> { Internal::Types::Array[Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestLineItemsItem] }, optional: true, nullable: false
+
+        field :presentment_country, -> { String }, optional: true, nullable: false
+
         field :presentment_currency, -> { String }, optional: true, nullable: false
 
         field :shipping_address, -> { Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestShippingAddress }, optional: true, nullable: false
@@ -16,8 +20,6 @@ module Whop_sdk
 
         field :account_id, -> { String }, optional: false, nullable: false
 
-        field :line_items, -> { Internal::Types::Array[Whop_sdk::Types::PaymentInputLineItemsItem] }, optional: true, nullable: false
-
         field :plan, -> { Whop_sdk::Types::PaymentInputPlan }, optional: true, nullable: false
 
         field :plan_id, -> { String }, optional: true, nullable: false

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

@@ -5,7 +5,7 @@ module Whop_sdk
     module Types
       # The buyer's billing address. Where tax is calculated when no shipping address is given, and the address a tax
       # registration belongs to. A seller that collects tax on this purchase needs the buyer located by a `country`
-      # here, on `shipping_address`, or an `ip_address`; without one the quote is refused with
+      # here, on `shipping_address`, a `presentment_country`, or an `ip_address`; without one the quote is refused with
       # `quote_location_required`. Only the keys you supply are kept. The payment that consumes the quote must put the
       # buyer in the same place, by country, state and postal code, through its own `shipping_address` or its
       # confirmation token's billing address, or it is refused with `quote_mismatch`.

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+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
+      end
+    end
+  end
+end

data/lib/whop_sdk/payment_rules/client.rb

@@ -14,6 +14,8 @@ module Whop_sdk
         @environment = environment
       end
 
+      # Lists the payment rules on an account.
+      #
       # @param request_options [Hash]
       # @param params [Hash]
       # @option request_options [String] :base_url
@@ -77,6 +79,9 @@ module Whop_sdk
         end
       end
 
+      # Creates a payment rule. It is created `active` and applies its `action` to new payments that match all of its
+      # `conditions`.
+      #
       # @param request_options [Hash]
       # @param params [Whop_sdk::PaymentRules::Types::CreatePaymentRulesRequest]
       # @option request_options [String] :base_url
@@ -122,7 +127,8 @@ module Whop_sdk
         end
       end
 
-      # Small and returned in full on one page.
+      # Lists the payment attributes a rule condition can read, with the operators and values each one accepts. Small
+      # and returned in full on one page.
       #
       # @param request_options [Hash]
       # @param _params [Hash]
@@ -157,6 +163,8 @@ module Whop_sdk
         end
       end
 
+      # Retrieves a payment rule.
+      #
       # @param request_options [Hash]
       # @param params [Hash]
       # @option request_options [String] :base_url
@@ -192,7 +200,8 @@ module Whop_sdk
         end
       end
 
-      # The rule stops applying to new payments and is kept, so the payments it already decided still name it.
+      # Deletes a payment rule. It stops applying to new payments but is kept, so the payments it already decided still
+      # name it.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -227,9 +236,9 @@ module Whop_sdk
         raise error_class.new(response.body, code: code)
       end
 
-      # Changes the rule's name or metadata, keeping its ID and everything recorded against it. What the rule *does* is
-      # fixed once created, so the payments it decided keep naming the rule that decided them; use replace to change
-      # that.
+      # Updates a payment rule's name or metadata, keeping its ID and everything recorded against it. A rule's `action`
+      # and `conditions` are fixed once created, so the payments it decided keep naming the rule that decided them; use
+      # `POST /payment_rules/:id/replace` to change them.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::PaymentRules::Types::UpdatePaymentRulesRequest]
@@ -271,6 +280,8 @@ module Whop_sdk
         end
       end
 
+      # Activates an inactive payment rule so it applies to new payments again. A deleted rule cannot be activated.
+      #
       # @param request_options [Hash]
       # @param params [Hash]
       # @option request_options [String] :base_url
@@ -306,7 +317,7 @@ module Whop_sdk
         end
       end
 
-      # The rule stops applying to new payments. It keeps its ID and can be activated again.
+      # Deactivates a payment rule so it stops applying to new payments. It keeps its ID and can be activated again.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -343,8 +354,8 @@ module Whop_sdk
         end
       end
 
-      # Deletes this rule and creates its successor in one step. The successor carries a new ID and the metadata of the
-      # rule it replaced,.
+      # Changes a payment rule's `action` and `conditions` by deleting it and creating its successor in one step. The
+      # successor has a new ID and keeps the replaced rule's name, metadata, and `active` or `inactive` status.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::PaymentRules::Types::ReplacePaymentRulesRequest]