orb-billing 1.17.0 → 1.19.0

data/rbi/orb/resources/customers.rbi

@@ -639,6 +639,60 @@ module Orb
       def delete(customer_id, request_options: {})
       end
 
+      # Creates a portal session for the customer, returning a short-lived URL that
+      # provides authenticated access to the customer's billing portal. The session
+      # expires after `expires_in_minutes` (default 60, max 180). By default, creating a
+      # new session invalidates any other active portal sessions for the customer; pass
+      # `invalidate_existing=false` to allow concurrent sessions.
+      sig do
+        params(
+          customer_id: String,
+          expires_in_minutes: Integer,
+          invalidate_existing: T::Boolean,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Models::CustomerCreatePortalSessionResponse)
+      end
+      def create_portal_session(
+        customer_id,
+        # Duration in minutes until the portal session expires. Defaults to 60.
+        # Maximum 180.
+        expires_in_minutes: nil,
+        # When true (default), creating this session soft-deletes any other active portal
+        # sessions for the customer. Set to false to allow concurrent sessions — useful
+        # when minting portal links for multiple authenticated end-users at once. The
+        # customer's permanent portal link (if any) is never invalidated by this.
+        invalidate_existing: nil,
+        request_options: {}
+      )
+      end
+
+      # Creates a portal session for the customer, returning a short-lived URL that
+      # provides authenticated access to the customer's billing portal. The session
+      # expires after `expires_in_minutes` (default 60, max 180). By default, creating a
+      # new session invalidates any other active portal sessions for the customer; pass
+      # `invalidate_existing=false` to allow concurrent sessions.
+      sig do
+        params(
+          external_customer_id: String,
+          expires_in_minutes: Integer,
+          invalidate_existing: T::Boolean,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Models::CustomerCreatePortalSessionByExternalIDResponse)
+      end
+      def create_portal_session_by_external_id(
+        external_customer_id,
+        # Duration in minutes until the portal session expires. Defaults to 60.
+        # Maximum 180.
+        expires_in_minutes: nil,
+        # When true (default), creating this session soft-deletes any other active portal
+        # sessions for the customer. Set to false to allow concurrent sessions — useful
+        # when minting portal links for multiple authenticated end-users at once. The
+        # customer's permanent portal link (if any) is never invalidated by this.
+        invalidate_existing: nil,
+        request_options: {}
+      )
+      end
+
       # This endpoint is used to fetch customer details given an identifier. If the
       # `Customer` is in the process of being deleted, only the properties `id` and
       # `deleted: true` will be returned.

data/rbi/orb/resources/events.rbi

@@ -324,7 +324,6 @@ module Orb
         params(
           events: T::Array[Orb::EventIngestParams::Event::OrHash],
           backfill_id: T.nilable(String),
-          debug: T::Boolean,
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Models::EventIngestResponse)
       end
@@ -334,9 +333,6 @@ module Orb
         # Query param: If this ingestion request is part of a backfill, this parameter
         # ties the ingested events to the backfill
         backfill_id: nil,
-        # Query param: Pending Deprecation: Flag to enable additional debug information in
-        # the endpoint response
-        debug: nil,
         request_options: {}
       )
       end

data/rbi/orb/resources/invoices.rbi

@@ -39,9 +39,10 @@ module Orb
         # An ISO 4217 currency string. Must be the same as the customer's currency if it
         # is set.
         currency:,
-        # An ISO 8601 date or timestamp, interpreted in the customer's timezone. Must be
-        # in the past. If a date is set without a time, `invoice_date` is set to midnight
-        # on the chosen date in the customer's timezone.
+        # An ISO 8601 date or timestamp, interpreted in the customer's timezone. If a date
+        # is set without a time, `invoice_date` is set to midnight on the chosen date in
+        # the customer's timezone. `invoice_date` cannot be more than one year in the
+        # future.
         invoice_date:,
         line_items:,
         # Determines whether this invoice will automatically attempt to charge a saved
@@ -72,9 +73,9 @@ module Orb
         # on issue, whereas a value of '30' represents that the customer has 30 days to
         # pay the invoice. Do not set this field if you want to set a custom due date.
         net_terms: nil,
-        # When true, this invoice will be submitted for issuance upon creation. When
-        # false, the resulting invoice will require manual review to issue. Defaulted to
-        # false.
+        # When true, auto-issues the invoice on the invoice date. If the invoice date is
+        # today's date or earlier, the invoice will be issued upon creation. When false,
+        # the resulting invoice will require manual review to issue. Defaults to false.
         will_auto_issue: nil,
         request_options: {}
       )
@@ -402,6 +403,70 @@ module Orb
       )
       end
 
