whop_sdk 2.0.0 → 2.1.0

data/lib/whop_sdk/payment_quotes/client.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module PaymentQuotes
+    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
+
+      # 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, and may be consumed by one payment before `expires_at`.
+      #
+      # @param request_options [Hash]
+      # @param params [Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequest]
+      # @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.payment_quotes.create(account_id: "biz_xxxxxxxxxxxxxx")
+      #
+      # @return [Whop_sdk::Types::PaymentQuote]
+      def create(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: "payment_quotes",
+          body: Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequest.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::PaymentQuote.load(response.body))
+        else
+          error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Retrieves a payment quote, including the payment holding it (`payment_id`, whose `status` says whether it
+      # collected) and when it expires.
+      #
+      # @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] :id
+      #
+      # @example
+      #   client.payment_quotes.retrieve(id: "id")
+      #
+      # @return [Whop_sdk::Types::PaymentQuote]
+      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: "payment_quotes/#{URI.encode_uri_component(params[:id].to_s)}",
+          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::PaymentQuote.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

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module PaymentQuotes
+    module Types
+      class CreatePaymentQuotesRequest < Internal::Types::Model
+        field :address, -> { Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestAddress }, optional: true, nullable: false
+
+        field :ip_address, -> { String }, optional: true, nullable: false
+
+        field :shipping_address, -> { Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestShippingAddress }, optional: true, nullable: false
+
+        field :tax_ids, -> { Internal::Types::Array[Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestTaxIDsItem] }, optional: true, nullable: false
+
+        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
+
+        field :promo_code, -> { String }, optional: true, nullable: false
+
+        field :promo_code_id, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module PaymentQuotes
+    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: provide a
+      # `country` here, on `shipping_address`, or an `ip_address`. 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`.
+      class CreatePaymentQuotesRequestAddress < Internal::Types::Model
+        field :city, -> { String }, optional: true, nullable: false
+
+        field :country, -> { String }, optional: true, nullable: false
+
+        field :line1, -> { String }, optional: true, nullable: false
+
+        field :line2, -> { String }, optional: true, nullable: false
+
+        field :name, -> { String }, optional: true, nullable: false
+
+        field :postal_code, -> { String }, optional: true, nullable: false
+
+        field :state, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module PaymentQuotes
+    module Types
+      # Where physical goods ship. When present it is where tax is calculated; omit it for digital goods. Only the keys
+      # you supply are kept. The payment that consumes the quote must ship to the same place, by country, state and
+      # postal code, or it is refused with `quote_mismatch`.
+      class CreatePaymentQuotesRequestShippingAddress < Internal::Types::Model
+        field :city, -> { String }, optional: true, nullable: false
+
+        field :country, -> { String }, optional: true, nullable: false
+
+        field :line1, -> { String }, optional: true, nullable: false
+
+        field :line2, -> { String }, optional: true, nullable: false
+
+        field :name, -> { String }, optional: true, nullable: false
+
+        field :postal_code, -> { String }, optional: true, nullable: false
+
+        field :state, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module PaymentQuotes
+    module Types
+      class CreatePaymentQuotesRequestTaxIDsItem < Internal::Types::Model
+        field :type, -> { Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestTaxIDsItemType }, optional: false, nullable: false
+
+        field :value, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

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

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module PaymentQuotes
+    module Types
+      module CreatePaymentQuotesRequestTaxIDsItemType
+        extend Whop_sdk::Internal::Types::Enum
+
+        AD_NRT = "ad_nrt"
+        AO_TIN = "ao_tin"
+        AR_CUIT = "ar_cuit"
+        AL_TIN = "al_tin"
+        AM_TIN = "am_tin"
+        AW_TIN = "aw_tin"
+        AU_ABN = "au_abn"
+        AU_ARN = "au_arn"
+        EU_VAT = "eu_vat"
+        AZ_TIN = "az_tin"
+        BS_TIN = "bs_tin"
+        BH_VAT = "bh_vat"
+        BD_BIN = "bd_bin"
+        BB_TIN = "bb_tin"
+        BY_TIN = "by_tin"
+        BJ_IFU = "bj_ifu"
+        BO_TIN = "bo_tin"
+        BA_TIN = "ba_tin"
+        BR_CNPJ = "br_cnpj"
+        BR_CPF = "br_cpf"
+        BG_UIC = "bg_uic"
+        BF_IFU = "bf_ifu"
+        KH_TIN = "kh_tin"
+        CM_NIU = "cm_niu"
+        CA_BN = "ca_bn"
+        CA_GST_HST = "ca_gst_hst"
+        CA_PST_BC = "ca_pst_bc"
+        CA_PST_MB = "ca_pst_mb"
+        CA_PST_SK = "ca_pst_sk"
+        CA_QST = "ca_qst"
+        CV_NIF = "cv_nif"
+        CL_TIN = "cl_tin"
+        CN_TIN = "cn_tin"
+        CO_NIT = "co_nit"
+        CD_NIF = "cd_nif"
+        CR_TIN = "cr_tin"
+        HR_OIB = "hr_oib"
+        DO_RCN = "do_rcn"
+        EC_RUC = "ec_ruc"
+        EG_TIN = "eg_tin"
+        SV_NIT = "sv_nit"
+        ET_TIN = "et_tin"
+        EU_OSS_VAT = "eu_oss_vat"
+        GE_VAT = "ge_vat"
+        GH_TIN = "gh_tin"
+        DE_STN = "de_stn"
+        GB_VAT = "gb_vat"
+        GN_NIF = "gn_nif"
+        HK_BR = "hk_br"
+        HU_TIN = "hu_tin"
+        IS_VAT = "is_vat"
+        IN_GST = "in_gst"
+        ID_NPWP = "id_npwp"
+        IL_VAT = "il_vat"
+        JP_CN = "jp_cn"
+        JP_RN = "jp_rn"
+        JP_TRN = "jp_trn"
+        KZ_BIN = "kz_bin"
+        KE_PIN = "ke_pin"
+        KG_TIN = "kg_tin"
+        LA_TIN = "la_tin"
+        LI_UID = "li_uid"
+        LI_VAT = "li_vat"
+        MY_FRP = "my_frp"
+        MY_ITN = "my_itn"
+        MY_SST = "my_sst"
+        MR_NIF = "mr_nif"
+        MX_RFC = "mx_rfc"
+        MD_VAT = "md_vat"
+        ME_PIB = "me_pib"
+        MA_VAT = "ma_vat"
+        NP_PAN = "np_pan"
+        NZ_GST = "nz_gst"
+        NG_TIN = "ng_tin"
+        MK_VAT = "mk_vat"
+        NO_VAT = "no_vat"
+        NO_VOEC = "no_voec"
+        OM_VAT = "om_vat"
+        PE_RUC = "pe_ruc"
+        PH_TIN = "ph_tin"
+        PL_NIP = "pl_nip"
+        RO_TIN = "ro_tin"
+        RU_INN = "ru_inn"
+        RU_KPP = "ru_kpp"
+        SA_VAT = "sa_vat"
+        SN_NINEA = "sn_ninea"
+        RS_PIB = "rs_pib"
+        SG_GST = "sg_gst"
+        SG_UEN = "sg_uen"
+        SI_TIN = "si_tin"
+        ZA_VAT = "za_vat"
+        KR_BRN = "kr_brn"
+        ES_CIF = "es_cif"
+        CH_UID = "ch_uid"
+        CH_VAT = "ch_vat"
+        TW_VAT = "tw_vat"
+        TJ_TIN = "tj_tin"
+        TZ_VAT = "tz_vat"
+        TH_VAT = "th_vat"
+        TR_TIN = "tr_tin"
+        UG_TIN = "ug_tin"
+        UA_VAT = "ua_vat"
+        AE_TRN = "ae_trn"
+        US_EIN = "us_ein"
+        UY_RUC = "uy_ruc"
+        UZ_TIN = "uz_tin"
+        UZ_VAT = "uz_vat"
+        VE_RIF = "ve_rif"
+        VN_TIN = "vn_tin"
+        ZM_TIN = "zm_tin"
+        ZW_TIN = "zw_tin"
+        SR_FIN = "sr_fin"
+        XI_VAT = "xi_vat"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module PaymentQuotes
+    module Types
+      class RetrievePaymentQuotesRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/payment_rules/client.rb

@@ -68,7 +68,7 @@ module Whop_sdk
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Whop_sdk::PaymentRules::Types::ListPaymentRulesResponse.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Whop_sdk::PaymentRules::Types::ListPaymentRulesResponse.load(response.body))
             [parsed_response, response]
           else
             error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
