@type automatic_tax() :: %{
  optional(:enabled) => boolean() | nil,
  optional(:liability) => automatic_tax_liability() | nil,
  optional(String.t()) => term()
}

@type automatic_tax_liability() :: %{
  optional(:account) => String.t() | nil,
  optional(:type) => String.t() | nil,
  optional(String.t()) => term()
}

@type issuer() :: %{
  optional(:account) => String.t() | nil,
  optional(:type) => String.t() | nil,
  optional(String.t()) => term()
}

@type payment_settings() :: %{
  optional(:default_mandate) => map() | nil,
  optional(:payment_method_options) =>
    payment_settings_payment_method_options() | nil,
  optional(:payment_method_types) => map() | nil,
  optional(String.t()) => term()
}

@type payment_settings_payment_method_options() :: %{
  optional(:acss_debit) => map() | nil,
  optional(:bancontact) => map() | nil,
  optional(:card) => map() | nil,
  optional(:customer_balance) => map() | nil,
  optional(:konbini) => map() | nil,
  optional(:payto) => map() | nil,
  optional(:sepa_debit) => map() | nil,
  optional(:us_bank_account) => map() | nil,
  optional(String.t()) => term()
}

@type rendering() :: %{
  optional(:amount_tax_display) => String.t() | nil,
  optional(:pdf) => rendering_pdf() | nil,
  optional(:template) => String.t() | nil,
  optional(:template_version) => map() | nil,
  optional(String.t()) => term()
}

@type rendering_pdf() :: %{
  optional(:page_size) => String.t() | nil,
  optional(String.t()) => term()
}

@type t() :: %Stripe.Params.InvoiceUpdateParams{
  account_tax_ids: map() | nil,
  application_fee_amount: integer() | nil,
  auto_advance: boolean() | nil,
  automatic_tax: automatic_tax() | nil,
  automatically_finalizes_at: integer() | nil,
  collection_method: String.t() | nil,
  custom_fields: map() | nil,
  days_until_due: integer() | nil,
  default_payment_method: String.t() | nil,
  default_source: map() | nil,
  default_tax_rates: map() | nil,
  description: String.t() | nil,
  discounts: map() | nil,
  due_date: integer() | nil,
  effective_at: map() | nil,
  expand: [String.t()] | nil,
  footer: String.t() | nil,
  issuer: issuer() | nil,
  metadata: map() | nil,
  number: map() | nil,
  on_behalf_of: map() | nil,
  payment_settings: payment_settings() | nil,
  rendering: rendering() | nil,
  shipping_cost: map() | nil,
  shipping_details: map() | nil,
  statement_descriptor: String.t() | nil,
  transfer_data: map() | nil
}