+      # This endpoint triggers a regeneration of the PDF for a finalized invoice.
+      #
+      # The invoice must be finalized (`issued`, `paid`, `synced`, or `void`) and must
+      # already have an existing PDF. The original PDF is archived (not permanently
+      # deleted) to maintain an audit trail.
+      #
+      # **Important Legal Considerations:**
+      #
+      # Regenerating invoice PDFs may not be permitted in all jurisdictions. Many tax
+      # authorities require that issued invoices remain unmodified. Before using this
+      # endpoint, ensure that:
+      #
+      # - Your local tax regulations permit modification of issued billing documents
+      # - You have a legitimate business reason (e.g., fixing template errors, updating
+      #   branding)
+      # - You maintain proper records of the original PDF (archived automatically by
+      #   Orb)
+      #
+      # Recommended use cases:
+      #
+      # - Correcting template rendering issues
+      # - Applying updated company branding
+      # - Updating customer data that was incorrect at issuance
+      sig do
+        params(
+          invoice_id: String,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Invoice)
+      end
+      def regenerate_invoice_pdf(invoice_id, request_options: {})
+      end
+
+      # This endpoint triggers a regeneration of the receipt PDF for a paid invoice.
+      #
+      # The invoice must be in `paid` status and must already have an existing receipt
+      # PDF. The original PDF is archived (not permanently deleted) to maintain an audit
+      # trail.
+      #
+      # **Important Legal Considerations:**
+      #
+      # Regenerating receipt PDFs may not be permitted in all jurisdictions. Many tax
+      # authorities require that issued receipts remain unmodified. Before using this
+      # endpoint, ensure that:
+      #
+      # - Your local tax regulations permit modification of issued billing documents
+      # - You have a legitimate business reason (e.g., fixing template errors, updating
+      #   branding)
+      # - You maintain proper records of the original PDF (archived automatically by
+      #   Orb)
+      #
+      # Recommended use cases:
+      #
+      # - Correcting template rendering issues
+      # - Applying updated company branding
+      # - Updating customer data that was incorrect at issuance
+      sig do
+        params(
+          invoice_id: String,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Invoice)
+      end
+      def regenerate_receipt_pdf(invoice_id, request_options: {})
+      end
+
       # This endpoint allows an invoice's status to be set to the `void` status. This
       # can only be done to invoices that are in the `issued` status.
       #

data/sig/orb/models/alert_delete_params.rbs

@@ -0,0 +1,24 @@
+module Orb
+  module Models
+    type alert_delete_params =
+      { alert_configuration_id: String }
+      & Orb::Internal::Type::request_parameters
+
+    class AlertDeleteParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      attr_accessor alert_configuration_id: String
+
+      def initialize: (
+        alert_configuration_id: String,
+        ?request_options: Orb::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        alert_configuration_id: String,
+        request_options: Orb::RequestOptions
+      }
+    end
+  end
+end

data/sig/orb/models/customer_create_portal_session_by_external_id_params.rbs

@@ -0,0 +1,40 @@
+module Orb
+  module Models
+    type customer_create_portal_session_by_external_id_params =
+      {
+        external_customer_id: String,
+        expires_in_minutes: Integer,
+        invalidate_existing: bool
+      }
+      & Orb::Internal::Type::request_parameters
+
+    class CustomerCreatePortalSessionByExternalIDParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      attr_accessor external_customer_id: String
+
+      attr_reader expires_in_minutes: Integer?
+
+      def expires_in_minutes=: (Integer) -> Integer
+
+      attr_reader invalidate_existing: bool?
+
+      def invalidate_existing=: (bool) -> bool
+
+      def initialize: (
+        external_customer_id: String,
+        ?expires_in_minutes: Integer,
+        ?invalidate_existing: bool,
+        ?request_options: Orb::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        external_customer_id: String,
+        expires_in_minutes: Integer,
+        invalidate_existing: bool,
+        request_options: Orb::RequestOptions
+      }
+    end
+  end
+end

data/sig/orb/models/customer_create_portal_session_by_external_id_response.rbs

@@ -0,0 +1,40 @@
+module Orb
+  module Models
+    type customer_create_portal_session_by_external_id_response =
+      {
+        id: String,
+        created_at: Time,
+        customer_id: String,
+        expires_at: Time?,
+        url: String
+      }
+
+    class CustomerCreatePortalSessionByExternalIDResponse < Orb::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor created_at: Time
+
+      attr_accessor customer_id: String
+
+      attr_accessor expires_at: Time?
+
+      attr_accessor url: String
+
+      def initialize: (
+        id: String,
+        created_at: Time,
+        customer_id: String,
+        expires_at: Time?,
+        url: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        created_at: Time,
+        customer_id: String,
+        expires_at: Time?,
+        url: String
+      }
+    end
+  end
+end

data/sig/orb/models/customer_create_portal_session_params.rbs

