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

@type shipping() :: %{
  optional(:address) => shipping_address() | nil,
  optional(:address_validation) => shipping_address_validation() | nil,
  optional(:customs) => shipping_customs() | nil,
  optional(:name) => String.t() | nil,
  optional(:phone_number) => String.t() | nil,
  optional(:require_signature) => boolean() | nil,
  optional(:service) => String.t() | nil,
  optional(:type) => String.t() | nil,
  optional(String.t()) => term()
}

@type shipping_address() :: %{
  optional(:city) => String.t() | nil,
  optional(:country) => String.t() | nil,
  optional(:line1) => String.t() | nil,
  optional(:line2) => String.t() | nil,
  optional(:postal_code) => String.t() | nil,
  optional(:state) => String.t() | nil,
  optional(String.t()) => term()
}

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

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

@type spending_controls() :: %{
  optional(:allowed_categories) => [String.t()] | nil,
  optional(:allowed_merchant_countries) => [String.t()] | nil,
  optional(:blocked_categories) => [String.t()] | nil,
  optional(:blocked_merchant_countries) => [String.t()] | nil,
  optional(:spending_limits) => [spending_controls_spending_limits()] | nil,
  optional(String.t()) => term()
}

@type spending_controls_spending_limits() :: %{
  optional(:amount) => integer() | nil,
  optional(:categories) => [String.t()] | nil,
  optional(:interval) => String.t() | nil,
  optional(String.t()) => term()
}

@type t() :: %Stripe.Params.Issuing.CardUpdateParams{
  cancellation_reason: String.t() | nil,
  expand: [String.t()] | nil,
  metadata: map() | nil,
  personalization_design: String.t() | nil,
  pin: pin() | nil,
  shipping: shipping() | nil,
  spending_controls: spending_controls() | nil,
  status: String.t() | nil
}