dodopayments 2.26.0 → 2.28.0

data/rbi/dodopayments/models/blocklist/customers/note_update_params.rbi

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

data/rbi/dodopayments/models/checkout_session_preview_response.rbi

@@ -42,6 +42,11 @@ module Dodopayments
       sig { returns(T::Boolean) }
       attr_accessor :is_byop
 
+      # False when the customer can confirm this session with no card. True for every
+      # other cart, including a one-time cart.
+      sig { returns(T::Boolean) }
+      attr_accessor :payment_method_required
+
       # The total product cart
       sig do
         returns(
@@ -118,6 +123,7 @@ module Dodopayments
           current_breakup:
             Dodopayments::Models::CheckoutSessionPreviewResponse::CurrentBreakup::OrHash,
           is_byop: T::Boolean,
+          payment_method_required: T::Boolean,
           product_cart:
             T::Array[
               Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::OrHash
@@ -148,6 +154,9 @@ module Dodopayments
         # country; in that case the quoted amounts exclude Dodo-computed tax because the
         # merchant is MoR and owns tax.
         is_byop:,
+        # False when the customer can confirm this session with no card. True for every
+        # other cart, including a one-time cart.
+        payment_method_required:,
         # The total product cart
         product_cart:,
         # Total calculate price of the product cart
@@ -185,6 +194,7 @@ module Dodopayments
             current_breakup:
               Dodopayments::Models::CheckoutSessionPreviewResponse::CurrentBreakup,
             is_byop: T::Boolean,
+            payment_method_required: T::Boolean,
             product_cart:
               T::Array[
                 Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart

data/rbi/dodopayments/models/credit_entitlements/balance_create_ledger_entry_params.rbi

@@ -42,7 +42,7 @@ module Dodopayments
         attr_accessor :idempotency_key
 
         # Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500
-        # chars)
+        # chars).
         sig do
           returns(
             T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants])
@@ -83,7 +83,7 @@ module Dodopayments
           # Idempotency key to prevent duplicate entries
           idempotency_key: nil,
           # Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500
-          # chars)
+          # chars).
           metadata: nil,
           # Human-readable reason for the entry
           reason: nil,

data/rbi/dodopayments/models/credit_entitlements/balance_create_ledger_entry_response.rbi

@@ -43,6 +43,10 @@ module Dodopayments
         sig { returns(T::Boolean) }
         attr_accessor :is_credit
 
+        # Metadata stored on this entry.
+        sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
+        attr_accessor :metadata
+
         sig { returns(String) }
         attr_accessor :overage_after
 
@@ -68,6 +72,7 @@ module Dodopayments
             entry_type:
               Dodopayments::CreditEntitlements::LedgerEntryType::OrSymbol,
             is_credit: T::Boolean,
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             overage_after: String,
             overage_before: String,
             grant_id: T.nilable(String),
@@ -84,6 +89,8 @@ module Dodopayments
           customer_id:,
           entry_type:,
           is_credit:,
+          # Metadata stored on this entry.
+          metadata:,
           overage_after:,
           overage_before:,
           grant_id: nil,
@@ -104,6 +111,7 @@ module Dodopayments
               entry_type:
                 Dodopayments::CreditEntitlements::LedgerEntryType::TaggedSymbol,
               is_credit: T::Boolean,
+              metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
               overage_after: String,
               overage_before: String,
               grant_id: T.nilable(String),

data/rbi/dodopayments/models/credit_entitlements/credit_ledger_entry.rbi

@@ -43,9 +43,7 @@ module Dodopayments
         sig { returns(T::Boolean) }
         attr_accessor :is_credit
 
-        # Metadata associated with the credit grant's source (the subscription or payment
-        # created at checkout). Empty when the grant has no resolvable source (e.g.
-        # credits granted directly via the API).
+        # Metadata associated with this entry.
         sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
         attr_accessor :metadata
 
@@ -110,9 +108,7 @@ module Dodopayments
           credit_entitlement_id:,
           customer_id:,
           is_credit:,
-          # Metadata associated with the credit grant's source (the subscription or payment
-          # created at checkout). Empty when the grant has no resolvable source (e.g.
-          # credits granted directly via the API).
+          # Metadata associated with this entry.
           metadata:,
           overage_after:,
           overage_before:,

data/rbi/dodopayments/models/customer.rbi

@@ -23,6 +23,16 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :name
 
+      # When the merchant blocked this customer. The dashboard shows the "Blocked" badge
+      # and the unblock action from it. The list route leaves it empty; only the
+      # single-customer route resolves it.
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :blocked_at
+
+      # Blocklist entry behind `blocked_at`, so the dashboard can link to it.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :blocklist_entry_id
+
       # Additional metadata for the customer
       sig do
         returns(
@@ -48,6 +58,8 @@ module Dodopayments
           customer_id: String,
           email: String,
           name: String,
+          blocked_at: T.nilable(Time),
+          blocklist_entry_id: T.nilable(String),
           metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           phone_number: T.nilable(String)
         ).returns(T.attached_class)
@@ -58,6 +70,12 @@ module Dodopayments
         customer_id:,
         email:,
         name:,
+        # When the merchant blocked this customer. The dashboard shows the "Blocked" badge
+        # and the unblock action from it. The list route leaves it empty; only the
+        # single-customer route resolves it.
+        blocked_at: nil,
+        # Blocklist entry behind `blocked_at`, so the dashboard can link to it.
+        blocklist_entry_id: nil,
         # Additional metadata for the customer
         metadata: nil,
         phone_number: nil
@@ -72,6 +90,8 @@ module Dodopayments
             customer_id: String,
             email: String,
             name: String,
+            blocked_at: T.nilable(Time),
+            blocklist_entry_id: T.nilable(String),
             metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             phone_number: T.nilable(String)
           }

data/rbi/dodopayments/models/customers/email_body.rbi

@@ -0,0 +1,88 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Customers
+      class EmailBody < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Customers::EmailBody,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Whether the merchant wrote this content. It is true for the recovery and dunning
+        # emails, which the merchant writes.
+        #
+        # The content is email HTML. Render it in a sandbox, whatever this value is.
+        sig { returns(T::Boolean) }
+        attr_accessor :merchant_authored
+
+        # Why the email did not arrive. It is null unless the email failed.
+        sig do
+          returns(
+            T.nilable(Dodopayments::Customers::EmailFailureCode::TaggedSymbol)
+          )
+        end
+        attr_accessor :failure_code
+
+        # A sentence that explains `failure_code`. It is null unless the email failed.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :failure_reason
+
+        # The stored HTML. It is null on a text-only email.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :html
+
+        # The stored plain text.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :text
+
+        sig do
+          params(
+            merchant_authored: T::Boolean,
+            failure_code:
+              T.nilable(Dodopayments::Customers::EmailFailureCode::OrSymbol),
+            failure_reason: T.nilable(String),
+            html: T.nilable(String),
+            text: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Whether the merchant wrote this content. It is true for the recovery and dunning
+          # emails, which the merchant writes.
+          #
+          # The content is email HTML. Render it in a sandbox, whatever this value is.
+          merchant_authored:,
+          # Why the email did not arrive. It is null unless the email failed.
+          failure_code: nil,
+          # A sentence that explains `failure_code`. It is null unless the email failed.
+          failure_reason: nil,
+          # The stored HTML. It is null on a text-only email.
+          html: nil,
+          # The stored plain text.
+          text: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              merchant_authored: T::Boolean,
+              failure_code:
+                T.nilable(
+                  Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+                ),
+              failure_reason: T.nilable(String),
+              html: T.nilable(String),
+              text: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/customers/email_failure_code.rbi

@@ -0,0 +1,70 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Customers
+      # Why an email did not reach the recipient.
+      #
+      # The code is stable. `send_failed` is the catch-all: it covers every failure that
+      # the other codes do not name.
+      module EmailFailureCode
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Dodopayments::Customers::EmailFailureCode)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        MAILBOX_NOT_FOUND =
+          T.let(
+            :mailbox_not_found,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+        ADDRESS_REJECTED =
+          T.let(
+            :address_rejected,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+        ADDRESS_SUPPRESSED =
+          T.let(
+            :address_suppressed,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+        MAILBOX_FULL =
+          T.let(
+            :mailbox_full,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+        TEMPORARY_FAILURE =
+          T.let(
+            :temporary_failure,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+        MESSAGE_TOO_LARGE =
+          T.let(
+            :message_too_large,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+        MARKED_AS_SPAM =
+          T.let(
+            :marked_as_spam,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+        SEND_FAILED =
+          T.let(
+            :send_failed,
+            Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Dodopayments::Customers::EmailFailureCode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/customers/email_list_params.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Customers
+      class EmailListParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Customers::EmailListParams,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :customer_id
+
+        # Which page to return. The default is 0.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page_number
+
+        sig { params(page_number: Integer).void }
+        attr_writer :page_number
+
+        # How many emails to return. The default is 10 and the maximum is 100.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page_size
+
+        sig { params(page_size: Integer).void }
+        attr_writer :page_size
+
+        sig do
+          params(
+            customer_id: String,
+            page_number: Integer,
+            page_size: Integer,
+            request_options: Dodopayments::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          customer_id:,
+          # Which page to return. The default is 0.
+          page_number: nil,
+          # How many emails to return. The default is 10 and the maximum is 100.
+          page_size: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              customer_id: String,
+              page_number: Integer,
+              page_size: Integer,
+              request_options: Dodopayments::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/customers/email_log_item.rbi

@@ -0,0 +1,157 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Customers
+      class EmailLogItem < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Customers::EmailLogItem,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # The group this email belongs to: payments, refunds, subscriptions,
+        # dunning_recovery, entitlements or auth.
+        sig { returns(String) }
+        attr_accessor :category
+
+        # When this email was sent.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Identifies this email. Use it to read the body or to send it again.
+        sig { returns(String) }
+        attr_accessor :email_log_id
+
+        # What kind of email this is, for example `payment_successful`.
+        sig { returns(String) }
+        attr_accessor :email_type
+
+        # Whether this email has content to show. The content endpoint can still refuse,
+        # because the content is removed after 180 days.
+        sig { returns(T::Boolean) }
+        attr_accessor :has_preview
+
+        # What you may do with this email.
+        sig { returns(Dodopayments::Customers::EmailPolicies) }
+        attr_reader :policies
+
+        sig do
+          params(policies: Dodopayments::Customers::EmailPolicies::OrHash).void
+        end
+        attr_writer :policies
+
+        # Where the email got to: sent, delivered, failed, complained or blocked.
+        sig { returns(Dodopayments::Customers::EmailLogStatus::TaggedSymbol) }
+        attr_accessor :status
+
+        # Why the email did not arrive. It is null unless the email failed.
+        sig do
+          returns(
+            T.nilable(Dodopayments::Customers::EmailFailureCode::TaggedSymbol)
+          )
+        end
+        attr_accessor :failure_code
+
+        # A sentence that explains `failure_code`. It is null unless the email failed.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :failure_reason
+
+        # The address the email was sent from.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :from
+
+        # What the merchant typed, when test mode redirected the send to the business
+        # owner.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :intended_recipient
+
+        # The address the email reached.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :recipient
+
+        # The subject line as it was sent. Empty until the provider replicates.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :subject
+
+        sig do
+          params(
+            category: String,
+            created_at: Time,
+            email_log_id: String,
+            email_type: String,
+            has_preview: T::Boolean,
+            policies: Dodopayments::Customers::EmailPolicies::OrHash,
+            status: Dodopayments::Customers::EmailLogStatus::OrSymbol,
+            failure_code:
+              T.nilable(Dodopayments::Customers::EmailFailureCode::OrSymbol),
+            failure_reason: T.nilable(String),
+            from: T.nilable(String),
+            intended_recipient: T.nilable(String),
+            recipient: T.nilable(String),
+            subject: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The group this email belongs to: payments, refunds, subscriptions,
+          # dunning_recovery, entitlements or auth.
+          category:,
+          # When this email was sent.
+          created_at:,
+          # Identifies this email. Use it to read the body or to send it again.
+          email_log_id:,
+          # What kind of email this is, for example `payment_successful`.
+          email_type:,
+          # Whether this email has content to show. The content endpoint can still refuse,
+          # because the content is removed after 180 days.
+          has_preview:,
+          # What you may do with this email.
+          policies:,
+          # Where the email got to: sent, delivered, failed, complained or blocked.
+          status:,
+          # Why the email did not arrive. It is null unless the email failed.
+          failure_code: nil,
+          # A sentence that explains `failure_code`. It is null unless the email failed.
+          failure_reason: nil,
+          # The address the email was sent from.
+          from: nil,
+          # What the merchant typed, when test mode redirected the send to the business
+          # owner.
+          intended_recipient: nil,
+          # The address the email reached.
+          recipient: nil,
+          # The subject line as it was sent. Empty until the provider replicates.
+          subject: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              category: String,
+              created_at: Time,
+              email_log_id: String,
+              email_type: String,
+              has_preview: T::Boolean,
+              policies: Dodopayments::Customers::EmailPolicies,
+              status: Dodopayments::Customers::EmailLogStatus::TaggedSymbol,
+              failure_code:
+                T.nilable(
+                  Dodopayments::Customers::EmailFailureCode::TaggedSymbol
+                ),
+              failure_reason: T.nilable(String),
+              from: T.nilable(String),
+              intended_recipient: T.nilable(String),
+              recipient: T.nilable(String),
+              subject: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/customers/email_log_status.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Customers
+      # The delivery status of one email.
+      #
+      # `sent` also covers an email that is still on its way. A status only becomes
+      # `delivered`, `failed` or `complained` when the mail server answers.
+      module EmailLogStatus
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Dodopayments::Customers::EmailLogStatus)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SENT =
+          T.let(:sent, Dodopayments::Customers::EmailLogStatus::TaggedSymbol)
+        DELIVERED =
+          T.let(
+            :delivered,
+            Dodopayments::Customers::EmailLogStatus::TaggedSymbol
+          )
+        FAILED =
+          T.let(:failed, Dodopayments::Customers::EmailLogStatus::TaggedSymbol)
+        COMPLAINED =
+          T.let(
+            :complained,
+            Dodopayments::Customers::EmailLogStatus::TaggedSymbol
+          )
+        BLOCKED =
+          T.let(:blocked, Dodopayments::Customers::EmailLogStatus::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Dodopayments::Customers::EmailLogStatus::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end