stripe-ruby/lib/stripe/resources/account_notice.rb

# File generated from our OpenAPI spec
# frozen_string_literal: true

module Stripe
  # A notice to a Connected account. Notice can be sent by Stripe on your behalf or you can opt to send the notices yourself.
  #
  # See the [guide to send notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) to your connected accounts.
  class AccountNotice < APIResource
    extend Stripe::APIOperations::List
    include Stripe::APIOperations::Save

    OBJECT_NAME = "account_notice"
    def self.object_name
      "account_notice"
    end

    class Email < Stripe::StripeObject
      # Content of the email in plain text. The copy must match exactly the language that Stripe Compliance has approved for use.
      attr_reader :plain_text
      # Email address of the recipient.
      attr_reader :recipient
      # Subject of the email.
      attr_reader :subject

      def self.inner_class_types
        @inner_class_types = {}
      end

      def self.field_remappings
        @field_remappings = {}
      end
    end

    class LinkedObjects < Stripe::StripeObject
      # Associated [Capability](https://stripe.com/docs/api/capabilities)
      attr_reader :capability
      # Associated [Credit Underwriting Record](https://stripe.com/docs/api/issuing/credit_underwriting_record)
      attr_reader :issuing_credit_underwriting_record
      # Associated [Issuing Dispute](https://stripe.com/docs/api/issuing/disputes)
      attr_reader :issuing_dispute

      def self.inner_class_types
        @inner_class_types = {}
      end

      def self.field_remappings
        @field_remappings = {}
      end
    end
    # Time at which the object was created. Measured in seconds since the Unix epoch.
    attr_reader :created
    # When present, the deadline for sending the notice to meet the relevant regulations.
    attr_reader :deadline
    # Information about the email when sent.
    attr_reader :email
    # Unique identifier for the object.
    attr_reader :id
    # Information about objects related to the notice.
    attr_reader :linked_objects
    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
    attr_reader :livemode
    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
    attr_reader :metadata
    # String representing the object's type. Objects of the same type share the same value.
    attr_reader :object
    # Reason the notice is being sent. The reason determines what copy the notice must contain. See the [regulated customer notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) guide. All reasons might not apply to your integration, and Stripe might add new reasons in the future, so we recommend an internal warning when you receive an unknown reason.
    attr_reader :reason
    # Date when the notice was sent. When absent, you must send the notice, update the content of the email and date when it was sent.
    attr_reader :sent_at

    # Retrieves a list of AccountNotice objects. The objects are sorted in descending order by creation date, with the most-recently-created object appearing first.
    def self.list(params = {}, opts = {})
      request_stripe_object(method: :get, path: "/v1/account_notices", params: params, opts: opts)
    end

    # Updates an AccountNotice object.
    def self.update(account_notice, params = {}, opts = {})
      request_stripe_object(
        method: :post,
        path: format("/v1/account_notices/%<account_notice>s", { account_notice: CGI.escape(account_notice) }),
        params: params,
        opts: opts
      )
    end

    def self.inner_class_types
      @inner_class_types = { email: Email, linked_objects: LinkedObjects }
    end

    def self.field_remappings
      @field_remappings = {}
    end
  end
end