lithic 0.1.0.pre.alpha.14 → 0.1.0.pre.alpha.16

data/lib/lithic/models/card_create_response.rb

@@ -0,0 +1,392 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::Cards#create
+    class CardCreateResponse < Lithic::Internal::Type::BaseModel
+      # @!attribute token
+      #   Globally unique identifier.
+      #
+      #   @return [String]
+      required :token, String
+
+      # @!attribute account_token
+      #   Globally unique identifier for the account to which the card belongs.
+      #
+      #   @return [String]
+      required :account_token, String
+
+      # @!attribute card_program_token
+      #   Globally unique identifier for the card program on which the card exists.
+      #
+      #   @return [String]
+      required :card_program_token, String
+
+      # @!attribute created
+      #   An RFC 3339 timestamp for when the card was created. UTC time zone.
+      #
+      #   @return [Time]
+      required :created, Time
+
+      # @!attribute funding
+      #   Deprecated: Funding account for the card.
+      #
+      #   @return [Lithic::Models::CardCreateResponse::Funding]
+      required :funding, -> { Lithic::Models::CardCreateResponse::Funding }
+
+      # @!attribute last_four
+      #   Last four digits of the card number.
+      #
+      #   @return [String]
+      required :last_four, String
+
+      # @!attribute pin_status
+      #   Indicates if a card is blocked due a PIN status issue (e.g. excessive incorrect
+      #   attempts).
+      #
+      #   @return [Symbol, Lithic::Models::CardCreateResponse::PinStatus]
+      required :pin_status, enum: -> { Lithic::Models::CardCreateResponse::PinStatus }
+
+      # @!attribute spend_limit
+      #   Amount (in cents) to limit approved authorizations (e.g. 100000 would be a
+      #   $1,000 limit). Transaction requests above the spend limit will be declined.
+      #
+      #   @return [Integer]
+      required :spend_limit, Integer
+
+      # @!attribute spend_limit_duration
+      #   Spend limit duration
+      #
+      #   @return [Symbol, Lithic::Models::CardCreateResponse::SpendLimitDuration]
+      required :spend_limit_duration, enum: -> { Lithic::Models::CardCreateResponse::SpendLimitDuration }
+
+      # @!attribute state
+      #   Card state values: _ `CLOSED` - Card will no longer approve authorizations.
+      #   Closing a card cannot be undone. _ `OPEN` - Card will approve authorizations (if
+      #   they match card and account parameters). _ `PAUSED` - Card will decline
+      #   authorizations, but can be resumed at a later time. _ `PENDING_FULFILLMENT` -
+      #   The initial state for cards of type `PHYSICAL`. The card is provisioned pending
+      #   manufacturing and fulfillment. Cards in this state can accept authorizations for
+      #   e-commerce purchases, but not for "Card Present" purchases where the physical
+      #   card itself is present. \* `PENDING_ACTIVATION` - At regular intervals, cards of
+      #   type `PHYSICAL` in state `PENDING_FULFILLMENT` are sent to the card production
+      #   warehouse and updated to state `PENDING_ACTIVATION`. Similar to
+      #   `PENDING_FULFILLMENT`, cards in this state can be used for e-commerce
+      #   transactions or can be added to mobile wallets. API clients should update the
+      #   card's state to `OPEN` only after the cardholder confirms receipt of the card.
+      #   In sandbox, the same daily batch fulfillment occurs, but no cards are actually
+      #   manufactured.
+      #
+      #   @return [Symbol, Lithic::Models::CardCreateResponse::State]
+      required :state, enum: -> { Lithic::Models::CardCreateResponse::State }
+
+      # @!attribute type
+      #   Card types: _ `VIRTUAL` - Card will authorize at any merchant and can be added
+      #   to a digital wallet like Apple Pay or Google Pay (if the card program is digital
+      #   wallet-enabled). _ `PHYSICAL` - Manufactured and sent to the cardholder. We
+      #   offer white label branding, credit, ATM, PIN debit, chip/EMV, NFC and magstripe
+      #   functionality. _ `SINGLE_USE` - Card is closed upon first successful
+      #   authorization. _ `MERCHANT_LOCKED` - _[Deprecated]_ Card is locked to the first
+      #   merchant that successfully authorizes the card. _ `UNLOCKED` - _[Deprecated]_
+      #   Similar behavior to VIRTUAL cards, please use VIRTUAL instead. _
+      #   `DIGITAL_WALLET` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please use
+      #   VIRTUAL instead.
+      #
+      #   @return [Symbol, Lithic::Models::CardCreateResponse::Type]
+      required :type, enum: -> { Lithic::Models::CardCreateResponse::Type }
+
+      # @!attribute auth_rule_tokens
+      #   @deprecated
+      #
+      #   List of identifiers for the Auth Rule(s) that are applied on the card. This
+      #   field is deprecated and will no longer be populated in the `Card` object. The
+      #   key will be removed from the schema in a future release. Use the `/auth_rules`
+      #   endpoints to fetch Auth Rule information instead.
+      #
+      #   @return [Array<String>, nil]
+      optional :auth_rule_tokens, Lithic::Internal::Type::ArrayOf[String]
+
+      # @!attribute cardholder_currency
+      #   3-character alphabetic ISO 4217 code for the currency of the cardholder.
+      #
+      #   @return [String, nil]
+      optional :cardholder_currency, String
+
+      # @!attribute cvv
+      #   Three digit cvv printed on the back of the card.
+      #
+      #   @return [String, nil]
+      optional :cvv, String
+
+      # @!attribute digital_card_art_token
+      #   Specifies the digital card art to be displayed in the user's digital wallet
+      #   after tokenization. This artwork must be approved by Mastercard and configured
+      #   by Lithic to use.
+      #
+      #   @return [String, nil]
+      optional :digital_card_art_token, String
+
+      # @!attribute exp_month
+      #   Two digit (MM) expiry month.
+      #
+      #   @return [String, nil]
+      optional :exp_month, String
+
+      # @!attribute exp_year
+      #   Four digit (yyyy) expiry year.
+      #
+      #   @return [String, nil]
+      optional :exp_year, String
+
+      # @!attribute hostname
+      #   Hostname of card's locked merchant (will be empty if not applicable).
+      #
+      #   @return [String, nil]
+      optional :hostname, String
+
+      # @!attribute memo
+      #   Friendly name to identify the card.
+      #
+      #   @return [String, nil]
+      optional :memo, String
+
+      # @!attribute pan
+      #   Primary Account Number (PAN) (i.e. the card number). Customers must be PCI
+      #   compliant to have PAN returned as a field in production. Please contact
+      #   support@lithic.com for questions.
+      #
+      #   @return [String, nil]
+      optional :pan, String
+
+      # @!attribute pending_commands
+      #   Indicates if there are offline PIN changes pending card interaction with an
+      #   offline PIN terminal. Possible commands are: CHANGE_PIN, UNBLOCK_PIN. Applicable
+      #   only to cards issued in markets supporting offline PINs.
+      #
+      #   @return [Array<String>, nil]
+      optional :pending_commands, Lithic::Internal::Type::ArrayOf[String]
+
+      # @!attribute product_id
+      #   Only applicable to cards of type `PHYSICAL`. This must be configured with Lithic
+      #   before use. Specifies the configuration (i.e., physical card art) that the card
+      #   should be manufactured with.
+      #
+      #   @return [String, nil]
+      optional :product_id, String
+
+      # @!attribute replacement_for
+      #   If the card is a replacement for another card, the globally unique identifier
+      #   for the card that was replaced.
+      #
+      #   @return [String, nil]
+      optional :replacement_for, String, nil?: true
+
+      # @!method initialize(token:, account_token:, card_program_token:, created:, funding:, last_four:, pin_status:, spend_limit:, spend_limit_duration:, state:, type:, auth_rule_tokens: nil, cardholder_currency: nil, cvv: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, hostname: nil, memo: nil, pan: nil, pending_commands: nil, product_id: nil, replacement_for: nil)
+      #   Card details with potentially PCI sensitive information for Enterprise customers
+      #
+      #   @param token [String]
+      #   @param account_token [String]
+      #   @param card_program_token [String]
+      #   @param created [Time]
+      #   @param funding [Lithic::Models::CardCreateResponse::Funding]
+      #   @param last_four [String]
+      #   @param pin_status [Symbol, Lithic::Models::CardCreateResponse::PinStatus]
+      #   @param spend_limit [Integer]
+      #   @param spend_limit_duration [Symbol, Lithic::Models::CardCreateResponse::SpendLimitDuration]
+      #   @param state [Symbol, Lithic::Models::CardCreateResponse::State]
+      #   @param type [Symbol, Lithic::Models::CardCreateResponse::Type]
+      #   @param auth_rule_tokens [Array<String>]
+      #   @param cardholder_currency [String]
+      #   @param cvv [String]
+      #   @param digital_card_art_token [String]
+      #   @param exp_month [String]
+      #   @param exp_year [String]
+      #   @param hostname [String]
+      #   @param memo [String]
+      #   @param pan [String]
+      #   @param pending_commands [Array<String>]
+      #   @param product_id [String]
+      #   @param replacement_for [String, nil]
+
+      # @see Lithic::Models::CardCreateResponse#funding
+      class Funding < Lithic::Internal::Type::BaseModel
+        # @!attribute token
+        #   A globally unique identifier for this FundingAccount.
+        #
+        #   @return [String]
+        required :token, String
+
+        # @!attribute created
+        #   An RFC 3339 string representing when this funding source was added to the Lithic
+        #   account. This may be `null`. UTC time zone.
+        #
+        #   @return [Time]
+        required :created, Time
+
+        # @!attribute last_four
+        #   The last 4 digits of the account (e.g. bank account, debit card) associated with
+        #   this FundingAccount. This may be null.
+        #
+        #   @return [String]
+        required :last_four, String
+
+        # @!attribute state
+        #   State of funding source. Funding source states: _ `ENABLED` - The funding
+        #   account is available to use for card creation and transactions. _ `PENDING` -
+        #   The funding account is still being verified e.g. bank micro-deposits
+        #   verification. \* `DELETED` - The founding account has been deleted.
+        #
+        #   @return [Symbol, Lithic::Models::CardCreateResponse::Funding::State]
+        required :state, enum: -> { Lithic::Models::CardCreateResponse::Funding::State }
+
+        # @!attribute type
+        #   Types of funding source: _ `DEPOSITORY_CHECKING` - Bank checking account. _
+        #   `DEPOSITORY_SAVINGS` - Bank savings account.
+        #
+        #   @return [Symbol, Lithic::Models::CardCreateResponse::Funding::Type]
+        required :type, enum: -> { Lithic::Models::CardCreateResponse::Funding::Type }
+
+        # @!attribute account_name
+        #   Account name identifying the funding source. This may be `null`.
+        #
+        #   @return [String, nil]
+        optional :account_name, String
+
+        # @!attribute nickname
+        #   The nickname given to the `FundingAccount` or `null` if it has no nickname.
+        #
+        #   @return [String, nil]
+        optional :nickname, String
+
+        # @!method initialize(token:, created:, last_four:, state:, type:, account_name: nil, nickname: nil)
+        #   Deprecated: Funding account for the card.
+        #
+        #   @param token [String]
+        #   @param created [Time]
+        #   @param last_four [String]
+        #   @param state [Symbol, Lithic::Models::CardCreateResponse::Funding::State]
+        #   @param type [Symbol, Lithic::Models::CardCreateResponse::Funding::Type]
+        #   @param account_name [String]
+        #   @param nickname [String]
+
+        # State of funding source. Funding source states: _ `ENABLED` - The funding
+        # account is available to use for card creation and transactions. _ `PENDING` -
+        # The funding account is still being verified e.g. bank micro-deposits
+        # verification. \* `DELETED` - The founding account has been deleted.
+        #
+        # @see Lithic::Models::CardCreateResponse::Funding#state
+        module State
+          extend Lithic::Internal::Type::Enum
+
+          DELETED = :DELETED
+          ENABLED = :ENABLED
+          PENDING = :PENDING
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Types of funding source: _ `DEPOSITORY_CHECKING` - Bank checking account. _
+        # `DEPOSITORY_SAVINGS` - Bank savings account.
+        #
+        # @see Lithic::Models::CardCreateResponse::Funding#type
+        module Type
+          extend Lithic::Internal::Type::Enum
+
+          DEPOSITORY_CHECKING = :DEPOSITORY_CHECKING
+          DEPOSITORY_SAVINGS = :DEPOSITORY_SAVINGS
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # Indicates if a card is blocked due a PIN status issue (e.g. excessive incorrect
+      # attempts).
+      #
+      # @see Lithic::Models::CardCreateResponse#pin_status
+      module PinStatus
+        extend Lithic::Internal::Type::Enum
+
+        OK = :OK
+        BLOCKED = :BLOCKED
+        NOT_SET = :NOT_SET
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Spend limit duration
+      #
+      # @see Lithic::Models::CardCreateResponse#spend_limit_duration
+      module SpendLimitDuration
+        extend Lithic::Internal::Type::Enum
+
+        ANNUALLY = :ANNUALLY
+        FOREVER = :FOREVER
+        MONTHLY = :MONTHLY
+        TRANSACTION = :TRANSACTION
+        DAILY = :DAILY
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Card state values: _ `CLOSED` - Card will no longer approve authorizations.
+      # Closing a card cannot be undone. _ `OPEN` - Card will approve authorizations (if
+      # they match card and account parameters). _ `PAUSED` - Card will decline
+      # authorizations, but can be resumed at a later time. _ `PENDING_FULFILLMENT` -
+      # The initial state for cards of type `PHYSICAL`. The card is provisioned pending
+      # manufacturing and fulfillment. Cards in this state can accept authorizations for
+      # e-commerce purchases, but not for "Card Present" purchases where the physical
+      # card itself is present. \* `PENDING_ACTIVATION` - At regular intervals, cards of
+      # type `PHYSICAL` in state `PENDING_FULFILLMENT` are sent to the card production
+      # warehouse and updated to state `PENDING_ACTIVATION`. Similar to
+      # `PENDING_FULFILLMENT`, cards in this state can be used for e-commerce
+      # transactions or can be added to mobile wallets. API clients should update the
+      # card's state to `OPEN` only after the cardholder confirms receipt of the card.
+      # In sandbox, the same daily batch fulfillment occurs, but no cards are actually
+      # manufactured.
+      #
+      # @see Lithic::Models::CardCreateResponse#state
+      module State
+        extend Lithic::Internal::Type::Enum
+
+        CLOSED = :CLOSED
+        OPEN = :OPEN
+        PAUSED = :PAUSED
+        PENDING_ACTIVATION = :PENDING_ACTIVATION
+        PENDING_FULFILLMENT = :PENDING_FULFILLMENT
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Card types: _ `VIRTUAL` - Card will authorize at any merchant and can be added
+      # to a digital wallet like Apple Pay or Google Pay (if the card program is digital
+      # wallet-enabled). _ `PHYSICAL` - Manufactured and sent to the cardholder. We
+      # offer white label branding, credit, ATM, PIN debit, chip/EMV, NFC and magstripe
+      # functionality. _ `SINGLE_USE` - Card is closed upon first successful
+      # authorization. _ `MERCHANT_LOCKED` - _[Deprecated]_ Card is locked to the first
+      # merchant that successfully authorizes the card. _ `UNLOCKED` - _[Deprecated]_
+      # Similar behavior to VIRTUAL cards, please use VIRTUAL instead. _
+      # `DIGITAL_WALLET` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please use
+      # VIRTUAL instead.
+      #
+      # @see Lithic::Models::CardCreateResponse#type
+      module Type
+        extend Lithic::Internal::Type::Enum
+
+        MERCHANT_LOCKED = :MERCHANT_LOCKED
+        PHYSICAL = :PHYSICAL
+        SINGLE_USE = :SINGLE_USE
+        VIRTUAL = :VIRTUAL
+        UNLOCKED = :UNLOCKED
+        DIGITAL_WALLET = :DIGITAL_WALLET
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/lithic/models/card_embed_params.rb

