whop_sdk 0.0.9 → 0.0.11

data/lib/whop_sdk/resources/payment_methods.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    class PaymentMethods
+      # A payment method is a stored representation of how a customer intends to pay,
+      # such as a card, bank account, or digital wallet. It holds the necessary billing
+      # details and can be attached to a member for future one-time or recurring
+      # charges. This lets you reuse the same payment credentials across multiple
+      # payments.
+      #
+      # Required permissions:
+      #
+      # - `member:payment_methods:read`
+      #
+      # @overload retrieve(id, member_id:, request_options: {})
+      #
+      # @param id [String] The ID of the PaymentMethod
+      #
+      # @param member_id [String] The ID of the Member associated with the PaymentMethod
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::PaymentMethodRetrieveResponse]
+      #
+      # @see WhopSDK::Models::PaymentMethodRetrieveParams
+      def retrieve(id, params)
+        parsed, options = WhopSDK::PaymentMethodRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["payment_methods/%1$s", id],
+          query: parsed,
+          model: WhopSDK::Models::PaymentMethodRetrieveResponse,
+          options: options
+        )
+      end
+
+      # A payment method is a stored representation of how a customer intends to pay,
+      # such as a card, bank account, or digital wallet. It holds the necessary billing
+      # details and can be attached to a member for future one-time or recurring
+      # charges. This lets you reuse the same payment credentials across multiple
+      # payments.
+      #
+      # Required permissions:
+      #
+      # - `member:payment_methods:read`
+      #
+      # @overload list(member_id:, after: nil, before: nil, created_after: nil, created_before: nil, direction: nil, first: nil, last: nil, request_options: {})
+      #
+      # @param member_id [String] The ID of the Member to list payment methods for
+      #
+      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      #
+      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      #
+      # @param created_after [Time, nil] The minimum creation date to filter by
+      #
+      # @param created_before [Time, nil] The maximum creation date to filter by
+      #
+      # @param direction [Symbol, WhopSDK::Models::Direction, nil] The direction of the sort.
+      #
+      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      #
+      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::PaymentMethodListResponse>]
+      #
+      # @see WhopSDK::Models::PaymentMethodListParams
+      def list(params)
+        parsed, options = WhopSDK::PaymentMethodListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "payment_methods",
+          query: parsed,
+          page: WhopSDK::Internal::CursorPage,
+          model: WhopSDK::Models::PaymentMethodListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/whop_sdk/resources/payments.rb

@@ -3,6 +3,56 @@
 module WhopSDK
   module Resources
     class Payments
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::PaymentCreateParams} for more details.
+      #
+      # Charge an existing member off-session using one of their stored payment methods.
+      # You can provide an existing plan, or create a new one in-line. This endpoint
+      # will respond with a payment object immediately, but the payment is processed
+      # asynchronously in the background. Use webhooks to be notified when the payment
+      # succeeds or fails.
+      #
+      # Required permissions:
+      #
+      # - `payment:charge`
+      # - `plan:create`
+      # - `access_pass:create`
+      # - `access_pass:update`
+      # - `plan:basic:read`
+      # - `access_pass:basic:read`
+      # - `member:email:read`
+      # - `member:basic:read`
+      # - `member:phone:read`
+      # - `promo_code:basic:read`
+      #
+      # @overload create(company_id:, member_id:, payment_method_id:, plan:, plan_id:, request_options: {})
+      #
+      # @param company_id [String] The ID of the company to create the payment for.
+      #
+      # @param member_id [String] The ID of the member to create the payment for.
+      #
+      # @param payment_method_id [String] The ID of the payment method to use for the payment. It must be connected to the
+      #
+      # @param plan [WhopSDK::Models::PaymentCreateParams::Plan] Pass this object to create a new plan for this payment
+      #
+      # @param plan_id [String] An ID of an existing plan to use for the payment.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::Payment]
+      #
+      # @see WhopSDK::Models::PaymentCreateParams
+      def create(params)
+        parsed, options = WhopSDK::PaymentCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "payments",
+          body: parsed,
+          model: WhopSDK::Payment,
+          options: options
+        )
+      end
+
       # Retrieves a payment by ID
       #
       # Required permissions:

