lithic 0.2.0 → 0.4.0

data/lib/lithic/models/transaction.rb

@@ -162,6 +162,13 @@ module Lithic
       #   @return [Symbol, Lithic::Models::Transaction::Status]
       required :status, enum: -> { Lithic::Transaction::Status }
 
+      # @!attribute tags
+      #   Key-value pairs for tagging resources. Tags allow you to associate arbitrary
+      #   metadata with a resource for your own purposes.
+      #
+      #   @return [Hash{Symbol=>String}]
+      required :tags, Lithic::Internal::Type::HashOf[String]
+
       # @!attribute token_info
       #
       #   @return [Lithic::Models::TokenInfo, nil]
@@ -178,7 +185,7 @@ module Lithic
       #   @return [Array<Lithic::Models::Transaction::Event>, nil]
       optional :events, -> { Lithic::Internal::Type::ArrayOf[Lithic::Transaction::Event] }
 
-      # @!method initialize(token:, account_token:, acquirer_fee:, acquirer_reference_number:, amount:, amounts:, authorization_amount:, authorization_code:, avs:, card_token:, cardholder_authentication:, created:, financial_account_token:, merchant:, merchant_amount:, merchant_authorization_amount:, merchant_currency:, network:, network_risk_score:, pos:, result:, settled_amount:, status:, token_info:, updated:, events: nil)
+      # @!method initialize(token:, account_token:, acquirer_fee:, acquirer_reference_number:, amount:, amounts:, authorization_amount:, authorization_code:, avs:, card_token:, cardholder_authentication:, created:, financial_account_token:, merchant:, merchant_amount:, merchant_authorization_amount:, merchant_currency:, network:, network_risk_score:, pos:, result:, settled_amount:, status:, tags:, token_info:, updated:, events: nil)
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::Transaction} for more details.
       #
@@ -228,6 +235,8 @@ module Lithic
       #
       #   @param status [Symbol, Lithic::Models::Transaction::Status] Status of the transaction.
       #
+      #   @param tags [Hash{Symbol=>String}] Key-value pairs for tagging resources. Tags allow you to associate arbitrary met
+      #
       #   @param token_info [Lithic::Models::TokenInfo, nil]
       #
       #   @param updated [Time] Date and time when the transaction last updated. UTC time zone.
@@ -929,6 +938,7 @@ module Lithic
           AUTH_RULE_ALLOWED_MCC = :AUTH_RULE_ALLOWED_MCC
           AUTH_RULE_BLOCKED_COUNTRY = :AUTH_RULE_BLOCKED_COUNTRY
           AUTH_RULE_BLOCKED_MCC = :AUTH_RULE_BLOCKED_MCC
+          AUTH_RULE = :AUTH_RULE
           CARD_CLOSED = :CARD_CLOSED
           CARD_CRYPTOGRAM_VALIDATION_FAILURE = :CARD_CRYPTOGRAM_VALIDATION_FAILURE
           CARD_EXPIRED = :CARD_EXPIRED
@@ -1258,6 +1268,7 @@ module Lithic
             AUTH_RULE_ALLOWED_MCC = :AUTH_RULE_ALLOWED_MCC
             AUTH_RULE_BLOCKED_COUNTRY = :AUTH_RULE_BLOCKED_COUNTRY
             AUTH_RULE_BLOCKED_MCC = :AUTH_RULE_BLOCKED_MCC
+            AUTH_RULE = :AUTH_RULE
             CARD_CLOSED = :CARD_CLOSED
             CARD_CRYPTOGRAM_VALIDATION_FAILURE = :CARD_CRYPTOGRAM_VALIDATION_FAILURE
             CARD_EXPIRED = :CARD_EXPIRED

data/lib/lithic/models/transaction_simulate_authorization_params.rb

@@ -37,12 +37,30 @@ module Lithic
       #   @return [String, nil]
       optional :mcc, String
 