@@ -4,8 +4,7 @@ module Lithic
   module Models
     # @see Lithic::Resources::Cards#embed
     class CardEmbedParams < Lithic::Internal::Type::BaseModel
-      # @!parse
-      #   extend Lithic::Internal::Type::RequestParameters::Converter
+      extend Lithic::Internal::Type::RequestParameters::Converter
       include Lithic::Internal::Type::RequestParameters
 
       # @!attribute embed_request
@@ -20,14 +19,10 @@ module Lithic
       #   @return [String]
       required :hmac, String
 
-      # @!parse
-      #   # @param embed_request [String]
-      #   # @param hmac [String]
-      #   # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
-      #   #
-      #   def initialize(embed_request:, hmac:, request_options: {}, **) = super
-
-      # def initialize: (Hash | Lithic::Internal::Type::BaseModel) -> void
+      # @!method initialize(embed_request:, hmac:, request_options: {})
+      #   @param embed_request [String]
+      #   @param hmac [String]
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
     end
   end
 end

data/lib/lithic/models/card_list_params.rb

@@ -4,109 +4,64 @@ module Lithic
   module Models
     # @see Lithic::Resources::Cards#list
     class CardListParams < Lithic::Internal::Type::BaseModel
-      # @!parse
-      #   extend Lithic::Internal::Type::RequestParameters::Converter
+      extend Lithic::Internal::Type::RequestParameters::Converter
       include Lithic::Internal::Type::RequestParameters
 
