whop_sdk 0.0.39 → 0.0.41

data/rbi/whop_sdk/models/payment.rbi

@@ -69,8 +69,8 @@ module WhopSDK
       sig { returns(Time) }
       attr_accessor :created_at
 
-      # The available currencies on the platform
-      sig { returns(T.nilable(WhopSDK::Currency::TaggedSymbol)) }
+      # The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
+      sig { returns(WhopSDK::Currency::TaggedSymbol) }
       attr_accessor :currency
 
       # When an alert came in that this transaction will be disputed
@@ -186,6 +186,11 @@ module WhopSDK
       sig { returns(T.nilable(Time)) }
       attr_accessor :refunded_at
 
+      # The refunds issued against this payment, newest first, including failed and
+      # canceled refund attempts. Limited to the 100 most recent.
+      sig { returns(T::Array[WhopSDK::Payment::Refund]) }
+      attr_accessor :refunds
+
       # The resolution center cases opened by the customer on this payment. Null if the
       # actor in context does not have the payment:resolution_center_case:read
       # permission.
@@ -198,22 +203,43 @@ module WhopSDK
       sig { returns(T::Boolean) }
       attr_accessor :retryable
 
-      # The payment amount in the creator's settlement currency (what the creator priced
-      # in). Equal to final_amount for single-currency payments.
+      # Whop's in-house fraud risk score for this payment, from 0 (lowest risk) to 100
+      # (highest risk). Null when the payment has not been scored or scoring has not yet
+      # completed.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :risk_score
+
+      # A curated set of factors behind the risk score, grouped by category (business
+      # transaction history, buyer, device). Each entry has a key, human-readable label,
+      # category, and value. Null when there is no risk assessment for this payment.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :risk_signals
+
+      # The total amount charged to the customer for this payment, including taxes and
+      # after any discounts. In the currency specified by the currency field.
       sig { returns(Float) }
       attr_accessor :settlement_amount
 
-      # The currency in which the creator receives payouts and fees are charged (e.g.,
-      # 'usd', 'eur'). For multi-currency payments this differs from the payment
-      # currency.
-      sig { returns(String) }
+      # The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
+      sig { returns(WhopSDK::Currency::TaggedSymbol) }
       attr_accessor :settlement_currency
 
-      # The locked exchange rate used to convert from the buyer's payment currency to
-      # the creator's settlement currency. Null for single-currency payments.
+      # Deprecated. Always returns null.
       sig { returns(T.nilable(Float)) }
       attr_accessor :settlement_exchange_rate
 
+      # The shipping address provided by the customer for physical goods. Null if no
+      # shipping address was collected.
+      sig { returns(T.nilable(WhopSDK::Payment::ShippingAddress)) }
+      attr_reader :shipping_address
+
+      sig do
+        params(
+          shipping_address: T.nilable(WhopSDK::Payment::ShippingAddress::OrHash)
+        ).void
+      end
+      attr_writer :shipping_address
+
       # The status of a receipt
       sig { returns(T.nilable(WhopSDK::ReceiptStatus::TaggedSymbol)) }
       attr_accessor :status
@@ -239,6 +265,10 @@ module WhopSDK
       sig { returns(T.nilable(Float)) }
       attr_accessor :tax_refunded_amount
 
+      # Whether 3D Secure authentication was completed for this payment.
+      sig { returns(T::Boolean) }
+      attr_accessor :three_ds_verified
+
       # The total to show to the creator (excluding buyer fees).
       sig { returns(T.nilable(Float)) }
       attr_accessor :total
@@ -278,7 +308,7 @@ module WhopSDK
           checkout_configuration_id: T.nilable(String),
           company: T.nilable(WhopSDK::Payment::Company::OrHash),
           created_at: Time,
-          currency: T.nilable(WhopSDK::Currency::OrSymbol),
+          currency: WhopSDK::Currency::OrSymbol,
           dispute_alerted_at: T.nilable(Time),
           disputes: T.nilable(T::Array[WhopSDK::Payment::Dispute::OrHash]),
           failure_message: T.nilable(String),
@@ -300,18 +330,24 @@ module WhopSDK
           refundable: T::Boolean,
           refunded_amount: T.nilable(Float),
           refunded_at: T.nilable(Time),
+          refunds: T::Array[WhopSDK::Payment::Refund::OrHash],
           resolutions:
             T.nilable(T::Array[WhopSDK::Payment::Resolution::OrHash]),
           retryable: T::Boolean,
+          risk_score: T.nilable(Integer),
+          risk_signals: T.nilable(T::Hash[Symbol, T.anything]),
           settlement_amount: Float,