+      # @!attribute merchant_acceptor_city
+      #   Merchant acceptor city
+      #
+      #   @return [String, nil]
+      optional :merchant_acceptor_city, String
+
+      # @!attribute merchant_acceptor_country
+      #   Merchant acceptor country code (ISO 3166-1 alpha-3)
+      #
+      #   @return [String, nil]
+      optional :merchant_acceptor_country, String
+
       # @!attribute merchant_acceptor_id
       #   Unique identifier to identify the payment card acceptor.
       #
       #   @return [String, nil]
       optional :merchant_acceptor_id, String
 
+      # @!attribute merchant_acceptor_state
+      #   Merchant acceptor state/province (ISO 3166-2 subdivision code)
+      #
+      #   @return [String, nil]
+      optional :merchant_acceptor_state, String
+
       # @!attribute merchant_amount
       #   Amount of the transaction to be simulated in currency specified in
       #   merchant_currency, including any acquirer fees.
@@ -92,7 +110,7 @@ module Lithic
       #   @return [Symbol, Lithic::Models::TransactionSimulateAuthorizationParams::Status, nil]
       optional :status, enum: -> { Lithic::TransactionSimulateAuthorizationParams::Status }
 
-      # @!method initialize(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_id: nil, merchant_amount: nil, merchant_currency: nil, partial_approval_capable: nil, pin: nil, status: nil, request_options: {})
+      # @!method initialize(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_city: nil, merchant_acceptor_country: nil, merchant_acceptor_id: nil, merchant_acceptor_state: nil, merchant_amount: nil, merchant_currency: nil, partial_approval_capable: nil, pin: nil, status: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::TransactionSimulateAuthorizationParams} for more details.
       #
@@ -104,8 +122,14 @@ module Lithic
       #
       #   @param mcc [String] Merchant category code for the transaction to be simulated. A four-digit number
       #
+      #   @param merchant_acceptor_city [String] Merchant acceptor city
+      #
+      #   @param merchant_acceptor_country [String] Merchant acceptor country code (ISO 3166-1 alpha-3)
+      #
       #   @param merchant_acceptor_id [String] Unique identifier to identify the payment card acceptor.
       #
+      #   @param merchant_acceptor_state [String] Merchant acceptor state/province (ISO 3166-2 subdivision code)
+      #
       #   @param merchant_amount [Integer] Amount of the transaction to be simulated in currency specified in merchant_curr
       #
       #   @param merchant_currency [String] 3-character alphabetic ISO 4217 currency code. Note: Simulator only accepts USD,

data/lib/lithic/models/transaction_simulate_credit_authorization_advice_params.rb

@@ -35,13 +35,31 @@ module Lithic
       #   @return [String, nil]
       optional :mcc, String
 
+      # @!attribute merchant_acceptor_city
+      #   Merchant acceptor city
+      #
+      #   @return [String, nil]
+      optional :merchant_acceptor_city, String
+
+      # @!attribute merchant_acceptor_country
+      #   Merchant acceptor country code (ISO 3166-1 alpha-3)
+      #
+      #   @return [String, nil]
+      optional :merchant_acceptor_country, String
+
       # @!attribute merchant_acceptor_id
       #   Unique identifier to identify the payment card acceptor.
       #
       #   @return [String, nil]
       optional :merchant_acceptor_id, String
 
-      # @!method initialize(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_id: nil, request_options: {})
+      # @!attribute merchant_acceptor_state
+      #   Merchant acceptor state/province (ISO 3166-2 subdivision code)
+      #
+      #   @return [String, nil]
+      optional :merchant_acceptor_state, String
+
+      # @!method initialize(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_city: nil, merchant_acceptor_country: nil, merchant_acceptor_id: nil, merchant_acceptor_state: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::TransactionSimulateCreditAuthorizationAdviceParams} for more
       #   details.
@@ -54,8 +72,14 @@ module Lithic
       #
       #   @param mcc [String] Merchant category code for the transaction to be simulated. A four-digit number
       #
+      #   @param merchant_acceptor_city [String] Merchant acceptor city
+      #
+      #   @param merchant_acceptor_country [String] Merchant acceptor country code (ISO 3166-1 alpha-3)
+      #
       #   @param merchant_acceptor_id [String] Unique identifier to identify the payment card acceptor.
       #
