dodopayments 2.26.0 → 2.27.0

data/lib/dodopayments/resources/webhooks.rb

@@ -170,7 +170,7 @@ module Dodopayments
 
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::PayoutCreatedWebhookEvent, Dodopayments::Models::PayoutFailedWebhookEvent, Dodopayments::Models::PayoutInProgressWebhookEvent, Dodopayments::Models::PayoutOnHoldWebhookEvent, Dodopayments::Models::PayoutSuccessWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPausedWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUnpausedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
+      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::PayoutCreatedWebhookEvent, Dodopayments::Models::PayoutFailedWebhookEvent, Dodopayments::Models::PayoutInProgressWebhookEvent, Dodopayments::Models::PayoutOnHoldWebhookEvent, Dodopayments::Models::PayoutSuccessWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPastDueWebhookEvent, Dodopayments::Models::SubscriptionPausedWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUnpausedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
       def unsafe_unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         Dodopayments::Internal::Type::Converter.coerce(Dodopayments::Models::UnsafeUnwrapWebhookEvent, parsed)
@@ -182,7 +182,7 @@ module Dodopayments
       #
       # @param key [String, nil] The webhook signing key
       #
-      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::PayoutCreatedWebhookEvent, Dodopayments::Models::PayoutFailedWebhookEvent, Dodopayments::Models::PayoutInProgressWebhookEvent, Dodopayments::Models::PayoutOnHoldWebhookEvent, Dodopayments::Models::PayoutSuccessWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPausedWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUnpausedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
+      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::PayoutCreatedWebhookEvent, Dodopayments::Models::PayoutFailedWebhookEvent, Dodopayments::Models::PayoutInProgressWebhookEvent, Dodopayments::Models::PayoutOnHoldWebhookEvent, Dodopayments::Models::PayoutSuccessWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPastDueWebhookEvent, Dodopayments::Models::SubscriptionPausedWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUnpausedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
       def unwrap(payload, headers:, key: @client.webhook_key)
         if key.nil?
           raise ArgumentError.new("Cannot verify a webhook without a key on either the client's webhook_key or passed in as an argument")

data/lib/dodopayments/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dodopayments
-  VERSION = "2.26.0"
+  VERSION = "2.27.0"
 end

data/lib/dodopayments.rb

@@ -55,15 +55,19 @@ require_relative "dodopayments/internal/transport/pooled_net_requester"
 require_relative "dodopayments/client"
 require_relative "dodopayments/internal/cursor_page_pagination"
 require_relative "dodopayments/internal/default_page_number_pagination"
+require_relative "dodopayments/models/blocklist/block_by_email"
+require_relative "dodopayments/models/blocklist/block_by_customer_id"
+require_relative "dodopayments/models/blocklist/create_blocked_customer_request"
+require_relative "dodopayments/models/blocklist/customers/note_request"
 require_relative "dodopayments/models/checkout_session_request"
 require_relative "dodopayments/models/product_collections/product_collection_group_details"
+require_relative "dodopayments/models/subscription"
 require_relative "dodopayments/models/update_subscription_plan_req"
 require_relative "dodopayments/models/entitlements/entitlement_grant"
 require_relative "dodopayments/models/credit_entitlements/credit_ledger_entry"
 require_relative "dodopayments/models/license_key"
 require_relative "dodopayments/models/get_dispute"
 require_relative "dodopayments/models/refund"
-require_relative "dodopayments/models/subscription"
 require_relative "dodopayments/models/payment"
 require_relative "dodopayments/models/abandoned_checkout_detected_webhook_event"
 require_relative "dodopayments/models/abandoned_checkout_recovered_webhook_event"
@@ -83,6 +87,16 @@ require_relative "dodopayments/models/attach_product_entitlement"
 require_relative "dodopayments/models/balance_ledger_entry"
 require_relative "dodopayments/models/balance_retrieve_ledger_params"
 require_relative "dodopayments/models/billing_address"
+require_relative "dodopayments/models/blocklist/blocked_customer"
+require_relative "dodopayments/models/blocklist/blocked_customer_source"
+require_relative "dodopayments/models/blocklist/block_identifier"
+require_relative "dodopayments/models/blocklist/customer_create_params"
+require_relative "dodopayments/models/blocklist/customer_delete_params"
+require_relative "dodopayments/models/blocklist/customer_list_params"
+require_relative "dodopayments/models/blocklist/customer_retrieve_params"
+require_relative "dodopayments/models/blocklist/customers/blocked_customer_note"
+require_relative "dodopayments/models/blocklist/customers/note_create_params"
+require_relative "dodopayments/models/blocklist/customers/note_update_params"
 require_relative "dodopayments/models/brand"
 require_relative "dodopayments/models/brand_archive_params"
 require_relative "dodopayments/models/brand_archive_response"