@@ -0,0 +1,40 @@
+module Orb
+  module Models
+    type customer_create_portal_session_params =
+      {
+        customer_id: String,
+        expires_in_minutes: Integer,
+        invalidate_existing: bool
+      }
+      & Orb::Internal::Type::request_parameters
+
+    class CustomerCreatePortalSessionParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      attr_accessor customer_id: String
+
+      attr_reader expires_in_minutes: Integer?
+
+      def expires_in_minutes=: (Integer) -> Integer
+
+      attr_reader invalidate_existing: bool?
+
+      def invalidate_existing=: (bool) -> bool
+
+      def initialize: (
+        customer_id: String,
+        ?expires_in_minutes: Integer,
+        ?invalidate_existing: bool,
+        ?request_options: Orb::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        customer_id: String,
+        expires_in_minutes: Integer,
+        invalidate_existing: bool,
+        request_options: Orb::RequestOptions
+      }
+    end
+  end
+end

data/sig/orb/models/customer_create_portal_session_response.rbs

@@ -0,0 +1,40 @@
+module Orb
+  module Models
+    type customer_create_portal_session_response =
+      {
+        id: String,
+        created_at: Time,
+        customer_id: String,
+        expires_at: Time?,
+        url: String
+      }
+
+    class CustomerCreatePortalSessionResponse < Orb::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor created_at: Time
+
+      attr_accessor customer_id: String
+
+      attr_accessor expires_at: Time?
+
+      attr_accessor url: String
+
+      def initialize: (
+        id: String,
+        created_at: Time,
+        customer_id: String,
+        expires_at: Time?,
+        url: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        created_at: Time,
+        customer_id: String,
+        expires_at: Time?,
+        url: String
+      }
+    end
+  end
+end

data/sig/orb/models/event_ingest_params.rbs

@@ -1,11 +1,7 @@
 module Orb
   module Models
     type event_ingest_params =
-      {
-        events: ::Array[Orb::EventIngestParams::Event],
-        backfill_id: String?,
-        debug: bool
-      }
+      { events: ::Array[Orb::EventIngestParams::Event], backfill_id: String? }
       & Orb::Internal::Type::request_parameters
 
     class EventIngestParams < Orb::Internal::Type::BaseModel
@@ -16,21 +12,15 @@ module Orb
 
       attr_accessor backfill_id: String?
 
-      attr_reader debug: bool?
-
-      def debug=: (bool) -> bool
-
       def initialize: (
         events: ::Array[Orb::EventIngestParams::Event],
         ?backfill_id: String?,
-        ?debug: bool,
         ?request_options: Orb::request_opts
       ) -> void
 
       def to_hash: -> {
         events: ::Array[Orb::EventIngestParams::Event],
         backfill_id: String?,
-        debug: bool,
         request_options: Orb::RequestOptions
       }
 

data/sig/orb/models/event_ingest_response.rbs

@@ -2,23 +2,18 @@ module Orb
   module Models
     type event_ingest_response =
       {
-        validation_failed: ::Array[Orb::Models::EventIngestResponse::ValidationFailed],
-        debug: Orb::Models::EventIngestResponse::Debug?
+        validation_failed: ::Array[Orb::Models::EventIngestResponse::ValidationFailed]
       }
 
     class EventIngestResponse < Orb::Internal::Type::BaseModel
       attr_accessor validation_failed: ::Array[Orb::Models::EventIngestResponse::ValidationFailed]
 
-      attr_accessor debug: Orb::Models::EventIngestResponse::Debug?
-
       def initialize: (
-        validation_failed: ::Array[Orb::Models::EventIngestResponse::ValidationFailed],
-        ?debug: Orb::Models::EventIngestResponse::Debug?
+        validation_failed: ::Array[Orb::Models::EventIngestResponse::ValidationFailed]
       ) -> void
 
       def to_hash: -> {
-        validation_failed: ::Array[Orb::Models::EventIngestResponse::ValidationFailed],
-        debug: Orb::Models::EventIngestResponse::Debug?
+        validation_failed: ::Array[Orb::Models::EventIngestResponse::ValidationFailed]
       }
 
       type validation_failed =
@@ -39,24 +34,6 @@ module Orb
           validation_errors: ::Array[String]
         }
       end
-
-      type debug = { duplicate: ::Array[String], ingested: ::Array[String] }
-
-      class Debug < Orb::Internal::Type::BaseModel
-        attr_accessor duplicate: ::Array[String]
-
-        attr_accessor ingested: ::Array[String]
-
-        def initialize: (
-          duplicate: ::Array[String],
-          ingested: ::Array[String]
-        ) -> void
-
-        def to_hash: -> {
-          duplicate: ::Array[String],
-          ingested: ::Array[String]
-        }
-      end
     end
   end
 end

