Stripe.Resources.Issuing.Card (tiger_stripe v0.3.0)

@type latest_fraud_warning() :: %{
  optional(:started_at) => integer() | nil,
  optional(:type) => String.t() | nil,
  optional(String.t()) => term()
}

started_at - Timestamp of the most recent fraud warning. Format: Unix timestamp. Nullable.
type - The type of fraud warning that most recently took place on this card. This field updates with every new fraud warning, so the value changes over time. If populated, cancel and reissue the card. Possible values: card_testing_exposure, fraud_dispute_filed, third_party_reported, user_indicated_fraud. Nullable.

shipping()

@type shipping() :: %{
  optional(:address) => Stripe.Resources.Address.t() | nil,
  optional(:address_validation) => shipping_address_validation() | nil,
  optional(:carrier) => String.t() | nil,
  optional(:customs) => shipping_customs() | nil,
  optional(:eta) => integer() | nil,
  optional(:name) => String.t() | nil,
  optional(:phone_number) => String.t() | nil,
  optional(:require_signature) => boolean() | nil,
  optional(:service) => String.t() | nil,
  optional(:status) => String.t() | nil,
  optional(:tracking_number) => String.t() | nil,
  optional(:tracking_url) => String.t() | nil,
  optional(:type) => String.t() | nil,
  optional(String.t()) => term()
}

address
address_validation - Address validation details for the shipment. Nullable.
carrier - The delivery company that shipped a card. Possible values: dhl, fedex, royal_mail, usps. Nullable.
customs - Additional information that may be required for clearing customs. Nullable.
eta - A unix timestamp representing a best estimate of when the card will be delivered. Format: Unix timestamp. Nullable.
name - Recipient name. Max length: 5000.
phone_number - The phone number of the receiver of the shipment. Our courier partners will use this number to contact you in the event of card delivery issues. For individual shipments to the EU/UK, if this field is empty, we will provide them with the phone number provided when the cardholder was initially created. Max length: 5000. Nullable.
require_signature - Whether a signature is required for card delivery. This feature is only supported for US users. Standard shipping service does not support signature on delivery. The default value for standard shipping service is false and for express and priority services is true. Nullable.
service - Shipment service, such as standard or express. Possible values: express, priority, standard.
status - The delivery status of the card. Possible values: canceled, delivered, failure, pending, returned, shipped, submitted. Nullable.
tracking_number - A tracking number for a card shipment. Max length: 5000. Nullable.
tracking_url - A link to the shipping carrier's site where you can view detailed information about a card shipment. Max length: 5000. Nullable.
type - Packaging options. Possible values: bulk, individual.

shipping_address_validation()

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

mode - The address validation capabilities to use. Possible values: disabled, normalization_only, validation_and_normalization.
normalized_address - The normalized shipping address. Nullable.
result - The validation result for the shipping address. Possible values: indeterminate, likely_deliverable, likely_undeliverable. Nullable.

shipping_customs()

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

eori_number - A registration number used for customs in Europe. See https://www.gov.uk/eori for the UK and https://ec.europa.eu/taxation_customs/business/customs-procedures-import-and-export/customs-procedures/economic-operators-registration-and-identification-number-eori_en for the EU. Max length: 5000. Nullable.

spending_controls()

@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(:spending_limits_currency) => String.t() | nil,
  optional(String.t()) => term()
}