@@ -234,6 +248,8 @@ require_relative "dodopayments/models/license_key_status"
 require_relative "dodopayments/models/license_key_update_params"
 require_relative "dodopayments/models/license_validate_params"
 require_relative "dodopayments/models/license_validate_response"
+require_relative "dodopayments/models/manual_retry"
+require_relative "dodopayments/models/manual_retry_state"
 require_relative "dodopayments/models/metadata"
 require_relative "dodopayments/models/meter"
 require_relative "dodopayments/models/meter_aggregation"
@@ -262,6 +278,8 @@ require_relative "dodopayments/models/payment_refund_status"
 require_relative "dodopayments/models/payment_retrieve_line_items_params"
 require_relative "dodopayments/models/payment_retrieve_line_items_response"
 require_relative "dodopayments/models/payment_retrieve_params"
+require_relative "dodopayments/models/payment_retrieve_retry_state_params"
+require_relative "dodopayments/models/payment_retry_params"
 require_relative "dodopayments/models/payment_succeeded_webhook_event"
 require_relative "dodopayments/models/payout_created_webhook_event"
 require_relative "dodopayments/models/payout_failed_webhook_event"
@@ -346,6 +364,7 @@ require_relative "dodopayments/models/subscription_failed_webhook_event"
 require_relative "dodopayments/models/subscription_list_params"
 require_relative "dodopayments/models/subscription_list_response"
 require_relative "dodopayments/models/subscription_on_hold_webhook_event"
+require_relative "dodopayments/models/subscription_past_due_webhook_event"
 require_relative "dodopayments/models/subscription_paused_webhook_event"
 require_relative "dodopayments/models/subscription_plan_changed_webhook_event"
 require_relative "dodopayments/models/subscription_preview_change_plan_params"
@@ -391,6 +410,9 @@ require_relative "dodopayments/models/webhook_update_params"
 require_relative "dodopayments/models"
 require_relative "dodopayments/resources/addons"
 require_relative "dodopayments/resources/balances"
+require_relative "dodopayments/resources/blocklist"
+require_relative "dodopayments/resources/blocklist/customers"
+require_relative "dodopayments/resources/blocklist/customers/notes"
 require_relative "dodopayments/resources/brands"
 require_relative "dodopayments/resources/checkout_sessions"
 require_relative "dodopayments/resources/credit_entitlements"

data/rbi/dodopayments/client.rbi

@@ -50,6 +50,9 @@ module Dodopayments
     sig { returns(Dodopayments::Resources::Customers) }
     attr_reader :customers
 
+    sig { returns(Dodopayments::Resources::Blocklist) }
+    attr_reader :blocklist
+
     sig { returns(Dodopayments::Resources::Refunds) }
     attr_reader :refunds
 

data/rbi/dodopayments/models/balance_ledger_entry.rbi

@@ -44,6 +44,9 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :description
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :payout_id
+
       sig { returns(T.nilable(String)) }
       attr_accessor :reference_object_id
 
@@ -60,6 +63,7 @@ module Dodopayments
           after_balance: T.nilable(Integer),
           before_balance: T.nilable(Integer),
           description: T.nilable(String),
+          payout_id: T.nilable(String),
           reference_object_id: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -75,6 +79,7 @@ module Dodopayments
         after_balance: nil,
         before_balance: nil,
         description: nil,
+        payout_id: nil,
         reference_object_id: nil
       )
       end
@@ -94,6 +99,7 @@ module Dodopayments
             after_balance: T.nilable(Integer),
             before_balance: T.nilable(Integer),
             description: T.nilable(String),
+            payout_id: T.nilable(String),
             reference_object_id: T.nilable(String)
           }
         )

data/rbi/dodopayments/models/blocklist/block_by_customer_id.rbi