-          settlement_currency: String,
+          settlement_currency: WhopSDK::Currency::OrSymbol,
           settlement_exchange_rate: T.nilable(Float),
+          shipping_address:
+            T.nilable(WhopSDK::Payment::ShippingAddress::OrHash),
           status: T.nilable(WhopSDK::ReceiptStatus::OrSymbol),
           substatus: WhopSDK::FriendlyReceiptStatus::OrSymbol,
           subtotal: T.nilable(Float),
           tax_amount: T.nilable(Float),
           tax_behavior: T.nilable(WhopSDK::ReceiptTaxBehavior::OrSymbol),
           tax_refunded_amount: T.nilable(Float),
+          three_ds_verified: T::Boolean,
           total: T.nilable(Float),
           updated_at: Time,
           usd_total: T.nilable(Float),
@@ -344,7 +380,7 @@ module WhopSDK
         company:,
         # The datetime the payment was created.
         created_at:,
-        # The available currencies on the platform
+        # The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
         currency:,
         # When an alert came in that this transaction will be disputed
         dispute_alerted_at:,
@@ -393,6 +429,9 @@ module WhopSDK
         refunded_amount:,
         # When the payment was refunded (if applicable).
         refunded_at:,
+        # The refunds issued against this payment, newest first, including failed and
+        # canceled refund attempts. Limited to the 100 most recent.
+        refunds:,
         # The resolution center cases opened by the customer on this payment. Null if the
         # actor in context does not have the payment:resolution_center_case:read
         # permission.
@@ -401,16 +440,24 @@ module WhopSDK
         # retry-eligible states (`active`, `trialing`, `completed`, or `past_due`);
         # otherwise false. Used to decide if Whop can attempt the charge again.
         retryable:,
-        # The payment amount in the creator's settlement currency (what the creator priced
-        # in). Equal to final_amount for single-currency payments.
+        # Whop's in-house fraud risk score for this payment, from 0 (lowest risk) to 100
+        # (highest risk). Null when the payment has not been scored or scoring has not yet
+        # completed.
+        risk_score:,
+        # A curated set of factors behind the risk score, grouped by category (business
+        # transaction history, buyer, device). Each entry has a key, human-readable label,
+        # category, and value. Null when there is no risk assessment for this payment.
+        risk_signals:,
+        # The total amount charged to the customer for this payment, including taxes and
+        # after any discounts. In the currency specified by the currency field.
         settlement_amount:,
-        # The currency in which the creator receives payouts and fees are charged (e.g.,
-        # 'usd', 'eur'). For multi-currency payments this differs from the payment
-        # currency.
+        # The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
         settlement_currency:,
-        # The locked exchange rate used to convert from the buyer's payment currency to
-        # the creator's settlement currency. Null for single-currency payments.
+        # Deprecated. Always returns null.
         settlement_exchange_rate:,
+        # The shipping address provided by the customer for physical goods. Null if no
+        # shipping address was collected.
+        shipping_address:,
         # The status of a receipt
         status:,
         # The friendly status of the payment.
@@ -424,6 +471,8 @@ module WhopSDK
         tax_behavior:,
         # The amount of tax that has been refunded (if applicable).
         tax_refunded_amount:,
+        # Whether 3D Secure authentication was completed for this payment.
+        three_ds_verified:,
         # The total to show to the creator (excluding buyer fees).
         total:,
         # The datetime the payment was last updated.
@@ -452,7 +501,7 @@ module WhopSDK
             checkout_configuration_id: T.nilable(String),
             company: T.nilable(WhopSDK::Payment::Company),
             created_at: Time,
-            currency: T.nilable(WhopSDK::Currency::TaggedSymbol),
+            currency: WhopSDK::Currency::TaggedSymbol,
             dispute_alerted_at: T.nilable(Time),
             disputes: T.nilable(T::Array[WhopSDK::Payment::Dispute]),
             failure_message: T.nilable(String),
@@ -475,17 +524,22 @@ module WhopSDK
             refundable: T::Boolean,
             refunded_amount: T.nilable(Float),
             refunded_at: T.nilable(Time),
+            refunds: T::Array[WhopSDK::Payment::Refund],
             resolutions: T.nilable(T::Array[WhopSDK::Payment::Resolution]),
             retryable: T::Boolean,
+            risk_score: T.nilable(Integer),
+            risk_signals: T.nilable(T::Hash[Symbol, T.anything]),
             settlement_amount: Float,
-            settlement_currency: String,
+            settlement_currency: WhopSDK::Currency::TaggedSymbol,
             settlement_exchange_rate: T.nilable(Float),