data/lib/whop_sdk/resources/setup_intents.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    class SetupIntents
+      # A setup intent is an object used to securely collect and store a member’s
+      # payment method for future use without charging them immediately. It handles
+      # authentication steps up front so future off-session payments can be completed
+      # smoothly. This ensures the payment method is verified and ready for later
+      # billing.
+      #
+      # Required permissions:
+      #
+      # - `payment:setup_intent:read`
+      # - `member:basic:read`
+      # - `member:email:read`
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The ID of the Setup Intent
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::SetupIntent]
+      #
+      # @see WhopSDK::Models::SetupIntentRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["setup_intents/%1$s", id],
+          model: WhopSDK::SetupIntent,
+          options: params[:request_options]
+        )
+      end
+
+      # A setup intent is an object used to securely collect and store a member’s
+      # payment method for future use without charging them immediately. It handles
+      # authentication steps up front so future off-session payments can be completed
+      # smoothly. This ensures the payment method is verified and ready for later
+      # billing.
+      #
+      # Required permissions:
+      #
+      # - `payment:setup_intent:read`
+      # - `member:basic:read`
+      # - `member:email:read`
+      #
+      # @overload list(company_id:, after: nil, before: nil, created_after: nil, created_before: nil, direction: nil, first: nil, last: nil, request_options: {})
+      #
+      # @param company_id [String] The ID of the company to list setup intents for
+      #
+      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      #
+      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      #
+      # @param created_after [Time, nil] The minimum creation date to filter by
+      #
+      # @param created_before [Time, nil] The maximum creation date to filter by
+      #
+      # @param direction [Symbol, WhopSDK::Models::Direction, nil] The direction of the sort.
+      #
+      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      #
+      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::SetupIntentListResponse>]
+      #
+      # @see WhopSDK::Models::SetupIntentListParams
+      def list(params)
+        parsed, options = WhopSDK::SetupIntentListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "setup_intents",
+          query: parsed,
+          page: WhopSDK::Internal::CursorPage,
+          model: WhopSDK::Models::SetupIntentListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/whop_sdk/resources/webhooks.rb

@@ -5,7 +5,7 @@ module WhopSDK
     class Webhooks
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [WhopSDK::Models::InvoiceCreatedWebhookEvent, WhopSDK::Models::InvoicePaidWebhookEvent, WhopSDK::Models::InvoicePastDueWebhookEvent, WhopSDK::Models::InvoiceVoidedWebhookEvent, WhopSDK::Models::MembershipActivatedWebhookEvent, WhopSDK::Models::MembershipDeactivatedWebhookEvent, WhopSDK::Models::EntryCreatedWebhookEvent, WhopSDK::Models::EntryApprovedWebhookEvent, WhopSDK::Models::EntryDeniedWebhookEvent, WhopSDK::Models::EntryDeletedWebhookEvent, WhopSDK::Models::CourseLessonInteractionCompletedWebhookEvent, WhopSDK::Models::PaymentSucceededWebhookEvent, WhopSDK::Models::PaymentFailedWebhookEvent, WhopSDK::Models::PaymentPendingWebhookEvent, WhopSDK::Models::DisputeCreatedWebhookEvent, WhopSDK::Models::DisputeUpdatedWebhookEvent, WhopSDK::Models::RefundCreatedWebhookEvent, WhopSDK::Models::RefundUpdatedWebhookEvent]
+      # @return [WhopSDK::Models::InvoiceCreatedWebhookEvent, WhopSDK::Models::InvoicePaidWebhookEvent, WhopSDK::Models::InvoicePastDueWebhookEvent, WhopSDK::Models::InvoiceVoidedWebhookEvent, WhopSDK::Models::MembershipActivatedWebhookEvent, WhopSDK::Models::MembershipDeactivatedWebhookEvent, WhopSDK::Models::EntryCreatedWebhookEvent, WhopSDK::Models::EntryApprovedWebhookEvent, WhopSDK::Models::EntryDeniedWebhookEvent, WhopSDK::Models::EntryDeletedWebhookEvent, WhopSDK::Models::SetupIntentRequiresActionWebhookEvent, WhopSDK::Models::SetupIntentSucceededWebhookEvent, WhopSDK::Models::SetupIntentCanceledWebhookEvent, WhopSDK::Models::CourseLessonInteractionCompletedWebhookEvent, WhopSDK::Models::PaymentSucceededWebhookEvent, WhopSDK::Models::PaymentFailedWebhookEvent, WhopSDK::Models::PaymentPendingWebhookEvent, WhopSDK::Models::DisputeCreatedWebhookEvent, WhopSDK::Models::DisputeUpdatedWebhookEvent, WhopSDK::Models::RefundCreatedWebhookEvent, WhopSDK::Models::RefundUpdatedWebhookEvent]
       def unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         WhopSDK::Internal::Type::Converter.coerce(WhopSDK::Models::UnwrapWebhookEvent, parsed)