allowed_categories - Array of strings containing categories of authorizations to allow. All other categories will be blocked. Cannot be set with blocked_categories. Nullable.
allowed_merchant_countries - Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. US). Cannot be set with blocked_merchant_countries. Provide an empty value to unset this control. Nullable.
blocked_categories - Array of strings containing categories of authorizations to decline. All other categories will be allowed. Cannot be set with allowed_categories. Nullable.
blocked_merchant_countries - Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. US). Cannot be set with allowed_merchant_countries. Provide an empty value to unset this control. Nullable.
spending_limits - Limit spending with amount-based rules that apply across any cards this card replaced (i.e., its replacement_for card and that card's replacement_for card, up the chain). Nullable.
spending_limits_currency - Currency of the amounts within spending_limits. Always the same as the currency of the card. Format: ISO 4217 currency code. Nullable.

spending_controls_spending_limits()

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

amount - Maximum amount allowed to spend per interval. This amount is in the card's currency and in the smallest currency unit.
categories - Array of strings containing categories this limit applies to. Omitting this field will apply the limit to all categories. Nullable.
interval - Interval (or event) to which the amount applies. Possible values: all_time, daily, monthly, per_authorization, weekly, yearly.

t()

@type t() :: %Stripe.Resources.Issuing.Card{
  brand: String.t(),
  cancellation_reason: String.t(),
  cardholder: Stripe.Resources.Issuing.Cardholder.t(),
  created: integer(),
  currency: String.t(),
  cvc: String.t() | nil,
  exp_month: integer(),
  exp_year: integer(),
  financial_account: String.t() | nil,
  id: String.t(),
  last4: String.t(),
  latest_fraud_warning: latest_fraud_warning(),
  livemode: boolean(),
  metadata: %{required(String.t()) => String.t()},
  number: String.t() | nil,
  object: String.t(),
  personalization_design:
    String.t() | Stripe.Resources.Issuing.PersonalizationDesign.t(),
  replaced_by: String.t() | t(),
  replacement_for: String.t() | t(),
  replacement_reason: String.t(),
  second_line: String.t(),
  shipping: shipping(),
  spending_controls: spending_controls(),
  status: String.t(),
  type: String.t(),
  wallets: wallets()
}

brand - The brand of the card. Max length: 5000.
cancellation_reason - The reason why the card was canceled. Possible values: design_rejected, lost, stolen. Nullable.
cardholder - Expandable.
created - Time at which the object was created. Measured in seconds since the Unix epoch. Format: Unix timestamp.
currency - Three-letter ISO currency code, in lowercase. Supported currencies are usd in the US, eur in the EU, and gbp in the UK. Format: ISO 4217 currency code.
cvc - The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with the expand parameter. Additionally, it's only available via the "Retrieve a card" endpoint, not via "List all cards" or any other endpoint. Max length: 5000.
exp_month - The expiration month of the card.
exp_year - The expiration year of the card.
financial_account - The financial account this card is attached to. Max length: 5000. Nullable.
id - Unique identifier for the object. Max length: 5000.
last4 - The last 4 digits of the card number. Max length: 5000.
latest_fraud_warning - Stripe’s assessment of whether this card’s details have been compromised. If this property isn't null, cancel and reissue the card to prevent fraudulent activity risk. Nullable. Expandable.
livemode - Has the value true if the object exists in live mode or the value false if the object exists in test mode.
metadata - Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
number - The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with the expand parameter. Additionally, it's only available via the "Retrieve a card" endpoint, not via "List all cards" or any other endpoint. Max length: 5000.
object - String representing the object's type. Objects of the same type share the same value. Possible values: issuing.card.
personalization_design - The personalization design object belonging to this card. Nullable. Expandable.
replaced_by - The latest card that replaces this card, if any. Nullable. Expandable.
replacement_for - The card this card replaces, if any. Nullable. Expandable.
replacement_reason - The reason why the previous card needed to be replaced. Possible values: damaged, expired, lost, stolen. Nullable.
second_line - Text separate from cardholder name, printed on the card. Max length: 5000. Nullable.
shipping - Where and how the card will be shipped. Nullable. Expandable.
spending_controls - Expandable.
status - Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to inactive. Possible values: active, canceled, inactive.
type - The type of the card. Possible values: physical, virtual.
wallets - Information relating to digital wallets (like Apple Pay and Google Pay). Nullable. Expandable.

wallets()

@type wallets() :: %{
  optional(:apple_pay) => wallets_apple_pay() | nil,
  optional(:google_pay) => wallets_google_pay() | nil,
  optional(:primary_account_identifier) => String.t() | nil,
  optional(String.t()) => term()
}

apple_pay
google_pay
primary_account_identifier - Unique identifier for a card used with digital wallets Max length: 5000. Nullable.

wallets_apple_pay()

@type wallets_apple_pay() :: %{
  optional(:eligible) => boolean() | nil,
  optional(:ineligible_reason) => String.t() | nil,
  optional(String.t()) => term()
}

eligible - Apple Pay Eligibility
ineligible_reason - Reason the card is ineligible for Apple Pay Possible values: missing_agreement, missing_cardholder_contact, unsupported_region. Nullable.

wallets_google_pay()

@type wallets_google_pay() :: %{
  optional(:eligible) => boolean() | nil,
  optional(:ineligible_reason) => String.t() | nil,
  optional(String.t()) => term()
}

eligible - Google Pay Eligibility
ineligible_reason - Reason the card is ineligible for Google Pay Possible values: missing_agreement, missing_cardholder_contact, unsupported_region. Nullable.