-      # @!attribute [r] account_token
+      # @!attribute account_token
       #   Returns cards associated with the specified account.
       #
       #   @return [String, nil]
       optional :account_token, String
 
-      # @!parse
-      #   # @return [String]
-      #   attr_writer :account_token
-
-      # @!attribute [r] begin_
+      # @!attribute begin_
       #   Date string in RFC 3339 format. Only entries created after the specified time
       #   will be included. UTC time zone.
       #
       #   @return [Time, nil]
       optional :begin_, Time
 
-      # @!parse
-      #   # @return [Time]
-      #   attr_writer :begin_
-
-      # @!attribute [r] end_
+      # @!attribute end_
       #   Date string in RFC 3339 format. Only entries created before the specified time
       #   will be included. UTC time zone.
       #
       #   @return [Time, nil]
       optional :end_, Time
 
-      # @!parse
-      #   # @return [Time]
-      #   attr_writer :end_
-
-      # @!attribute [r] ending_before
+      # @!attribute ending_before
       #   A cursor representing an item's token before which a page of results should end.
       #   Used to retrieve the previous page of results before this item.
       #
       #   @return [String, nil]
       optional :ending_before, String
 
-      # @!parse
-      #   # @return [String]
-      #   attr_writer :ending_before
-
-      # @!attribute [r] page_size
+      # @!attribute page_size
       #   Page size (for pagination).
       #
       #   @return [Integer, nil]
       optional :page_size, Integer
 