data/lib/whop_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module WhopSDK
-  VERSION = "0.0.9"
+  VERSION = "0.0.11"
 end

data/lib/whop_sdk.rb

@@ -239,9 +239,14 @@ require_relative "whop_sdk/models/notification_create_params"
 require_relative "whop_sdk/models/notification_create_response"
 require_relative "whop_sdk/models/page_info"
 require_relative "whop_sdk/models/payment"
+require_relative "whop_sdk/models/payment_create_params"
 require_relative "whop_sdk/models/payment_failed_webhook_event"
 require_relative "whop_sdk/models/payment_list_params"
 require_relative "whop_sdk/models/payment_list_response"
+require_relative "whop_sdk/models/payment_method_list_params"
+require_relative "whop_sdk/models/payment_method_list_response"
+require_relative "whop_sdk/models/payment_method_retrieve_params"
+require_relative "whop_sdk/models/payment_method_retrieve_response"
 require_relative "whop_sdk/models/payment_method_types"
 require_relative "whop_sdk/models/payment_pending_webhook_event"
 require_relative "whop_sdk/models/payment_provider"
@@ -298,6 +303,14 @@ require_relative "whop_sdk/models/review_list_response"
 require_relative "whop_sdk/models/review_retrieve_params"
 require_relative "whop_sdk/models/review_retrieve_response"
 require_relative "whop_sdk/models/review_status"
+require_relative "whop_sdk/models/setup_intent"
+require_relative "whop_sdk/models/setup_intent_canceled_webhook_event"
+require_relative "whop_sdk/models/setup_intent_list_params"
+require_relative "whop_sdk/models/setup_intent_list_response"
+require_relative "whop_sdk/models/setup_intent_requires_action_webhook_event"
+require_relative "whop_sdk/models/setup_intent_retrieve_params"
+require_relative "whop_sdk/models/setup_intent_status"
+require_relative "whop_sdk/models/setup_intent_succeeded_webhook_event"
 require_relative "whop_sdk/models/shipment"
 require_relative "whop_sdk/models/shipment_carrier"
 require_relative "whop_sdk/models/shipment_create_params"
@@ -362,6 +375,7 @@ require_relative "whop_sdk/resources/members"
 require_relative "whop_sdk/resources/memberships"
 require_relative "whop_sdk/resources/messages"
 require_relative "whop_sdk/resources/notifications"
+require_relative "whop_sdk/resources/payment_methods"
 require_relative "whop_sdk/resources/payments"
 require_relative "whop_sdk/resources/plans"
 require_relative "whop_sdk/resources/products"
@@ -369,6 +383,7 @@ require_relative "whop_sdk/resources/promo_codes"
 require_relative "whop_sdk/resources/reactions"
 require_relative "whop_sdk/resources/refunds"
 require_relative "whop_sdk/resources/reviews"
+require_relative "whop_sdk/resources/setup_intents"
 require_relative "whop_sdk/resources/shipments"
 require_relative "whop_sdk/resources/support_channels"
 require_relative "whop_sdk/resources/transfers"

data/rbi/whop_sdk/client.rbi

@@ -130,6 +130,12 @@ module WhopSDK
     sig { returns(WhopSDK::Resources::AccountLinks) }
     attr_reader :account_links
 