+      #   @param merchant_acceptor_state [String] Merchant acceptor state/province (ISO 3166-2 subdivision code)
+      #
       #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/lithic/models/transfer_limit_list_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::TransferLimits#list
+    class TransferLimitListParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute date
+      #   Date for which to retrieve transfer limits (ISO 8601 format)
+      #
+      #   @return [Date, nil]
+      optional :date, Date
+
+      # @!method initialize(date: nil, request_options: {})
+      #   @param date [Date] Date for which to retrieve transfer limits (ISO 8601 format)
+      #
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/lithic/models/transfer_limits_response.rb

@@ -0,0 +1,274 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    class TransferLimitsResponse < Lithic::Internal::Type::BaseModel
+      # @!attribute data
+      #   List of transfer limits
+      #
+      #   @return [Array<Lithic::Models::TransferLimitsResponse::Data>]
+      required :data, -> { Lithic::Internal::Type::ArrayOf[Lithic::TransferLimitsResponse::Data] }
+
+      # @!attribute has_more
+      #   Whether there are more transfer limits
+      #
+      #   @return [Boolean]
+      required :has_more, Lithic::Internal::Type::Boolean
+
+      # @!method initialize(data:, has_more:)
+      #   @param data [Array<Lithic::Models::TransferLimitsResponse::Data>] List of transfer limits
+      #
+      #   @param has_more [Boolean] Whether there are more transfer limits
+
+      class Data < Lithic::Internal::Type::BaseModel
+        # @!attribute company_id
+        #   Company ID
+        #
+        #   @return [String]
+        required :company_id, String
+
+        # @!attribute daily_limit
+        #   Daily limits with progress
+        #
+        #   @return [Lithic::Models::TransferLimitsResponse::Data::DailyLimit]
+        required :daily_limit, -> { Lithic::TransferLimitsResponse::Data::DailyLimit }
+
+        # @!attribute date
+        #   The date for the limit view (ISO format)
+        #
+        #   @return [Date]
+        required :date, Date
+
+        # @!attribute is_fbo
+        #   Whether the company is a FBO; based on the company ID prefix
+        #
+        #   @return [Boolean]
+        required :is_fbo, Lithic::Internal::Type::Boolean
+
+        # @!attribute monthly_limit
+        #   Monthly limits with progress
+        #
+        #   @return [Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit]
+        required :monthly_limit, -> { Lithic::TransferLimitsResponse::Data::MonthlyLimit }
+
+        # @!attribute program_limit_per_transaction
+        #   Program transaction limits
+        #
+        #   @return [Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction]
+        required :program_limit_per_transaction,
+                 -> { Lithic::TransferLimitsResponse::Data::ProgramLimitPerTransaction }
+
+        # @!method initialize(company_id:, daily_limit:, date:, is_fbo:, monthly_limit:, program_limit_per_transaction:)
+        #   @param company_id [String] Company ID
+        #
+        #   @param daily_limit [Lithic::Models::TransferLimitsResponse::Data::DailyLimit] Daily limits with progress
+        #
+        #   @param date [Date] The date for the limit view (ISO format)
+        #
+        #   @param is_fbo [Boolean] Whether the company is a FBO; based on the company ID prefix
+        #
+        #   @param monthly_limit [Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit] Monthly limits with progress
+        #
+        #   @param program_limit_per_transaction [Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction] Program transaction limits
+
+        # @see Lithic::Models::TransferLimitsResponse::Data#daily_limit
+        class DailyLimit < Lithic::Internal::Type::BaseModel
+          # @!attribute credit
+          #   Credit limits
+          #
+          #   @return [Lithic::Models::TransferLimitsResponse::Data::DailyLimit::Credit]
+          required :credit, -> { Lithic::TransferLimitsResponse::Data::DailyLimit::Credit }
+
+          # @!attribute debit
+          #   Debit limits
+          #
+          #   @return [Lithic::Models::TransferLimitsResponse::Data::DailyLimit::Debit]
+          required :debit, -> { Lithic::TransferLimitsResponse::Data::DailyLimit::Debit }
+
+          # @!method initialize(credit:, debit:)
+          #   Daily limits with progress
+          #
+          #   @param credit [Lithic::Models::TransferLimitsResponse::Data::DailyLimit::Credit] Credit limits
+          #
+          #   @param debit [Lithic::Models::TransferLimitsResponse::Data::DailyLimit::Debit] Debit limits
+
+          # @see Lithic::Models::TransferLimitsResponse::Data::DailyLimit#credit
+          class Credit < Lithic::Internal::Type::BaseModel
+            # @!attribute limit
+            #   The limit amount
+            #
+            #   @return [Integer]
+            required :limit, Integer
+
+            # @!attribute amount_originated
+            #   Amount originated towards limit
+            #
+            #   @return [Integer, nil]
+            optional :amount_originated, Integer
+
+            # @!method initialize(limit:, amount_originated: nil)
+            #   Credit limits
+            #
+            #   @param limit [Integer] The limit amount
+            #
+            #   @param amount_originated [Integer] Amount originated towards limit
+          end
+
+          # @see Lithic::Models::TransferLimitsResponse::Data::DailyLimit#debit
+          class Debit < Lithic::Internal::Type::BaseModel
+            # @!attribute limit
+            #   The limit amount
+            #
+            #   @return [Integer]
+            required :limit, Integer
+
+            # @!attribute amount_originated
+            #   Amount originated towards limit
+            #
+            #   @return [Integer, nil]
+            optional :amount_originated, Integer
+
+            # @!method initialize(limit:, amount_originated: nil)
+            #   Debit limits
+            #
+            #   @param limit [Integer] The limit amount
+            #
+            #   @param amount_originated [Integer] Amount originated towards limit
+          end
+        end
+
+        # @see Lithic::Models::TransferLimitsResponse::Data#monthly_limit
+        class MonthlyLimit < Lithic::Internal::Type::BaseModel
+          # @!attribute credit
+          #   Credit limits
+          #
+          #   @return [Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit::Credit]
+          required :credit, -> { Lithic::TransferLimitsResponse::Data::MonthlyLimit::Credit }
+
+          # @!attribute debit
+          #   Debit limits
+          #
+          #   @return [Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit::Debit]
+          required :debit, -> { Lithic::TransferLimitsResponse::Data::MonthlyLimit::Debit }
+
+          # @!method initialize(credit:, debit:)
+          #   Monthly limits with progress
+          #
+          #   @param credit [Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit::Credit] Credit limits
+          #
+          #   @param debit [Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit::Debit] Debit limits
+
+          # @see Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit#credit
+          class Credit < Lithic::Internal::Type::BaseModel
+            # @!attribute limit
+            #   The limit amount
+            #
+            #   @return [Integer]
+            required :limit, Integer
+
+            # @!attribute amount_originated
+            #   Amount originated towards limit
+            #
+            #   @return [Integer, nil]
+            optional :amount_originated, Integer
+
+            # @!method initialize(limit:, amount_originated: nil)
+            #   Credit limits
+            #
+            #   @param limit [Integer] The limit amount
+            #
+            #   @param amount_originated [Integer] Amount originated towards limit
+          end
+
+          # @see Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit#debit
+          class Debit < Lithic::Internal::Type::BaseModel
+            # @!attribute limit
+            #   The limit amount
+            #
+            #   @return [Integer]
+            required :limit, Integer
+
+            # @!attribute amount_originated
+            #   Amount originated towards limit
+            #
+            #   @return [Integer, nil]
+            optional :amount_originated, Integer
+
+            # @!method initialize(limit:, amount_originated: nil)
+            #   Debit limits
+            #
+            #   @param limit [Integer] The limit amount
+            #
+            #   @param amount_originated [Integer] Amount originated towards limit
+          end
+        end
+
+        # @see Lithic::Models::TransferLimitsResponse::Data#program_limit_per_transaction
+        class ProgramLimitPerTransaction < Lithic::Internal::Type::BaseModel
+          # @!attribute credit
+          #   Credit limits
+          #
+          #   @return [Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction::Credit]
+          required :credit, -> { Lithic::TransferLimitsResponse::Data::ProgramLimitPerTransaction::Credit }
+
+          # @!attribute debit
+          #   Debit limits
+          #
+          #   @return [Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction::Debit]
+          required :debit, -> { Lithic::TransferLimitsResponse::Data::ProgramLimitPerTransaction::Debit }
+
+          # @!method initialize(credit:, debit:)
+          #   Program transaction limits
+          #
+          #   @param credit [Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction::Credit] Credit limits
+          #
+          #   @param debit [Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction::Debit] Debit limits
+
+          # @see Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction#credit
+          class Credit < Lithic::Internal::Type::BaseModel
+            # @!attribute limit
+            #   The limit amount
+            #
+            #   @return [Integer]
+            required :limit, Integer
+
+            # @!attribute amount_originated
+            #   Amount originated towards limit
+            #
+            #   @return [Integer, nil]
+            optional :amount_originated, Integer
+
+            # @!method initialize(limit:, amount_originated: nil)
+            #   Credit limits
+            #
+            #   @param limit [Integer] The limit amount
+            #
+            #   @param amount_originated [Integer] Amount originated towards limit
+          end
+
+          # @see Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction#debit
+          class Debit < Lithic::Internal::Type::BaseModel
+            # @!attribute limit
+            #   The limit amount
+            #
+            #   @return [Integer]
+            required :limit, Integer
+
+            # @!attribute amount_originated
+            #   Amount originated towards limit
+            #
+            #   @return [Integer, nil]
+            optional :amount_originated, Integer
+
+            # @!method initialize(limit:, amount_originated: nil)
+            #   Debit limits
+            #
+            #   @param limit [Integer] The limit amount
+            #
+            #   @param amount_originated [Integer] Amount originated towards limit
+          end
+        end
+      end
+    end
+  end
+end