-      # @!parse
-      #   # @return [Integer]
-      #   attr_writer :page_size
-
-      # @!attribute [r] starting_after
+      # @!attribute starting_after
       #   A cursor representing an item's token after which a page of results should
       #   begin. Used to retrieve the next page of results after this item.
       #
       #   @return [String, nil]
       optional :starting_after, String
 
-      # @!parse
-      #   # @return [String]
-      #   attr_writer :starting_after
-
-      # @!attribute [r] state
+      # @!attribute state
       #   Returns cards with the specified state.
       #
       #   @return [Symbol, Lithic::Models::CardListParams::State, nil]
       optional :state, enum: -> { Lithic::Models::CardListParams::State }
 
-      # @!parse
-      #   # @return [Symbol, Lithic::Models::CardListParams::State]
-      #   attr_writer :state
-
-      # @!parse
-      #   # @param account_token [String]
-      #   # @param begin_ [Time]
-      #   # @param end_ [Time]
-      #   # @param ending_before [String]
-      #   # @param page_size [Integer]
-      #   # @param starting_after [String]
-      #   # @param state [Symbol, Lithic::Models::CardListParams::State]
-      #   # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
-      #   #
-      #   def initialize(
-      #     account_token: nil,
-      #     begin_: nil,
-      #     end_: nil,
-      #     ending_before: nil,
-      #     page_size: nil,
-      #     starting_after: nil,
-      #     state: nil,
-      #     request_options: {},
-      #     **
-      #   )
-      #     super
-      #   end
-
-      # def initialize: (Hash | Lithic::Internal::Type::BaseModel) -> void
+      # @!method initialize(account_token: nil, begin_: nil, end_: nil, ending_before: nil, page_size: nil, starting_after: nil, state: nil, request_options: {})
+      #   @param account_token [String]
+      #   @param begin_ [Time]
+      #   @param end_ [Time]
+      #   @param ending_before [String]
+      #   @param page_size [Integer]
+      #   @param starting_after [String]
+      #   @param state [Symbol, Lithic::Models::CardListParams::State]
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
 
       # Returns cards with the specified state.
       module State
@@ -118,11 +73,8 @@ module Lithic
         PENDING_ACTIVATION = :PENDING_ACTIVATION
         PENDING_FULFILLMENT = :PENDING_FULFILLMENT
 
-        finalize!
-
-        # @!parse
-        #   # @return [Array<Symbol>]
-        #   def self.values; end
+        # @!method self.values
+        #   @return [Array<Symbol>]
       end
     end
   end