@@ -115,7 +115,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentRule.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentRule.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -150,7 +150,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::PaymentRules::Types::ListFieldsPaymentRulesResponse.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::PaymentRules::Types::ListFieldsPaymentRulesResponse.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -185,7 +185,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentRule.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentRule.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -264,7 +264,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentRule.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentRule.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -299,7 +299,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentRule.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentRule.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -336,7 +336,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentRule.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentRule.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -389,7 +389,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentRule.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentRule.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

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

@@ -9,6 +9,7 @@ module Whop_sdk
         RISK_SCORE = "risk_score"
         AMOUNT_IN_USD = "amount_in_usd"
         CARD_COUNTRY = "card_country"
+        CARD_BIN = "card_bin"
         CUSTOMER_EMAIL = "customer_email"
         IP_ADDRESS = "ip_address"
       end

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

@@ -14,8 +14,8 @@ module Whop_sdk
         LTE = "lte"
         IN = "in"
         NOT_IN = "not_in"
-        CONTAINS = "contains"
         STARTS_WITH = "starts_with"
+        CONTAINS = "contains"
         ENDS_WITH = "ends_with"
         IN_CIDR = "in_cidr"
       end

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

@@ -9,6 +9,7 @@ module Whop_sdk
         RISK_SCORE = "risk_score"
         AMOUNT_IN_USD = "amount_in_usd"
         CARD_COUNTRY = "card_country"
+        CARD_BIN = "card_bin"
         CUSTOMER_EMAIL = "customer_email"
         IP_ADDRESS = "ip_address"
       end

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