data/lib/lithic/models.rb

@@ -90,14 +90,8 @@ module Lithic
 
   AddressUpdate = Lithic::Models::AddressUpdate
 
-  AggregateBalance = Lithic::Models::AggregateBalance
-
-  AggregateBalanceListParams = Lithic::Models::AggregateBalanceListParams
-
   APIStatus = Lithic::Models::APIStatus
 
-  AsaRequestWebhookEvent = Lithic::Models::AsaRequestWebhookEvent
-
   AuthRules = Lithic::Models::AuthRules
 
   AuthRulesBacktestReportCreatedWebhookEvent = Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent
@@ -122,6 +116,8 @@ module Lithic
 
   BookTransferRetrieveParams = Lithic::Models::BookTransferRetrieveParams
 
+  BookTransferRetryParams = Lithic::Models::BookTransferRetryParams
+
   BookTransferReverseParams = Lithic::Models::BookTransferReverseParams
 
   BookTransferTransactionCreatedWebhookEvent = Lithic::Models::BookTransferTransactionCreatedWebhookEvent
@@ -130,6 +126,9 @@ module Lithic
 
   Card = Lithic::Models::Card
 
+  CardAuthorizationApprovalRequestWebhookEvent =
+    Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent
+
   CardBulkOrder = Lithic::Models::CardBulkOrder
 
   CardBulkOrderCreateParams = Lithic::Models::CardBulkOrderCreateParams