+            shipping_address: T.nilable(WhopSDK::Payment::ShippingAddress),
             status: T.nilable(WhopSDK::ReceiptStatus::TaggedSymbol),
             substatus: WhopSDK::FriendlyReceiptStatus::TaggedSymbol,
             subtotal: T.nilable(Float),
             tax_amount: T.nilable(Float),
             tax_behavior: T.nilable(WhopSDK::ReceiptTaxBehavior::TaggedSymbol),
             tax_refunded_amount: T.nilable(Float),
+            three_ds_verified: T::Boolean,
             total: T.nilable(Float),
             updated_at: Time,
             usd_total: T.nilable(Float),
@@ -708,8 +762,7 @@ module WhopSDK
         sig { returns(WhopSDK::Currency::TaggedSymbol) }
         attr_accessor :currency
 
-        # Whether the dispute evidence can still be edited and submitted. Returns true
-        # only when the dispute status requires a response.
+        # Whether the dispute evidence can still be edited and submitted.
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :editable
 
@@ -753,8 +806,7 @@ module WhopSDK
           amount:,
           # The three-letter ISO currency code for the disputed amount.
           currency:,
-          # Whether the dispute evidence can still be edited and submitted. Returns true
-          # only when the dispute status requires a response.
+          # Whether the dispute evidence can still be edited and submitted.
           editable:,
           # The deadline by which dispute evidence must be submitted. Null if no response
           # deadline is set.
@@ -1068,6 +1120,10 @@ module WhopSDK
         sig { returns(String) }
         attr_accessor :id
 
+        # The phone number associated with this membership.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone_number
+
         # The state of the membership.
         sig { returns(WhopSDK::MembershipStatus::TaggedSymbol) }
         attr_accessor :status
@@ -1076,12 +1132,15 @@ module WhopSDK
         sig do
           params(
             id: String,
+            phone_number: T.nilable(String),
             status: WhopSDK::MembershipStatus::OrSymbol
           ).returns(T.attached_class)
         end
         def self.new(
           # The unique identifier for the membership.
           id:,
+          # The phone number associated with this membership.
+          phone_number:,
           # The state of the membership.
           status:
         )
@@ -1089,7 +1148,11 @@ module WhopSDK
 
         sig do
           override.returns(
-            { id: String, status: WhopSDK::MembershipStatus::TaggedSymbol }
+            {
+              id: String,
+              phone_number: T.nilable(String),
+              status: WhopSDK::MembershipStatus::TaggedSymbol
+            }
           )
         end
         def to_hash
@@ -1237,22 +1300,40 @@ module WhopSDK
         sig { returns(T.nilable(String)) }
         attr_accessor :internal_notes
 
+        # Custom key-value pairs stored on the plan. Included in webhook payloads for
+        # payment and membership events. Max 50 keys, 100 chars per key, 500 chars per
+        # string value.
+        sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+        attr_accessor :metadata
+
         # The plan attached to this payment.
         sig do
-          params(id: String, internal_notes: T.nilable(String)).returns(
-            T.attached_class
-          )
+          params(
+            id: String,
+            internal_notes: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, T.anything])
+          ).returns(T.attached_class)
         end
         def self.new(
           # The unique identifier for the plan.
           id:,
           # A personal description or notes section for the business.
-          internal_notes:
+          internal_notes:,
+          # Custom key-value pairs stored on the plan. Included in webhook payloads for
+          # payment and membership events. Max 50 keys, 100 chars per key, 500 chars per
+          # string value.
+          metadata:
         )
         end
 
         sig do
-          override.returns({ id: String, internal_notes: T.nilable(String) })
+          override.returns(
+            {
+              id: String,
+              internal_notes: T.nilable(String),
+              metadata: T.nilable(T::Hash[Symbol, T.anything])
+            }
+          )
         end
         def to_hash
         end
@@ -1268,8 +1349,14 @@ module WhopSDK
         sig { returns(String) }
         attr_accessor :id
 
-        # The URL slug used in the product's public link (e.g., 'my-product' in
-        # whop.com/company/my-product).
+        # Custom key-value pairs stored on the product and included in payment and
+        # membership webhook payloads. Max 50 keys, 100 characters per key, 500 characters
+        # per string value.
+        sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+        attr_accessor :metadata
+
+        # URL slug in the product's public link, e.g. `pickaxe-analytics` in
+        # whop.com/company/pickaxe-analytics.
         sig { returns(String) }
         attr_accessor :route
 
@@ -1280,15 +1367,22 @@ module WhopSDK
 
         # The product this payment was made for
         sig do