@@ -14,8 +14,8 @@ module Whop_sdk
         LTE = "lte"
         IN = "in"
         NOT_IN = "not_in"
-        CONTAINS = "contains"
         STARTS_WITH = "starts_with"
+        CONTAINS = "contains"
         ENDS_WITH = "ends_with"
         IN_CIDR = "in_cidr"
       end

data/lib/whop_sdk/payments/client.rb

@@ -14,11 +14,13 @@ module Whop_sdk
         @environment = environment
       end
 
-      # Lists payments, newest first. Without filters this is every payment the caller can read: a company credential's
-      # own account, or for a user every account they can read payments for. Filters narrow by account, buyer, product,
-      # plan, membership, status, billing reason, currency, and creation window. Filtering by
-      # `billing_reason=subscription_cycle` also matches renewals recorded as `subscription_update`.
-      # `settlement_time_at` is null on list rows — retrieve the payment for it.
+      # Lists payments, newest first. By default, returns account sales: a company credential's own account, or for a
+      # user every account they can read payments for. Set `mode=user_sales` to list only the sales received by the
+      # signed-in user's primary ledger account, without a company. This mode requires the user's own Whop login session
+      # and cannot be combined with `account_id`. Filters narrow by account, buyer, product, plan, membership, status,
+      # billing reason, currency, and creation window. Filtering by `billing_reason=subscription_cycle` also matches
+      # renewals recorded as `subscription_update`. `settlement_time_at` is null on list rows — retrieve the payment for
+      # it.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -27,6 +29,7 @@ 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::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::ListPaymentsRequestBillingReason, nil] :billing_reason
@@ -53,6 +56,7 @@ module Whop_sdk
       def list(request_options: {}, **params)
         params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
         query_params = {}
+        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["billing_reason"] = params[:billing_reason] if params.key?(:billing_reason)
@@ -92,7 +96,7 @@ module Whop_sdk
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Whop_sdk::Payments::Types::ListPaymentsResponse.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Whop_sdk::Payments::Types::ListPaymentsResponse.load(response.body))
             [parsed_response, response]
           else
             error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
@@ -101,12 +105,12 @@ module Whop_sdk
         end
       end
 
-      # Charges a buyer for one or more plans. Pass a payment method already on file (`member_id` and
+      # Charges a buyer for one or more variants. Pass a payment method already on file (`member_id` and
       # `payment_method_id`), or a `confirmation_token` describing a method the buyer just supplied. Collection runs in
       # the background: the response is the payment as created, not its outcome — poll Retrieve status for how far it
       # has got and, for a confirmation-token payment, what the buyer must still do. Pass `line_items` for one or more
-      # plans with quantities, `plan_id` for an existing plan, or `plan` to find or create one inline. These inputs are
-      # mutually exclusive.
+      # variants with quantities, `plan_id` for an existing variant, or the compatibility input `plan` to find or create
+      # one inline. These inputs are mutually exclusive.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::Payments::Types::CreatePaymentsRequest]
@@ -136,7 +140,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::Payment.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::Payment.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -144,8 +148,8 @@ module Whop_sdk
       end
 
       # Returns one payment, including every purchased line item with its quantity and subtotal. Related records are ids
-      # — resolve a plan, membership, member or shipment on its own endpoint, and list this payment's refunds, disputes
-      # or Resolution Center cases with `?payment_id=`.
+      # — 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=`.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -175,7 +179,50 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::Payment.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::Payment.load(response.body))
+        else
+          error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Updates a payment's `shipping_address` or `return_url`. Send the complete `shipping_address`, because it
+      # replaces the existing address and any field you leave out is cleared.
+      #
+      # @param request_options [Hash]
+      # @param params [Whop_sdk::Payments::Types::UpdatePaymentsRequest]
+      # @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.payments.update(id: "id")
+      #
+      # @return [Whop_sdk::Types::Payment]
+      def update(request_options: {}, **params)
+        params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+        request_data = Whop_sdk::Payments::Types::UpdatePaymentsRequest.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: "payments/#{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::Types::Payment.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -214,7 +261,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentStatus.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentStatus.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -253,7 +300,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Payments::Types::ListFeesPaymentsResponse.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Payments::Types::ListFeesPaymentsResponse.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -296,14 +343,14 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::Payment.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::Payment.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
         end
       end
 
-      # Retries a failed or pending payment. This re-attempts the charge using the original payment method and plan
+      # Retries a failed or pending payment. This re-attempts the charge using the original payment method and variant
       # details.
       #
       # @param request_options [Hash]
@@ -334,7 +381,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::Payment.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::Payment.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -371,7 +418,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::Payment.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::Payment.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -411,7 +458,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentStatus.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentStatus.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -457,7 +504,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentStatus.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentStatus.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -496,7 +543,7 @@ module Whop_sdk
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Whop_sdk::Types::PaymentStatus.load(response.body)
+          (response.body.to_s.empty? ? nil : Whop_sdk::Types::PaymentStatus.load(response.body))
         else
           error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)