lithic 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.4

data/lib/lithic/resources/tokenization_decisioning.rb

@@ -10,11 +10,13 @@ module Lithic
       #   [this page](https://docs.lithic.com/docs/events-api#verifying-webhooks) for more
       #   detail about verifying Tokenization Decisioning requests.
       #
-      # @param params [Lithic::Models::TokenizationDecisioningRetrieveSecretParams, Hash{Symbol=>Object}] .
+      # @overload retrieve_secret(request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TokenizationSecret]
+      #
+      # @see Lithic::Models::TokenizationDecisioningRetrieveSecretParams
       def retrieve_secret(params = {})
         @client.request(
           method: :get,
@@ -28,11 +30,13 @@ module Lithic
       #   Decisioning secret key will be deactivated 24 hours after a successful request
       #   to this endpoint.
       #
-      # @param params [Lithic::Models::TokenizationDecisioningRotateSecretParams, Hash{Symbol=>Object}] .
+      # @overload rotate_secret(request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TokenizationDecisioningRotateSecretResponse]
+      #
+      # @see Lithic::Models::TokenizationDecisioningRotateSecretParams
       def rotate_secret(params = {})
         @client.request(
           method: :post,
@@ -42,6 +46,8 @@ module Lithic
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/resources/tokenizations.rb

@@ -5,17 +5,18 @@ module Lithic
     class Tokenizations
       # Get tokenization
       #
-      # @param tokenization_token [String] Tokenization token
+      # @overload retrieve(tokenization_token, request_options: {})
       #
-      # @param params [Lithic::Models::TokenizationRetrieveParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param tokenization_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TokenizationRetrieveResponse]
+      #
+      # @see Lithic::Models::TokenizationRetrieveParams
       def retrieve(tokenization_token, params = {})
         @client.request(
           method: :get,
-          path: ["v1/tokenizations/%0s", tokenization_token],
+          path: ["v1/tokenizations/%1$s", tokenization_token],
           model: Lithic::Models::TokenizationRetrieveResponse,
           options: params[:request_options]
         )
@@ -23,30 +24,21 @@ module Lithic
 
       # List card tokenizations
       #
-      # @param params [Lithic::Models::TokenizationListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :account_token Filters for tokenizations associated with a specific account.
-      #
-      #   @option params [Date] :begin_ Filter for tokenizations created after this date.
-      #
-      #   @option params [String] :card_token Filters for tokenizations associated with a specific card.
-      #
-      #   @option params [Date] :end_ Filter for tokenizations created before this date.
-      #
-      #   @option params [String] :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.
-      #
-      #   @option params [Integer] :page_size Page size (for pagination).
-      #
-      #   @option params [String] :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.
+      # @overload list(account_token: nil, begin_: nil, card_token: nil, end_: nil, ending_before: nil, page_size: nil, starting_after: nil, tokenization_channel: nil, request_options: {})
       #
-      #   @option params [Symbol, Lithic::Models::TokenizationListParams::TokenizationChannel] :tokenization_channel Filter for tokenizations by tokenization channel. If this is not specified, only
-      #     DIGITAL_WALLET tokenizations will be returned.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param account_token [String]
+      # @param begin_ [Date]
+      # @param card_token [String]
+      # @param end_ [Date]
+      # @param ending_before [String]
+      # @param page_size [Integer]
+      # @param starting_after [String]
+      # @param tokenization_channel [Symbol, Lithic::Models::TokenizationListParams::TokenizationChannel]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::CursorPage<Lithic::Models::Tokenization>]
+      #
+      # @see Lithic::Models::TokenizationListParams
       def list(params = {})
         parsed, options = Lithic::Models::TokenizationListParams.dump_request(params)
         @client.request(
@@ -68,17 +60,18 @@ module Lithic
       #   active state, and transactions will be allowed. Reach out at
       #   [lithic.com/contact](https://lithic.com/contact) for more information.
       #
-      # @param tokenization_token [String] Tokenization token
-      #
-      # @param params [Lithic::Models::TokenizationActivateParams, Hash{Symbol=>Object}] .
+      # @overload activate(tokenization_token, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param tokenization_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
+      #
+      # @see Lithic::Models::TokenizationActivateParams
       def activate(tokenization_token, params = {})
         @client.request(
           method: :post,
-          path: ["v1/tokenizations/%0s/activate", tokenization_token],
+          path: ["v1/tokenizations/%1$s/activate", tokenization_token],
           model: NilClass,
           options: params[:request_options]
         )
@@ -94,17 +87,18 @@ module Lithic
       #   from its device. Reach out at [lithic.com/contact](https://lithic.com/contact)
       #   for more information.
       #
-      # @param tokenization_token [String] Tokenization token
-      #
-      # @param params [Lithic::Models::TokenizationDeactivateParams, Hash{Symbol=>Object}] .
+      # @overload deactivate(tokenization_token, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param tokenization_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
+      #
+      # @see Lithic::Models::TokenizationDeactivateParams
       def deactivate(tokenization_token, params = {})
         @client.request(
           method: :post,
-          path: ["v1/tokenizations/%0s/deactivate", tokenization_token],
+          path: ["v1/tokenizations/%1$s/deactivate", tokenization_token],
           model: NilClass,
           options: params[:request_options]
         )
@@ -119,17 +113,18 @@ module Lithic
       #   changed. Reach out at [lithic.com/contact](https://lithic.com/contact) for more
       #   information.
       #
-      # @param tokenization_token [String] Tokenization token
-      #
-      # @param params [Lithic::Models::TokenizationPauseParams, Hash{Symbol=>Object}] .
+      # @overload pause(tokenization_token, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param tokenization_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
+      #
+      # @see Lithic::Models::TokenizationPauseParams
       def pause(tokenization_token, params = {})
         @client.request(
           method: :post,
-          path: ["v1/tokenizations/%0s/pause", tokenization_token],
+          path: ["v1/tokenizations/%1$s/pause", tokenization_token],
           model: NilClass,
           options: params[:request_options]
         )
@@ -146,22 +141,20 @@ module Lithic
       #   cardholder must restart the provision process. Reach out at
       #   [lithic.com/contact](https://lithic.com/contact) for more information.
       #
-      # @param tokenization_token [String] Tokenization token
-      #
-      # @param params [Lithic::Models::TokenizationResendActivationCodeParams, Hash{Symbol=>Object}] .
+      # @overload resend_activation_code(tokenization_token, activation_method_type: nil, request_options: {})
       #
-      #   @option params [Symbol, Lithic::Models::TokenizationResendActivationCodeParams::ActivationMethodType] :activation_method_type The communication method that the user has selected to use to receive the
-      #     authentication code. Supported Values: Sms = "TEXT_TO_CARDHOLDER_NUMBER". Email
-      #     = "EMAIL_TO_CARDHOLDER_ADDRESS"
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param tokenization_token [String]
+      # @param activation_method_type [Symbol, Lithic::Models::TokenizationResendActivationCodeParams::ActivationMethodType]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
+      #
+      # @see Lithic::Models::TokenizationResendActivationCodeParams
       def resend_activation_code(tokenization_token, params = {})
         parsed, options = Lithic::Models::TokenizationResendActivationCodeParams.dump_request(params)
         @client.request(
           method: :post,
-          path: ["v1/tokenizations/%0s/resend_activation_code", tokenization_token],
+          path: ["v1/tokenizations/%1$s/resend_activation_code", tokenization_token],
           body: parsed,
           model: NilClass,
           options: options
@@ -171,30 +164,21 @@ module Lithic
       # This endpoint is used to simulate a card's tokenization in the Digital Wallet
       #   and merchant tokenization ecosystem.
       #
-      # @param params [Lithic::Models::TokenizationSimulateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :cvv The three digit cvv for the card.
-      #
-      #   @option params [String] :expiration_date The expiration date of the card in 'MM/YY' format.
-      #
-      #   @option params [String] :pan The sixteen digit card number.
-      #
-      #   @option params [Symbol, Lithic::Models::TokenizationSimulateParams::TokenizationSource] :tokenization_source The source of the tokenization request.
-      #
-      #   @option params [Integer] :account_score The account score (1-5) that represents how the Digital Wallet's view on how
-      #     reputable an end user's account is.
-      #
-      #   @option params [Integer] :device_score The device score (1-5) that represents how the Digital Wallet's view on how
-      #     reputable an end user's device is.
-      #
-      #   @option params [String] :entity Optional field to specify the token requestor name for a merchant token
-      #     simulation. Ignored when tokenization_source is not MERCHANT.
+      # @overload simulate(cvv:, expiration_date:, pan:, tokenization_source:, account_score: nil, device_score: nil, entity: nil, wallet_recommended_decision: nil, request_options: {})
       #
-      #   @option params [Symbol, Lithic::Models::TokenizationSimulateParams::WalletRecommendedDecision] :wallet_recommended_decision The decision that the Digital Wallet's recommend
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param cvv [String]
+      # @param expiration_date [String]
+      # @param pan [String]
+      # @param tokenization_source [Symbol, Lithic::Models::TokenizationSimulateParams::TokenizationSource]
+      # @param account_score [Integer]
+      # @param device_score [Integer]
+      # @param entity [String]
+      # @param wallet_recommended_decision [Symbol, Lithic::Models::TokenizationSimulateParams::WalletRecommendedDecision]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TokenizationSimulateResponse]
+      #
+      # @see Lithic::Models::TokenizationSimulateParams
       def simulate(params)
         parsed, options = Lithic::Models::TokenizationSimulateParams.dump_request(params)
         @client.request(
@@ -214,17 +198,18 @@ module Lithic
       #   active state, and transactions may resume. Reach out at
       #   [lithic.com/contact](https://lithic.com/contact) for more information.
       #
-      # @param tokenization_token [String] Tokenization token
+      # @overload unpause(tokenization_token, request_options: {})
       #
-      # @param params [Lithic::Models::TokenizationUnpauseParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param tokenization_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
+      #
+      # @see Lithic::Models::TokenizationUnpauseParams
       def unpause(tokenization_token, params = {})
         @client.request(
           method: :post,
-          path: ["v1/tokenizations/%0s/unpause", tokenization_token],
+          path: ["v1/tokenizations/%1$s/unpause", tokenization_token],
           model: NilClass,
           options: params[:request_options]
         )
@@ -239,29 +224,28 @@ module Lithic
       #   the art referenced in the card object's `digital_card_art_token` field. Reach
       #   out at [lithic.com/contact](https://lithic.com/contact) for more information.
       #
-      # @param tokenization_token [String] Tokenization token
+      # @overload update_digital_card_art(tokenization_token, digital_card_art_token: nil, request_options: {})
       #
-      # @param params [Lithic::Models::TokenizationUpdateDigitalCardArtParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :digital_card_art_token Specifies the digital card art to be displayed in the user’s digital wallet for
-      #     a tokenization. This artwork must be approved by the network and configured by
-      #     Lithic to use. See
-      #     [Flexible Card Art Guide](https://docs.lithic.com/docs/about-digital-wallets#flexible-card-art).
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param tokenization_token [String]
+      # @param digital_card_art_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TokenizationUpdateDigitalCardArtResponse]
+      #
+      # @see Lithic::Models::TokenizationUpdateDigitalCardArtParams
       def update_digital_card_art(tokenization_token, params = {})
         parsed, options = Lithic::Models::TokenizationUpdateDigitalCardArtParams.dump_request(params)
         @client.request(
           method: :post,
-          path: ["v1/tokenizations/%0s/update_digital_card_art", tokenization_token],
+          path: ["v1/tokenizations/%1$s/update_digital_card_art", tokenization_token],
           body: parsed,
           model: Lithic::Models::TokenizationUpdateDigitalCardArtResponse,
           options: options
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/resources/transactions/enhanced_commercial_data.rb

@@ -7,22 +7,25 @@ module Lithic
         # Get all L2/L3 enhanced commercial data associated with a transaction. Not
         #   available in sandbox.
         #
-        # @param transaction_token [String] The token of the transaction that the enhanced data is associated with.
+        # @overload retrieve(transaction_token, request_options: {})
         #
-        # @param params [Lithic::Models::Transactions::EnhancedCommercialDataRetrieveParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param transaction_token [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::Models::Transactions::EnhancedCommercialDataRetrieveResponse]
+        #
+        # @see Lithic::Models::Transactions::EnhancedCommercialDataRetrieveParams
         def retrieve(transaction_token, params = {})
           @client.request(
             method: :get,
-            path: ["v1/transactions/%0s/enhanced_commercial_data", transaction_token],
+            path: ["v1/transactions/%1$s/enhanced_commercial_data", transaction_token],
             model: Lithic::Models::Transactions::EnhancedCommercialDataRetrieveResponse,
             options: params[:request_options]
           )
         end
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client

data/lib/lithic/resources/transactions/events/enhanced_commercial_data.rb

@@ -8,22 +8,25 @@ module Lithic
           # Get L2/L3 enhanced commercial data associated with a transaction event. Not
           #   available in sandbox.
           #
-          # @param event_token [String] The token of the transaction event that the enhanced data is associated with.
+          # @overload retrieve(event_token, request_options: {})
           #
-          # @param params [Lithic::Models::Transactions::Events::EnhancedCommercialDataRetrieveParams, Hash{Symbol=>Object}] .
-          #
-          #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+          # @param event_token [String]
+          # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Lithic::Models::Transactions::Events::EnhancedData]
+          #
+          # @see Lithic::Models::Transactions::Events::EnhancedCommercialDataRetrieveParams
           def retrieve(event_token, params = {})
             @client.request(
               method: :get,
-              path: ["v1/transactions/events/%0s/enhanced_commercial_data", event_token],
+              path: ["v1/transactions/events/%1$s/enhanced_commercial_data", event_token],
               model: Lithic::Models::Transactions::Events::EnhancedData,
               options: params[:request_options]
             )
           end
 
+          # @api private
+          #
           # @param client [Lithic::Client]
           def initialize(client:)
             @client = client

data/lib/lithic/resources/transactions/events.rb

@@ -7,6 +7,8 @@ module Lithic
         # @return [Lithic::Resources::Transactions::Events::EnhancedCommercialData]
         attr_reader :enhanced_commercial_data
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client