-          params(id: String, route: String, title: String).returns(
-            T.attached_class
-          )
+          params(
+            id: String,
+            metadata: T.nilable(T::Hash[Symbol, T.anything]),
+            route: String,
+            title: String
+          ).returns(T.attached_class)
         end
         def self.new(
           # The unique identifier for the product.
           id:,
-          # The URL slug used in the product's public link (e.g., 'my-product' in
-          # whop.com/company/my-product).
+          # Custom key-value pairs stored on the product and included in payment and
+          # membership webhook payloads. Max 50 keys, 100 characters per key, 500 characters
+          # per string value.
+          metadata:,
+          # URL slug in the product's public link, e.g. `pickaxe-analytics` in
+          # whop.com/company/pickaxe-analytics.
           route:,
           # The display name of the product shown to customers on the product page and in
           # search results.
@@ -1296,7 +1390,16 @@ module WhopSDK
         )
         end
 
-        sig { override.returns({ id: String, route: String, title: String }) }
+        sig do
+          override.returns(
+            {
+              id: String,
+              metadata: T.nilable(T::Hash[Symbol, T.anything]),
+              route: String,
+              title: String
+            }
+          )
+        end
         def to_hash
         end
       end
@@ -1378,6 +1481,76 @@ module WhopSDK
         end
       end
 
+      class Refund < WhopSDK::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(WhopSDK::Payment::Refund, WhopSDK::Internal::AnyHash)
+          end
+
+        # The unique identifier for the refund.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The refunded amount as a decimal in the specified currency, such as 10.43 for
+        # $10.43 USD.
+        sig { returns(Float) }
+        attr_accessor :amount
+
+        # The datetime the refund was created.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # The three-letter ISO currency code for the refunded amount.
+        sig { returns(WhopSDK::Currency::TaggedSymbol) }
+        attr_accessor :currency
+
+        # The current processing status of the refund, such as pending, succeeded, or
+        # failed.
+        sig { returns(WhopSDK::RefundStatus::TaggedSymbol) }
+        attr_accessor :status
+
+        # A refund represents a full or partial reversal of a payment, including the
+        # amount, status, and payment provider.
+        sig do
+          params(
+            id: String,
+            amount: Float,
+            created_at: Time,
+            currency: WhopSDK::Currency::OrSymbol,
+            status: WhopSDK::RefundStatus::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The unique identifier for the refund.
+          id:,
+          # The refunded amount as a decimal in the specified currency, such as 10.43 for
+          # $10.43 USD.
+          amount:,
+          # The datetime the refund was created.
+          created_at:,
+          # The three-letter ISO currency code for the refunded amount.
+          currency:,
+          # The current processing status of the refund, such as pending, succeeded, or
+          # failed.
+          status:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              amount: Float,
+              created_at: Time,
+              currency: WhopSDK::Currency::TaggedSymbol,
+              status: WhopSDK::RefundStatus::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
       class Resolution < WhopSDK::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -1512,6 +1685,88 @@ module WhopSDK
         end
       end
 
+      class ShippingAddress < WhopSDK::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(WhopSDK::Payment::ShippingAddress, WhopSDK::Internal::AnyHash)
+          end
+
+        # The city of the address.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :city
+
+        # The country of the address.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :country
+
+        # The line 1 of the address.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :line1
+
+        # The line 2 of the address.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :line2
+
+        # The name of the customer.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        # The postal code of the address.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :postal_code
+
+        # The state of the address.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :state
+
+        # The shipping address provided by the customer for physical goods. Null if no
+        # shipping address was collected.
+        sig do
+          params(
+            city: T.nilable(String),
+            country: T.nilable(String),
+            line1: T.nilable(String),
+            line2: T.nilable(String),
+            name: T.nilable(String),
+            postal_code: T.nilable(String),
+            state: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The city of the address.
+          city:,
+          # The country of the address.
+          country:,
+          # The line 1 of the address.
+          line1:,
+          # The line 2 of the address.
+          line2:,
+          # The name of the customer.
+          name:,
+          # The postal code of the address.
+          postal_code:,
+          # The state of the address.
+          state:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              city: T.nilable(String),
+              country: T.nilable(String),
+              line1: T.nilable(String),
+              line2: T.nilable(String),
+              name: T.nilable(String),
+              postal_code: T.nilable(String),
+              state: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
       class User < WhopSDK::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/whop_sdk/models/payment_create_params.rbi

@@ -108,6 +108,12 @@ module WhopSDK
           sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
           attr_accessor :metadata
 
+          # The ID of an active promo code to apply to this payment. The promo code must
+          # belong to the company and be valid for the plan being purchased. The plan must
+          # be attached to a product — promo codes are not eligible for one-off purchases.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :promo_code_id
+
           # Autogenerated input type of CreatePayment
           sig do
             params(
@@ -116,7 +122,8 @@ module WhopSDK
               payment_method_id: String,
               plan:
                 WhopSDK::PaymentCreateParams::Body::CreatePaymentInputWithPlan::Plan::OrHash,
-              metadata: T.nilable(T::Hash[Symbol, T.anything])
+              metadata: T.nilable(T::Hash[Symbol, T.anything]),
+              promo_code_id: T.nilable(String)
             ).returns(T.attached_class)
           end
           def self.new(
@@ -130,7 +137,11 @@ module WhopSDK
             # Pass this object to create a new plan for this payment
             plan:,
             # Custom metadata to attach to the payment.
-            metadata: nil
+            metadata: nil,
+            # The ID of an active promo code to apply to this payment. The promo code must
+            # belong to the company and be valid for the plan being purchased. The plan must
+            # be attached to a product — promo codes are not eligible for one-off purchases.
+            promo_code_id: nil
           )
           end
 
@@ -142,7 +153,8 @@ module WhopSDK
                 payment_method_id: String,
                 plan:
                   WhopSDK::PaymentCreateParams::Body::CreatePaymentInputWithPlan::Plan,
-                metadata: T.nilable(T::Hash[Symbol, T.anything])
+                metadata: T.nilable(T::Hash[Symbol, T.anything]),
+                promo_code_id: T.nilable(String)
               }
             )
           end
