whop_sdk 0.0.2

data/lib/whop_sdk/models/payment.rb

@@ -0,0 +1,534 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    class Payment < WhopSDK::Internal::Type::BaseModel
+      # @!attribute id
+      #   The payment ID
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute amount_after_fees
+      #   How much the payment is for after fees
+      #
+      #   @return [Float]
+      required :amount_after_fees, Float
+
+      # @!attribute auto_refunded
+      #   Whether this payment was auto refunded or not
+      #
+      #   @return [Boolean]
+      required :auto_refunded, WhopSDK::Internal::Type::Boolean
+
+      # @!attribute billing_address
+      #   The address of the user who made the payment.
+      #
+      #   @return [WhopSDK::Models::Payment::BillingAddress, nil]
+      required :billing_address, -> { WhopSDK::Payment::BillingAddress }, nil?: true
+
+      # @!attribute billing_reason
+      #   The billing reason
+      #
+      #   @return [String, nil]
+      required :billing_reason, String, nil?: true
+
+      # @!attribute card_brand
+      #   The type of card used as the payment method.
+      #
+      #   @return [String, nil]
+      required :card_brand, String, nil?: true
+
+      # @!attribute card_last4
+      #   The last 4 digits of the card used to make the payment.
+      #
+      #   @return [String, nil]
+      required :card_last4, String, nil?: true
+
+      # @!attribute company
+      #   The company for the payment.
+      #
+      #   @return [WhopSDK::Models::Payment::Company, nil]
+      required :company, -> { WhopSDK::Payment::Company }, nil?: true
+
+      # @!attribute created_at
+      #   The datetime the payment was created
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute currency
+      #   The available currencies on the platform
+      #
+      #   @return [Symbol, WhopSDK::Models::Currency, nil]
+      required :currency, enum: -> { WhopSDK::Currency }, nil?: true
+
+      # @!attribute dispute_alerted_at
+      #   When an alert came in that this transaction will be disputed
+      #
+      #   @return [Time, nil]
+      required :dispute_alerted_at, Time, nil?: true
+
+      # @!attribute failure_message
+      #   If the payment failed, the reason for the failure.
+      #
+      #   @return [String, nil]
+      required :failure_message, String, nil?: true
+
+      # @!attribute last_payment_attempt
+      #   The time of the last payment attempt.
+      #
+      #   @return [Time, nil]
+      required :last_payment_attempt, Time, nil?: true
+
+      # @!attribute member
+      #   The member attached to this payment.
+      #
+      #   @return [WhopSDK::Models::Payment::Member, nil]
+      required :member, -> { WhopSDK::Payment::Member }, nil?: true
+
+      # @!attribute membership
+      #   The membership attached to this payment.
+      #
+      #   @return [WhopSDK::Models::Payment::Membership, nil]
+      required :membership, -> { WhopSDK::Payment::Membership }, nil?: true
+
+      # @!attribute paid_at
+      #   The datetime the payment was paid
+      #
+      #   @return [Time, nil]
+      required :paid_at, Time, nil?: true
+
+      # @!attribute payment_method_type
+      #   Returns the type of payment method used for the payment, if available. Ex.
+      #   klarna, affirm, card, cashapp
+      #
+      #   @return [String, nil]
+      required :payment_method_type, String, nil?: true
+
+      # @!attribute plan
+      #   The plan attached to this payment.
+      #
+      #   @return [WhopSDK::Models::Payment::Plan, nil]
+      required :plan, -> { WhopSDK::Payment::Plan }, nil?: true
+
+      # @!attribute product
+      #   The access pass attached to this payment.
+      #
+      #   @return [WhopSDK::Models::Payment::Product, nil]
+      required :product, -> { WhopSDK::Payment::Product }, nil?: true
+
+      # @!attribute promo_code
+      #   The promo code used for this payment.
+      #
+      #   @return [WhopSDK::Models::Payment::PromoCode, nil]
+      required :promo_code, -> { WhopSDK::Payment::PromoCode }, nil?: true
+
+      # @!attribute refundable
+      #   Whether the payment can be refunded.
+      #
+      #   @return [Boolean]
+      required :refundable, WhopSDK::Internal::Type::Boolean
+
+      # @!attribute refunded_amount
+      #   The payment refund amount(if applicable).
+      #
+      #   @return [Float, nil]
+      required :refunded_amount, Float, nil?: true
+
+      # @!attribute refunded_at
+      #   When the payment was refunded (if applicable).
+      #
+      #   @return [Time, nil]
+      required :refunded_at, Time, nil?: true
+
+      # @!attribute retryable
+      #   Whether the payment can be retried.
+      #
+      #   @return [Boolean]
+      required :retryable, WhopSDK::Internal::Type::Boolean
+
+      # @!attribute status
+      #   The status of a receipt
+      #
+      #   @return [Symbol, WhopSDK::Models::ReceiptStatus, nil]
+      required :status, enum: -> { WhopSDK::ReceiptStatus }, nil?: true
+
+      # @!attribute substatus
+      #   The friendly status of the payment.
+      #
+      #   @return [Symbol, WhopSDK::Models::FriendlyReceiptStatus]
+      required :substatus, enum: -> { WhopSDK::FriendlyReceiptStatus }
+
+      # @!attribute subtotal
+      #   The subtotal to show to the creator (excluding buyer fees).
+      #
+      #   @return [Float, nil]
+      required :subtotal, Float, nil?: true
+
+      # @!attribute total
+      #   The total to show to the creator (excluding buyer fees).
+      #
+      #   @return [Float, nil]
+      required :total, Float, nil?: true
+
+      # @!attribute usd_total
+      #   The total in USD to show to the creator (excluding buyer fees).
+      #
+      #   @return [Float, nil]
+      required :usd_total, Float, nil?: true
+
+      # @!attribute user
+      #   The user that made this payment.
+      #
+      #   @return [WhopSDK::Models::Payment::User, nil]
+      required :user, -> { WhopSDK::Payment::User }, nil?: true
+
+      # @!attribute voidable
+      #   Whether the payment can be voided.
+      #
+      #   @return [Boolean]
+      required :voidable, WhopSDK::Internal::Type::Boolean
+
+      # @!method initialize(id:, amount_after_fees:, auto_refunded:, billing_address:, billing_reason:, card_brand:, card_last4:, company:, created_at:, currency:, dispute_alerted_at:, failure_message:, last_payment_attempt:, member:, membership:, paid_at:, payment_method_type:, plan:, product:, promo_code:, refundable:, refunded_amount:, refunded_at:, retryable:, status:, substatus:, subtotal:, total:, usd_total:, user:, voidable:)
+      #   Some parameter documentations has been truncated, see {WhopSDK::Models::Payment}
+      #   for more details.
+      #
+      #   An object representing a receipt for a membership.
+      #
+      #   @param id [String] The payment ID
+      #
+      #   @param amount_after_fees [Float] How much the payment is for after fees
+      #
+      #   @param auto_refunded [Boolean] Whether this payment was auto refunded or not
+      #
+      #   @param billing_address [WhopSDK::Models::Payment::BillingAddress, nil] The address of the user who made the payment.
+      #
+      #   @param billing_reason [String, nil] The billing reason
+      #
+      #   @param card_brand [String, nil] The type of card used as the payment method.
+      #
+      #   @param card_last4 [String, nil] The last 4 digits of the card used to make the payment.
+      #
+      #   @param company [WhopSDK::Models::Payment::Company, nil] The company for the payment.
+      #
+      #   @param created_at [Time] The datetime the payment was created
+      #
+      #   @param currency [Symbol, WhopSDK::Models::Currency, nil] The available currencies on the platform
+      #
+      #   @param dispute_alerted_at [Time, nil] When an alert came in that this transaction will be disputed
+      #
+      #   @param failure_message [String, nil] If the payment failed, the reason for the failure.
+      #
+      #   @param last_payment_attempt [Time, nil] The time of the last payment attempt.
+      #
+      #   @param member [WhopSDK::Models::Payment::Member, nil] The member attached to this payment.
+      #
+      #   @param membership [WhopSDK::Models::Payment::Membership, nil] The membership attached to this payment.
+      #
+      #   @param paid_at [Time, nil] The datetime the payment was paid
+      #
+      #   @param payment_method_type [String, nil] Returns the type of payment method used for the payment, if available. Ex. klarn
+      #
+      #   @param plan [WhopSDK::Models::Payment::Plan, nil] The plan attached to this payment.
+      #
+      #   @param product [WhopSDK::Models::Payment::Product, nil] The access pass attached to this payment.
+      #
+      #   @param promo_code [WhopSDK::Models::Payment::PromoCode, nil] The promo code used for this payment.
+      #
+      #   @param refundable [Boolean] Whether the payment can be refunded.
+      #
+      #   @param refunded_amount [Float, nil] The payment refund amount(if applicable).
+      #
+      #   @param refunded_at [Time, nil] When the payment was refunded (if applicable).
+      #
+      #   @param retryable [Boolean] Whether the payment can be retried.
+      #
+      #   @param status [Symbol, WhopSDK::Models::ReceiptStatus, nil] The status of a receipt
+      #
+      #   @param substatus [Symbol, WhopSDK::Models::FriendlyReceiptStatus] The friendly status of the payment.
+      #
+      #   @param subtotal [Float, nil] The subtotal to show to the creator (excluding buyer fees).
+      #
+      #   @param total [Float, nil] The total to show to the creator (excluding buyer fees).
+      #
+      #   @param usd_total [Float, nil] The total in USD to show to the creator (excluding buyer fees).
+      #
+      #   @param user [WhopSDK::Models::Payment::User, nil] The user that made this payment.
+      #
+      #   @param voidable [Boolean] Whether the payment can be voided.
+
+      # @see WhopSDK::Models::Payment#billing_address
+      class BillingAddress < WhopSDK::Internal::Type::BaseModel
+        # @!attribute city
+        #   The city of the address.
+        #
+        #   @return [String, nil]
+        required :city, String, nil?: true
+
+        # @!attribute country
+        #   The country of the address.
+        #
+        #   @return [String, nil]
+        required :country, String, nil?: true
+
+        # @!attribute line1
+        #   The line 1 of the address.
+        #
+        #   @return [String, nil]
+        required :line1, String, nil?: true
+
+        # @!attribute line2
+        #   The line 2 of the address.
+        #
+        #   @return [String, nil]
+        required :line2, String, nil?: true
+
+        # @!attribute name
+        #   The name of the customer.
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
+        # @!attribute postal_code
+        #   The postal code of the address.
+        #
+        #   @return [String, nil]
+        required :postal_code, String, nil?: true
+
+        # @!attribute state
+        #   The state of the address.
+        #
+        #   @return [String, nil]
+        required :state, String, nil?: true
+
+        # @!method initialize(city:, country:, line1:, line2:, name:, postal_code:, state:)
+        #   The address of the user who made the payment.
+        #
+        #   @param city [String, nil] The city of the address.
+        #
+        #   @param country [String, nil] The country of the address.
+        #
+        #   @param line1 [String, nil] The line 1 of the address.
+        #
+        #   @param line2 [String, nil] The line 2 of the address.
+        #
+        #   @param name [String, nil] The name of the customer.
+        #
+        #   @param postal_code [String, nil] The postal code of the address.
+        #
+        #   @param state [String, nil] The state of the address.
+      end
+
+      # @see WhopSDK::Models::Payment#company
+      class Company < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the company
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute route
+        #   The slug/route of the company on the Whop site.
+        #
+        #   @return [String]
+        required :route, String
+
+        # @!attribute title
+        #   The written name of the company.
+        #
+        #   @return [String]
+        required :title, String
+
+        # @!method initialize(id:, route:, title:)
+        #   The company for the payment.
+        #
+        #   @param id [String] The ID of the company
+        #
+        #   @param route [String] The slug/route of the company on the Whop site.
+        #
+        #   @param title [String] The written name of the company.
+      end
+
+      # @see WhopSDK::Models::Payment#member
+      class Member < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the member
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute phone
+        #   The phone number for the member, if available.
+        #
+        #   @return [String, nil]
+        required :phone, String, nil?: true
+
+        # @!method initialize(id:, phone:)
+        #   The member attached to this payment.
+        #
+        #   @param id [String] The ID of the member
+        #
+        #   @param phone [String, nil] The phone number for the member, if available.
+      end
+
+      # @see WhopSDK::Models::Payment#membership
+      class Membership < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The internal ID of the membership.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute status
+        #   The state of the membership.
+        #
+        #   @return [Symbol, WhopSDK::Models::MembershipStatus]
+        required :status, enum: -> { WhopSDK::MembershipStatus }
+
+        # @!method initialize(id:, status:)
+        #   The membership attached to this payment.
+        #
+        #   @param id [String] The internal ID of the membership.
+        #
+        #   @param status [Symbol, WhopSDK::Models::MembershipStatus] The state of the membership.
+      end
+
+      # @see WhopSDK::Models::Payment#plan
+      class Plan < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The internal ID of the plan.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:)
+        #   The plan attached to this payment.
+        #
+        #   @param id [String] The internal ID of the plan.
+      end
+
+      # @see WhopSDK::Models::Payment#product
+      class Product < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The internal ID of the public product.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute route
+        #   The route of the product.
+        #
+        #   @return [String]
+        required :route, String
+
+        # @!attribute title
+        #   The title of the product. Use for Whop 4.0.
+        #
+        #   @return [String]
+        required :title, String
+
+        # @!method initialize(id:, route:, title:)
+        #   The access pass attached to this payment.
+        #
+        #   @param id [String] The internal ID of the public product.
+        #
+        #   @param route [String] The route of the product.
+        #
+        #   @param title [String] The title of the product. Use for Whop 4.0.
+      end
+
+      # @see WhopSDK::Models::Payment#promo_code
+      class PromoCode < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the promo.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute amount_off
+        #   The amount off (% or flat amount) for the promo.
+        #
+        #   @return [Float]
+        required :amount_off, Float
+
+        # @!attribute base_currency
+        #   The monetary currency of the promo code.
+        #
+        #   @return [Symbol, WhopSDK::Models::Currency]
+        required :base_currency, enum: -> { WhopSDK::Currency }
+
+        # @!attribute code
+        #   The specific code used to apply the promo at checkout.
+        #
+        #   @return [String, nil]
+        required :code, String, nil?: true
+
+        # @!attribute number_of_intervals
+        #   The number of billing cycles the promo is applied for.
+        #
+        #   @return [Integer, nil]
+        required :number_of_intervals, Integer, nil?: true
+
+        # @!attribute promo_type
+        #   The type (% or flat amount) of the promo.
+        #
+        #   @return [Symbol, WhopSDK::Models::PromoType]
+        required :promo_type, enum: -> { WhopSDK::PromoType }
+
+        # @!method initialize(id:, amount_off:, base_currency:, code:, number_of_intervals:, promo_type:)
+        #   The promo code used for this payment.
+        #
+        #   @param id [String] The ID of the promo.
+        #
+        #   @param amount_off [Float] The amount off (% or flat amount) for the promo.
+        #
+        #   @param base_currency [Symbol, WhopSDK::Models::Currency] The monetary currency of the promo code.
+        #
+        #   @param code [String, nil] The specific code used to apply the promo at checkout.
+        #
+        #   @param number_of_intervals [Integer, nil] The number of billing cycles the promo is applied for.
+        #
+        #   @param promo_type [Symbol, WhopSDK::Models::PromoType] The type (% or flat amount) of the promo.
+      end
+
+      # @see WhopSDK::Models::Payment#user
+      class User < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The internal ID of the user.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute email
+        #   The email of the user
+        #
+        #   @return [String, nil]
+        required :email, String, nil?: true
+
+        # @!attribute name
+        #   The name of the user from their Whop account.
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
+        # @!attribute username
+        #   The username of the user from their Whop account.
+        #
+        #   @return [String]
+        required :username, String
+
+        # @!method initialize(id:, email:, name:, username:)
+        #   The user that made this payment.
+        #
+        #   @param id [String] The internal ID of the user.
+        #
+        #   @param email [String, nil] The email of the user
+        #
+        #   @param name [String, nil] The name of the user from their Whop account.
+        #
+        #   @param username [String] The username of the user from their Whop account.
+      end
+    end
+  end
+end