@@ -190,6 +189,8 @@ module Lithic
 
   CardTransactionUpdatedWebhookEvent = Lithic::Models::CardTransactionUpdatedWebhookEvent
 
+  CardUpdatedWebhookEvent = Lithic::Models::CardUpdatedWebhookEvent
+
   CardUpdateParams = Lithic::Models::CardUpdateParams
 
   CardWebProvisionParams = Lithic::Models::CardWebProvisionParams
@@ -478,6 +479,9 @@ module Lithic
 
   ThreeDSAuthentication = Lithic::Models::ThreeDSAuthentication
 
+  ThreeDSAuthenticationApprovalRequestWebhookEvent =
+    Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent
+
   ThreeDSAuthenticationChallengeWebhookEvent = Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent
 
   ThreeDSAuthenticationCreatedWebhookEvent = Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent
@@ -562,6 +566,10 @@ module Lithic
 
   TransferCreateParams = Lithic::Models::TransferCreateParams
 
+  TransferLimitListParams = Lithic::Models::TransferLimitListParams
+
+  TransferLimitsResponse = Lithic::Models::TransferLimitsResponse
+
   VerificationMethod = Lithic::Models::VerificationMethod
 
   WalletDecisioningInfo = Lithic::Models::WalletDecisioningInfo

data/lib/lithic/resources/book_transfers.rb