@@ -505,6 +517,12 @@ module WhopSDK
           sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
           attr_accessor :metadata
 
+          # The ID of an active promo code to apply to this payment. The promo code must
+          # belong to the company and be valid for the plan being purchased. The plan must
+          # be attached to a product — promo codes are not eligible for one-off purchases.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :promo_code_id
+
           # Autogenerated input type of CreatePayment
           sig do
             params(
@@ -512,7 +530,8 @@ module WhopSDK
               member_id: String,
               payment_method_id: String,
               plan_id: String,
-              metadata: T.nilable(T::Hash[Symbol, T.anything])
+              metadata: T.nilable(T::Hash[Symbol, T.anything]),
+              promo_code_id: T.nilable(String)
             ).returns(T.attached_class)
           end
           def self.new(
@@ -526,7 +545,11 @@ module WhopSDK
             # An ID of an existing plan to use for the payment.
             plan_id:,
             # Custom metadata to attach to the payment.
-            metadata: nil
+            metadata: nil,
+            # The ID of an active promo code to apply to this payment. The promo code must
+            # belong to the company and be valid for the plan being purchased. The plan must
+            # be attached to a product — promo codes are not eligible for one-off purchases.
+            promo_code_id: nil
           )
           end
 
@@ -537,7 +560,8 @@ module WhopSDK
                 member_id: String,
                 payment_method_id: String,
                 plan_id: String,
-                metadata: T.nilable(T::Hash[Symbol, T.anything])
+                metadata: T.nilable(T::Hash[Symbol, T.anything]),
+                promo_code_id: T.nilable(String)
               }
             )
           end

data/rbi/whop_sdk/models/payment_list_params.rbi

@@ -23,6 +23,10 @@ module WhopSDK
       sig { returns(T.nilable(T::Array[WhopSDK::BillingReasons::OrSymbol])) }
       attr_accessor :billing_reasons
 
+      # Only return payments from these checkout configurations.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :checkout_configuration_ids
+
       # The unique identifier of the company to list payments for.
       sig { returns(T.nilable(String)) }
       attr_accessor :company_id
@@ -97,6 +101,7 @@ module WhopSDK
           before: T.nilable(String),
           billing_reasons:
             T.nilable(T::Array[WhopSDK::BillingReasons::OrSymbol]),
+          checkout_configuration_ids: T.nilable(T::Array[String]),
           company_id: T.nilable(String),
           created_after: T.nilable(Time),
           created_before: T.nilable(Time),
@@ -124,6 +129,8 @@ module WhopSDK
         before: nil,
         # Filter payments by their billing reason.
         billing_reasons: nil,
+        # Only return payments from these checkout configurations.
+        checkout_configuration_ids: nil,
         # The unique identifier of the company to list payments for.
         company_id: nil,
         # Only return payments created after this timestamp.
@@ -169,6 +176,7 @@ module WhopSDK
             before: T.nilable(String),
             billing_reasons:
               T.nilable(T::Array[WhopSDK::BillingReasons::OrSymbol]),
+            checkout_configuration_ids: T.nilable(T::Array[String]),
             company_id: T.nilable(String),
             created_after: T.nilable(Time),
             created_before: T.nilable(Time),