+    sig { returns(WhopSDK::Resources::SetupIntents) }
+    attr_reader :setup_intents
+
+    sig { returns(WhopSDK::Resources::PaymentMethods) }
+    attr_reader :payment_methods
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

data/rbi/whop_sdk/models/app_build_create_params.rbi

@@ -34,6 +34,10 @@ module WhopSDK
       sig { returns(WhopSDK::AppBuildPlatforms::OrSymbol) }
       attr_accessor :platform
 
+      # The id of the ai prompt that created this build
+      sig { returns(T.nilable(String)) }
+      attr_accessor :ai_prompt_id
+
       # The ID of the app to create a build for. By default the current app from the api
       # key is used.
       sig { returns(T.nilable(String)) }
@@ -53,6 +57,7 @@ module WhopSDK
             ),
           checksum: String,
           platform: WhopSDK::AppBuildPlatforms::OrSymbol,
+          ai_prompt_id: T.nilable(String),
           app_id: T.nilable(String),
           supported_app_view_types:
             T.nilable(T::Array[WhopSDK::AppViewType::OrSymbol]),
@@ -70,6 +75,8 @@ module WhopSDK
         checksum:,
         # The platform of the app build (ios, android, web)
         platform:,
+        # The id of the ai prompt that created this build
+        ai_prompt_id: nil,
         # The ID of the app to create a build for. By default the current app from the api
         # key is used.
         app_id: nil,
@@ -90,6 +97,7 @@ module WhopSDK
               ),
             checksum: String,
             platform: WhopSDK::AppBuildPlatforms::OrSymbol,
+            ai_prompt_id: T.nilable(String),
             app_id: T.nilable(String),
             supported_app_view_types:
               T.nilable(T::Array[WhopSDK::AppViewType::OrSymbol]),

data/rbi/whop_sdk/models/invoice_create_params.rbi

@@ -57,6 +57,11 @@ module WhopSDK
       sig { returns(T.nilable(String)) }
       attr_accessor :customer_name
 
+      # The payment method ID to use for this invoice. If using charge_automatically,
+      # you must provide a payment_method_id.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :payment_method_id
+
       # The payment token ID to use for this invoice. If using charge_automatically, you
       # must provide a payment_token.
       sig { returns(T.nilable(String)) }
@@ -84,6 +89,7 @@ module WhopSDK
           product_id: String,
           charge_buyer_fee: T.nilable(T::Boolean),
           customer_name: T.nilable(String),
+          payment_method_id: T.nilable(String),
           payment_token_id: T.nilable(String),
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -117,6 +123,9 @@ module WhopSDK
         # want to create an invoice for a customer who does not have a member of your
         # company yet.
         customer_name: nil,
+        # The payment method ID to use for this invoice. If using charge_automatically,
+        # you must provide a payment_method_id.
+        payment_method_id: nil,
         # The payment token ID to use for this invoice. If using charge_automatically, you
         # must provide a payment_token.
         payment_token_id: nil,
@@ -135,6 +144,7 @@ module WhopSDK
             product: WhopSDK::InvoiceCreateParams::Product,
             charge_buyer_fee: T.nilable(T::Boolean),
             customer_name: T.nilable(String),
+            payment_method_id: T.nilable(String),
             payment_token_id: T.nilable(String),
             email_address: String,
             product_id: String,

data/rbi/whop_sdk/models/payment.rbi

@@ -93,6 +93,17 @@ module WhopSDK
       sig { returns(T.nilable(Time)) }
       attr_accessor :paid_at
 
+      # The payment method used for the payment, if available.
+      sig { returns(T.nilable(WhopSDK::Payment::PaymentMethod)) }
+      attr_reader :payment_method
+
+      sig do
+        params(
+          payment_method: T.nilable(WhopSDK::Payment::PaymentMethod::OrHash)
+        ).void
+      end
+      attr_writer :payment_method
+
       # The different types of payment methods that can be used.
       sig { returns(T.nilable(WhopSDK::PaymentMethodTypes::TaggedSymbol)) }
       attr_accessor :payment_method_type