data/sig/orb/models/invoice_regenerate_invoice_pdf_params.rbs

@@ -0,0 +1,23 @@
+module Orb
+  module Models
+    type invoice_regenerate_invoice_pdf_params =
+      { invoice_id: String } & Orb::Internal::Type::request_parameters
+
+    class InvoiceRegenerateInvoicePdfParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      attr_accessor invoice_id: String
+
+      def initialize: (
+        invoice_id: String,
+        ?request_options: Orb::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        invoice_id: String,
+        request_options: Orb::RequestOptions
+      }
+    end
+  end
+end

data/sig/orb/models/invoice_regenerate_receipt_pdf_params.rbs

@@ -0,0 +1,23 @@
+module Orb
+  module Models
+    type invoice_regenerate_receipt_pdf_params =
+      { invoice_id: String } & Orb::Internal::Type::request_parameters
+
+    class InvoiceRegenerateReceiptPdfParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      attr_accessor invoice_id: String
+
+      def initialize: (
+        invoice_id: String,
+        ?request_options: Orb::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        invoice_id: String,
+        request_options: Orb::RequestOptions
+      }
+    end
+  end
+end

data/sig/orb/models.rbs

@@ -17,6 +17,8 @@ module Orb
 
   class AlertCreateForSubscriptionParams = Orb::Models::AlertCreateForSubscriptionParams
 
+  class AlertDeleteParams = Orb::Models::AlertDeleteParams
+
   class AlertDisableParams = Orb::Models::AlertDisableParams
 
   class AlertEnableParams = Orb::Models::AlertEnableParams
@@ -99,6 +101,10 @@ module Orb
 
   class CustomerCreateParams = Orb::Models::CustomerCreateParams
 
+  class CustomerCreatePortalSessionByExternalIDParams = Orb::Models::CustomerCreatePortalSessionByExternalIDParams
+
+  class CustomerCreatePortalSessionParams = Orb::Models::CustomerCreatePortalSessionParams
+
   class CustomerDeleteParams = Orb::Models::CustomerDeleteParams
 
   class CustomerFetchByExternalIDParams = Orb::Models::CustomerFetchByExternalIDParams
@@ -187,6 +193,10 @@ module Orb
 
   class InvoicePayParams = Orb::Models::InvoicePayParams
 
+  class InvoiceRegenerateInvoicePdfParams = Orb::Models::InvoiceRegenerateInvoicePdfParams
+
+  class InvoiceRegenerateReceiptPdfParams = Orb::Models::InvoiceRegenerateReceiptPdfParams
+
   class InvoiceTiny = Orb::Models::InvoiceTiny
 
   class InvoiceUpdateParams = Orb::Models::InvoiceUpdateParams

data/sig/orb/resources/alerts.rbs

@@ -27,6 +27,11 @@ module Orb
         ?request_options: Orb::request_opts
       ) -> Orb::Internal::Page[Orb::Alert]
 
+      def delete: (
+        String alert_configuration_id,
+        ?request_options: Orb::request_opts
+      ) -> nil
+
       def create_for_customer: (
         String customer_id,
         currency: String,

data/sig/orb/resources/customers.rbs

@@ -71,6 +71,20 @@ module Orb
         ?request_options: Orb::request_opts
       ) -> nil
 
+      def create_portal_session: (
+        String customer_id,
+        ?expires_in_minutes: Integer,
+        ?invalidate_existing: bool,
+        ?request_options: Orb::request_opts
+      ) -> Orb::Models::CustomerCreatePortalSessionResponse
+
+      def create_portal_session_by_external_id: (
+        String external_customer_id,
+        ?expires_in_minutes: Integer,
+        ?invalidate_existing: bool,
+        ?request_options: Orb::request_opts
+      ) -> Orb::Models::CustomerCreatePortalSessionByExternalIDResponse
+
       def fetch: (
         String customer_id,
         ?request_options: Orb::request_opts

data/sig/orb/resources/events.rbs

@@ -23,7 +23,6 @@ module Orb
       def ingest: (
         events: ::Array[Orb::EventIngestParams::Event],
         ?backfill_id: String?,
-        ?debug: bool,
         ?request_options: Orb::request_opts
       ) -> Orb::Models::EventIngestResponse
 

data/sig/orb/resources/invoices.rbs

@@ -115,6 +115,16 @@ module Orb
         ?request_options: Orb::request_opts
       ) -> Orb::Invoice
 
+      def regenerate_invoice_pdf: (
+        String invoice_id,
+        ?request_options: Orb::request_opts
+      ) -> Orb::Invoice
+
+      def regenerate_receipt_pdf: (
+        String invoice_id,
+        ?request_options: Orb::request_opts
+      ) -> Orb::Invoice
+
       def `void`: (
         String invoice_id,
         ?request_options: Orb::request_opts