@@ -113,6 +113,33 @@ module Lithic
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::BookTransferRetryParams} for more details.
+      #
+      # Retry a book transfer that has been declined
+      #
+      # @overload retry_(book_transfer_token, retry_token:, request_options: {})
+      #
+      # @param book_transfer_token [String] Token of the book transfer to retry
+      #
+      # @param retry_token [String] Customer-provided token that will serve as an idempotency token. This token will
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::BookTransferResponse]
+      #
+      # @see Lithic::Models::BookTransferRetryParams
+      def retry_(book_transfer_token, params)
+        parsed, options = Lithic::BookTransferRetryParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/book_transfers/%1$s/retry", book_transfer_token],
+          body: parsed,
+          model: Lithic::BookTransferResponse,
+          options: options
+        )
+      end
+
       # Reverse a book transfer
       #
       # @overload reverse(book_transfer_token, memo: nil, request_options: {})

data/lib/lithic/resources/cards.rb

@@ -3,9 +3,6 @@
 module Lithic
   module Resources
     class Cards
-      # @return [Lithic::Resources::Cards::AggregateBalances]
-      attr_reader :aggregate_balances
-
       # @return [Lithic::Resources::Cards::Balances]
       attr_reader :balances
 
@@ -18,47 +15,49 @@ module Lithic
       # Create a new virtual or physical card. Parameters `shipping_address` and
       # `product_id` only apply to physical cards.
       #
-      # @overload create(type:, account_token: nil, bulk_order_token: nil, card_program_token: nil, carrier: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, memo: nil, pin: nil, product_id: nil, replacement_account_token: nil, replacement_comment: nil, replacement_for: nil, replacement_substatus: nil, shipping_address: nil, shipping_method: nil, spend_limit: nil, spend_limit_duration: nil, state: nil, request_options: {})
+      # @overload create(type:, account_token: nil, bulk_order_token: nil, card_program_token: nil, carrier: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, memo: nil, pin: nil, product_id: nil, replacement_account_token: nil, replacement_comment: nil, replacement_for: nil, replacement_substatus: nil, shipping_address: nil, shipping_method: nil, spend_limit: nil, spend_limit_duration: nil, state: nil, idempotency_key: nil, request_options: {})
       #
-      # @param type [Symbol, Lithic::Models::CardCreateParams::Type] Card types:
+      # @param type [Symbol, Lithic::Models::CardCreateParams::Type] Body param: Card types:
       #
-      # @param account_token [String] Globally unique identifier for the account that the card will be associated with
+      # @param account_token [String] Body param: Globally unique identifier for the account that the card will be ass
       #
-      # @param bulk_order_token [String] Globally unique identifier for an existing bulk order to associate this card wit
+      # @param bulk_order_token [String] Body param: Globally unique identifier for an existing bulk order to associate t
       #
-      # @param card_program_token [String] For card programs with more than one BIN range. This must be configured with Lit
+      # @param card_program_token [String] Body param: For card programs with more than one BIN range. This must be configu
       #
-      # @param carrier [Lithic::Models::Carrier]
+      # @param carrier [Lithic::Models::Carrier] Body param
       #
-      # @param digital_card_art_token [String] Specifies the digital card art to be displayed in the user’s digital wallet afte
+      # @param digital_card_art_token [String] Body param: Specifies the digital card art to be displayed in the user’s digital
       #
-      # @param exp_month [String] Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
+      # @param exp_month [String] Body param: Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` i
       #