@@ -191,6 +202,7 @@ module WhopSDK
           membership: T.nilable(WhopSDK::Payment::Membership::OrHash),
           metadata: T.nilable(T::Hash[Symbol, T.anything]),
           paid_at: T.nilable(Time),
+          payment_method: T.nilable(WhopSDK::Payment::PaymentMethod::OrHash),
           payment_method_type: T.nilable(WhopSDK::PaymentMethodTypes::OrSymbol),
           plan: T.nilable(WhopSDK::Payment::Plan::OrHash),
           product: T.nilable(WhopSDK::Payment::Product::OrHash),
@@ -244,6 +256,8 @@ module WhopSDK
         metadata:,
         # The datetime the payment was paid
         paid_at:,
+        # The payment method used for the payment, if available.
+        payment_method:,
         # The different types of payment methods that can be used.
         payment_method_type:,
         # The plan attached to this payment.
@@ -301,6 +315,7 @@ module WhopSDK
             membership: T.nilable(WhopSDK::Payment::Membership),
             metadata: T.nilable(T::Hash[Symbol, T.anything]),
             paid_at: T.nilable(Time),
+            payment_method: T.nilable(WhopSDK::Payment::PaymentMethod),
             payment_method_type:
               T.nilable(WhopSDK::PaymentMethodTypes::TaggedSymbol),
             plan: T.nilable(WhopSDK::Payment::Plan),
@@ -512,6 +527,130 @@ module WhopSDK
         end
       end
 
+      class PaymentMethod < WhopSDK::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(WhopSDK::Payment::PaymentMethod, WhopSDK::Internal::AnyHash)
+          end
+
+        # The ID of the payment method
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The card data associated with the payment method, if its a debit or credit card.
+        sig { returns(T.nilable(WhopSDK::Payment::PaymentMethod::Card)) }
+        attr_reader :card
+
+        sig do
+          params(
+            card: T.nilable(WhopSDK::Payment::PaymentMethod::Card::OrHash)
+          ).void
+        end
+        attr_writer :card
+
+        # The date and time the payment method was created
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # The payment method type of the payment method
+        sig { returns(WhopSDK::PaymentMethodTypes::TaggedSymbol) }
+        attr_accessor :payment_method_type
+
+        # The payment method used for the payment, if available.
+        sig do
+          params(
+            id: String,
+            card: T.nilable(WhopSDK::Payment::PaymentMethod::Card::OrHash),
+            created_at: Time,
+            payment_method_type: WhopSDK::PaymentMethodTypes::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The ID of the payment method
+          id:,
+          # The card data associated with the payment method, if its a debit or credit card.
+          card:,
+          # The date and time the payment method was created
+          created_at:,
+          # The payment method type of the payment method
+          payment_method_type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              card: T.nilable(WhopSDK::Payment::PaymentMethod::Card),
+              created_at: Time,
+              payment_method_type: WhopSDK::PaymentMethodTypes::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Card < WhopSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                WhopSDK::Payment::PaymentMethod::Card,
+                WhopSDK::Internal::AnyHash
+              )
+            end
+
+          # Possible card brands that a payment token can have
+          sig { returns(T.nilable(WhopSDK::CardBrands::TaggedSymbol)) }
+          attr_accessor :brand
+
+          # Card expiration month, like 03 for March.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :exp_month
+
+          # Card expiration year, like 27 for 2027.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :exp_year
+
+          # Last four digits of the card.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :last4
+
+          # The card data associated with the payment method, if its a debit or credit card.
+          sig do
+            params(
+              brand: T.nilable(WhopSDK::CardBrands::OrSymbol),
+              exp_month: T.nilable(Integer),
+              exp_year: T.nilable(Integer),
+              last4: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Possible card brands that a payment token can have
+            brand:,
+            # Card expiration month, like 03 for March.
+            exp_month:,
+            # Card expiration year, like 27 for 2027.
+            exp_year:,
+            # Last four digits of the card.
+            last4:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                brand: T.nilable(WhopSDK::CardBrands::TaggedSymbol),
+                exp_month: T.nilable(Integer),
+                exp_year: T.nilable(Integer),
+                last4: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+
       class Plan < WhopSDK::Internal::Type::BaseModel
         OrHash =
           T.type_alias do