@@ -0,0 +1,32 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Blocklist
+      class BlockByCustomerID < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Blocklist::BlockByCustomerID,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Customer to block. The block still applies to that customer's email.
+        sig { returns(String) }
+        attr_accessor :customer_id
+
+        sig { params(customer_id: String).returns(T.attached_class) }
+        def self.new(
+          # Customer to block. The block still applies to that customer's email.
+          customer_id:
+        )
+        end
+
+        sig { override.returns({ customer_id: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/blocklist/block_by_email.rbi

@@ -0,0 +1,32 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Blocklist
+      class BlockByEmail < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Blocklist::BlockByEmail,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Email to block. It must belong to an existing customer of this business.
+        sig { returns(String) }
+        attr_accessor :email
+
+        sig { params(email: String).returns(T.attached_class) }
+        def self.new(
+          # Email to block. It must belong to an existing customer of this business.
+          email:
+        )
+        end
+
+        sig { override.returns({ email: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/blocklist/block_identifier.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Blocklist
+      # Which customer to block. Untagged, so the caller sends `customer_id` or `email`
+      # at the top level, as `CustomerRequest` does on the payment routes. A body that
+      # carries both matches the first variant, so `customer_id` wins.
+      module BlockIdentifier
+        extend Dodopayments::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Dodopayments::Blocklist::BlockByCustomerID,
+              Dodopayments::Blocklist::BlockByEmail
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[Dodopayments::Blocklist::BlockIdentifier::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/blocklist/blocked_customer.rbi

@@ -0,0 +1,161 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Blocklist
+      class BlockedCustomer < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Blocklist::BlockedCustomer,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        sig { returns(String) }
+        attr_accessor :customer_email
+
+        sig { returns(String) }
+        attr_accessor :customer_id
+
+        sig { returns(String) }
+        attr_accessor :customer_name
+
+        # Customer id or email that the merchant supplied.
+        sig { returns(String) }
+        attr_accessor :identifier
+
+        # Where a block came from. `Api` marks an API-key caller, which carries no
+        # dashboard actor. The other values name the screen the merchant used.
+        sig do
+          returns(Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol)
+        end
+        attr_accessor :source
+
+        # Dashboard user who blocked the customer. `null` for an API-key caller.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :blocked_by_email
+
+        # Subscriptions this block cancelled. Present on the create response only.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :cancelled_subscription_ids
+
+        # Activity log. Present on the detail response only.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[Dodopayments::Blocklist::Customers::BlockedCustomerNote]
+            )
+          )
+        end
+        attr_accessor :notes
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :reason
+
+        # Subscriptions this block left live, because the cancel failed or the inline
+        # batch filled up. Repeat the create call to continue; the block itself is already
+        # in force.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :remaining_subscription_ids
+
+        # False when the block left live subscriptions behind, including the case where
+        # the sweep could not list them and `remaining_subscription_ids` is therefore
+        # unknown. Repeat the create call until it reads true.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :subscriptions_swept
+
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :unblocked_at
+
+        sig do
+          params(
+            id: String,
+            created_at: Time,
+            customer_email: String,
+            customer_id: String,
+            customer_name: String,
+            identifier: String,
+            source: Dodopayments::Blocklist::BlockedCustomerSource::OrSymbol,
+            blocked_by_email: T.nilable(String),
+            cancelled_subscription_ids: T.nilable(T::Array[String]),
+            notes:
+              T.nilable(
+                T::Array[
+                  Dodopayments::Blocklist::Customers::BlockedCustomerNote::OrHash
+                ]
+              ),
+            reason: T.nilable(String),
+            remaining_subscription_ids: T.nilable(T::Array[String]),
+            subscriptions_swept: T.nilable(T::Boolean),
+            unblocked_at: T.nilable(Time)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          created_at:,
+          customer_email:,
+          customer_id:,
+          customer_name:,
+          # Customer id or email that the merchant supplied.
+          identifier:,
+          # Where a block came from. `Api` marks an API-key caller, which carries no
+          # dashboard actor. The other values name the screen the merchant used.
+          source:,
+          # Dashboard user who blocked the customer. `null` for an API-key caller.
+          blocked_by_email: nil,
+          # Subscriptions this block cancelled. Present on the create response only.
+          cancelled_subscription_ids: nil,
+          # Activity log. Present on the detail response only.
+          notes: nil,
+          reason: nil,
+          # Subscriptions this block left live, because the cancel failed or the inline
+          # batch filled up. Repeat the create call to continue; the block itself is already
+          # in force.
+          remaining_subscription_ids: nil,
+          # False when the block left live subscriptions behind, including the case where
+          # the sweep could not list them and `remaining_subscription_ids` is therefore
+          # unknown. Repeat the create call until it reads true.
+          subscriptions_swept: nil,
+          unblocked_at: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              customer_email: String,
+              customer_id: String,
+              customer_name: String,
+              identifier: String,
+              source:
+                Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol,
+              blocked_by_email: T.nilable(String),
+              cancelled_subscription_ids: T.nilable(T::Array[String]),
+              notes:
+                T.nilable(
+                  T::Array[
+                    Dodopayments::Blocklist::Customers::BlockedCustomerNote
+                  ]
+                ),
+              reason: T.nilable(String),
+              remaining_subscription_ids: T.nilable(T::Array[String]),
+              subscriptions_swept: T.nilable(T::Boolean),
+              unblocked_at: T.nilable(Time)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/blocklist/blocked_customer_source.rbi

@@ -0,0 +1,55 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Blocklist
+      # Where a block came from. `Api` marks an API-key caller, which carries no
+      # dashboard actor. The other values name the screen the merchant used.
+      module BlockedCustomerSource
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Dodopayments::Blocklist::BlockedCustomerSource)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BLOCKLIST_PAGE =
+          T.let(
+            :blocklist_page,
+            Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol
+          )
+        CUSTOMER_PAGE =
+          T.let(
+            :customer_page,
+            Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol
+          )
+        PAYMENT_PAGE =
+          T.let(
+            :payment_page,
+            Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol
+          )
+        DISPUTE_PAGE =
+          T.let(
+            :dispute_page,
+            Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol
+          )
+        API =
+          T.let(
+            :api,
+            Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Dodopayments::Blocklist::BlockedCustomerSource::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/blocklist/create_blocked_customer_request.rbi

@@ -0,0 +1,143 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Blocklist
+      module CreateBlockedCustomerRequest
+        extend Dodopayments::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Dodopayments::Blocklist::CreateBlockedCustomerRequest::BlocklistCustomersBlockByCustomerID,
+              Dodopayments::Blocklist::CreateBlockedCustomerRequest::BlocklistCustomersBlockByEmail
+            )
+          end
+
+        class BlocklistCustomersBlockByCustomerID < Dodopayments::Models::Blocklist::BlockByCustomerID
+          OrHash =
+            T.type_alias do
+              T.any(
+                Dodopayments::Blocklist::CreateBlockedCustomerRequest::BlocklistCustomersBlockByCustomerID,
+                Dodopayments::Internal::AnyHash
+              )
+            end
+
+          # Why the merchant blocked this customer. The entry page shows it.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :reason
+
+          # Screen the merchant blocked from. Ignored for an API-key caller, whose entry
+          # always records `api`. A dashboard caller that omits it records `blocklist_page`.
+          sig do
+            returns(
+              T.nilable(
+                Dodopayments::Blocklist::BlockedCustomerSource::OrSymbol
+              )
+            )
+          end
+          attr_accessor :source
+
+          sig do
+            params(
+              reason: T.nilable(String),
+              source:
+                T.nilable(
+                  Dodopayments::Blocklist::BlockedCustomerSource::OrSymbol
+                )
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Why the merchant blocked this customer. The entry page shows it.
+            reason: nil,
+            # Screen the merchant blocked from. Ignored for an API-key caller, whose entry
+            # always records `api`. A dashboard caller that omits it records `blocklist_page`.
+            source: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                reason: T.nilable(String),
+                source:
+                  T.nilable(
+                    Dodopayments::Blocklist::BlockedCustomerSource::OrSymbol
+                  )
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class BlocklistCustomersBlockByEmail < Dodopayments::Models::Blocklist::BlockByEmail
+          OrHash =
+            T.type_alias do
+              T.any(
+                Dodopayments::Blocklist::CreateBlockedCustomerRequest::BlocklistCustomersBlockByEmail,
+                Dodopayments::Internal::AnyHash
+              )
+            end
+
+          # Why the merchant blocked this customer. The entry page shows it.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :reason
+
+          # Screen the merchant blocked from. Ignored for an API-key caller, whose entry
+          # always records `api`. A dashboard caller that omits it records `blocklist_page`.
+          sig do
+            returns(
+              T.nilable(
+                Dodopayments::Blocklist::BlockedCustomerSource::OrSymbol
+              )
+            )
+          end
+          attr_accessor :source
+
+          sig do
+            params(
+              reason: T.nilable(String),
+              source:
+                T.nilable(
+                  Dodopayments::Blocklist::BlockedCustomerSource::OrSymbol
+                )
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Why the merchant blocked this customer. The entry page shows it.
+            reason: nil,
+            # Screen the merchant blocked from. Ignored for an API-key caller, whose entry
+            # always records `api`. A dashboard caller that omits it records `blocklist_page`.
+            source: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                reason: T.nilable(String),
+                source:
+                  T.nilable(
+                    Dodopayments::Blocklist::BlockedCustomerSource::OrSymbol
+                  )
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[
+              Dodopayments::Blocklist::CreateBlockedCustomerRequest::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/blocklist/customer_create_params.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Blocklist
+      class CustomerCreateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Blocklist::CustomerCreateParams,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        sig do
+          params(request_options: Dodopayments::RequestOptions::OrHash).returns(
+            T.attached_class
+          )
+        end
+        def self.new(request_options: {})
+        end
+
+        sig do
+          override.returns({ request_options: Dodopayments::RequestOptions })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end