data/lib/whop_sdk/models/payment_failed_webhook_event.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    class PaymentFailedWebhookEvent < WhopSDK::Internal::Type::BaseModel
+      # @!attribute id
+      #   A unique ID for every single webhook request
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute api_version
+      #   The API version for this webhook
+      #
+      #   @return [Symbol, :v1]
+      required :api_version, const: :v1
+
+      # @!attribute data
+      #   An object representing a receipt for a membership.
+      #
+      #   @return [WhopSDK::Models::Payment]
+      required :data, -> { WhopSDK::Payment }
+
+      # @!attribute timestamp
+      #   The timestamp in ISO 8601 format that the webhook was sent at on the server
+      #
+      #   @return [Time]
+      required :timestamp, Time
+
+      # @!attribute type
+      #   The webhook event type
+      #
+      #   @return [Symbol, :"payment.failed"]
+      required :type, const: :"payment.failed"
+
+      # @!method initialize(id:, data:, timestamp:, api_version: :v1, type: :"payment.failed")
+      #   @param id [String] A unique ID for every single webhook request
+      #
+      #   @param data [WhopSDK::Models::Payment] An object representing a receipt for a membership.
+      #
+      #   @param timestamp [Time] The timestamp in ISO 8601 format that the webhook was sent at on the server
+      #
+      #   @param api_version [Symbol, :v1] The API version for this webhook
+      #
+      #   @param type [Symbol, :"payment.failed"] The webhook event type
+    end
+  end
+end