-      # @param exp_year [String] Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is provided
+      # @param exp_year [String] Body param: Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year`
       #
-      # @param memo [String] Friendly name to identify the card.
+      # @param memo [String] Body param: Friendly name to identify the card.
       #
-      # @param pin [String] Encrypted PIN block (in base64). Applies to cards of type `PHYSICAL` and `VIRTUA
+      # @param pin [String] Body param: Encrypted PIN block (in base64). Applies to cards of type `PHYSICAL`
       #
-      # @param product_id [String] Only applicable to cards of type `PHYSICAL`. This must be configured with Lithic
+      # @param product_id [String] Body param: Only applicable to cards of type `PHYSICAL`. This must be configured
       #
-      # @param replacement_account_token [String] Restricted field limited to select use cases. Lithic will reach out directly if
+      # @param replacement_account_token [String] Body param: Restricted field limited to select use cases. Lithic will reach out
       #
-      # @param replacement_comment [String] Additional context or information related to the card that this card will replac
+      # @param replacement_comment [String] Body param: Additional context or information related to the card that this card
       #
-      # @param replacement_for [String] Globally unique identifier for the card that this card will replace. If the card
+      # @param replacement_for [String] Body param: Globally unique identifier for the card that this card will replace.
       #
-      # @param replacement_substatus [Symbol, Lithic::Models::CardCreateParams::ReplacementSubstatus] Card state substatus values for the card that this card will replace:
+      # @param replacement_substatus [Symbol, Lithic::Models::CardCreateParams::ReplacementSubstatus] Body param: Card state substatus values for the card that this card will replace
       #
-      # @param shipping_address [Lithic::Models::ShippingAddress]
+      # @param shipping_address [Lithic::Models::ShippingAddress] Body param
       #
-      # @param shipping_method [Symbol, Lithic::Models::CardCreateParams::ShippingMethod] Shipping method for the card. Only applies to cards of type PHYSICAL.
+      # @param shipping_method [Symbol, Lithic::Models::CardCreateParams::ShippingMethod] Body param: Shipping method for the card. Only applies to cards of type PHYSICAL
       #
-      # @param spend_limit [Integer] Amount (in cents) to limit approved authorizations (e.g. 100000 would be a $1,00
+      # @param spend_limit [Integer] Body param: Amount (in cents) to limit approved authorizations (e.g. 100000 woul
       #
-      # @param spend_limit_duration [Symbol, Lithic::Models::SpendLimitDuration] Spend limit duration values:
+      # @param spend_limit_duration [Symbol, Lithic::Models::SpendLimitDuration] Body param: Spend limit duration values:
       #
-      # @param state [Symbol, Lithic::Models::CardCreateParams::State] Card state values:
+      # @param state [Symbol, Lithic::Models::CardCreateParams::State] Body param: Card state values:
+      #
+      # @param idempotency_key [String] Header param: Idempotency key for the request
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -67,7 +66,15 @@ module Lithic
       # @see Lithic::Models::CardCreateParams
       def create(params)
         parsed, options = Lithic::CardCreateParams.dump_request(params)
-        @client.request(method: :post, path: "v1/cards", body: parsed, model: Lithic::Card, options: options)
+        header_params = {idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :post,
+          path: "v1/cards",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Lithic::Card,
+          options: options
+        )
       end
 
       # Get card configuration such as spend limit and state.
@@ -447,7 +454,7 @@ module Lithic
       # {Lithic::Models::CardWebProvisionParams} for more details.
       #
       # Allow your cardholders to directly add payment cards to the device's digital
-      # wallet from a browser on the web. Currently only suported for Apple Pay.
+      # wallet from a browser on the web.
       #
       # This requires some additional setup and configuration. Please
       # [Contact Us](https://lithic.com/contact) or your Customer Success representative
@@ -486,7 +493,6 @@ module Lithic
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client
-        @aggregate_balances = Lithic::Resources::Cards::AggregateBalances.new(client: client)
         @balances = Lithic::Resources::Cards::Balances.new(client: client)
         @financial_transactions = Lithic::Resources::Cards::FinancialTransactions.new(client: client)
       end