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

data/lib/lithic/resources/payments.rb

@@ -5,30 +5,22 @@ module Lithic
     class Payments
       # Initiates a payment between a financial account and an external bank account.
       #
-      # @param params [Lithic::Models::PaymentCreateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Integer] :amount
-      #
-      #   @option params [String] :external_bank_account_token
-      #
-      #   @option params [String] :financial_account_token
-      #
-      #   @option params [Symbol, Lithic::Models::PaymentCreateParams::Method] :method_
-      #
-      #   @option params [Lithic::Models::PaymentCreateParams::MethodAttributes] :method_attributes
-      #
-      #   @option params [Symbol, Lithic::Models::PaymentCreateParams::Type] :type
-      #
-      #   @option params [String] :token Customer-provided token that will serve as an idempotency token. This token will
-      #     become the transaction token.
-      #
-      #   @option params [String] :memo
-      #
-      #   @option params [String] :user_defined_id
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @overload create(amount:, external_bank_account_token:, financial_account_token:, method_:, method_attributes:, type:, token: nil, memo: nil, user_defined_id: nil, request_options: {})
+      #
+      # @param amount [Integer]
+      # @param external_bank_account_token [String]
+      # @param financial_account_token [String]
+      # @param method_ [Symbol, Lithic::Models::PaymentCreateParams::Method]
+      # @param method_attributes [Lithic::Models::PaymentCreateParams::MethodAttributes]
+      # @param type [Symbol, Lithic::Models::PaymentCreateParams::Type]
+      # @param token [String]
+      # @param memo [String]
+      # @param user_defined_id [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::PaymentCreateResponse]
+      #
+      # @see Lithic::Models::PaymentCreateParams
       def create(params)
         parsed, options = Lithic::Models::PaymentCreateParams.dump_request(params)
         @client.request(
@@ -42,17 +34,18 @@ module Lithic
 
       # Get the payment by token.
       #
-      # @param payment_token [String]
-      #
-      # @param params [Lithic::Models::PaymentRetrieveParams, Hash{Symbol=>Object}] .
+      # @overload retrieve(payment_token, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param payment_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::Payment]
+      #
+      # @see Lithic::Models::PaymentRetrieveParams
       def retrieve(payment_token, params = {})
         @client.request(
           method: :get,
-          path: ["v1/payments/%0s", payment_token],
+          path: ["v1/payments/%1$s", payment_token],
           model: Lithic::Models::Payment,
           options: params[:request_options]
         )
@@ -60,37 +53,24 @@ module Lithic
 
       # List all the payments for the provided search criteria.
       #
-      # @param params [Lithic::Models::PaymentListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :account_token
-      #
-      #   @option params [Time] :begin_ Date string in RFC 3339 format. Only entries created after the specified time
-      #     will be included. UTC time zone.
-      #
-      #   @option params [String] :business_account_token
-      #
-      #   @option params [Symbol, Lithic::Models::PaymentListParams::Category] :category
-      #
-      #   @option params [Time] :end_ Date string in RFC 3339 format. Only entries created before the specified time
-      #     will be included. UTC time zone.
-      #
-      #   @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 [String] :financial_account_token
-      #
-      #   @option params [Integer] :page_size Page size (for pagination).
-      #
-      #   @option params [Symbol, Lithic::Models::PaymentListParams::Result] :result
-      #
-      #   @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.
-      #
-      #   @option params [Symbol, Lithic::Models::PaymentListParams::Status] :status
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @overload list(account_token: nil, begin_: nil, business_account_token: nil, category: nil, end_: nil, ending_before: nil, financial_account_token: nil, page_size: nil, result: nil, starting_after: nil, status: nil, request_options: {})
+      #
+      # @param account_token [String]
+      # @param begin_ [Time]
+      # @param business_account_token [String]
+      # @param category [Symbol, Lithic::Models::PaymentListParams::Category]
+      # @param end_ [Time]
+      # @param ending_before [String]
+      # @param financial_account_token [String]
+      # @param page_size [Integer]
+      # @param result [Symbol, Lithic::Models::PaymentListParams::Result]
+      # @param starting_after [String]
+      # @param status [Symbol, Lithic::Models::PaymentListParams::Status]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::CursorPage<Lithic::Models::Payment>]
+      #
+      # @see Lithic::Models::PaymentListParams
       def list(params = {})
         parsed, options = Lithic::Models::PaymentListParams.dump_request(params)
         @client.request(
@@ -105,17 +85,18 @@ module Lithic
 
       # Retry an origination which has been returned.
       #
-      # @param payment_token [String]
-      #
-      # @param params [Lithic::Models::PaymentRetryParams, Hash{Symbol=>Object}] .
+      # @overload retry_(payment_token, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param payment_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::PaymentRetryResponse]
+      #
+      # @see Lithic::Models::PaymentRetryParams
       def retry_(payment_token, params = {})
         @client.request(
           method: :post,
-          path: ["v1/payments/%0s/retry", payment_token],
+          path: ["v1/payments/%1$s/retry", payment_token],
           model: Lithic::Models::PaymentRetryResponse,
           options: params[:request_options]
         )
@@ -123,24 +104,22 @@ module Lithic
 
       # Simulate payment lifecycle event
       #
-      # @param payment_token [String]
-      #
-      # @param params [Lithic::Models::PaymentSimulateActionParams, Hash{Symbol=>Object}] .
+      # @overload simulate_action(payment_token, event_type:, decline_reason: nil, return_reason_code: nil, request_options: {})
       #
-      #   @option params [Symbol, Lithic::Models::PaymentSimulateActionParams::EventType] :event_type Event Type
-      #
-      #   @option params [Symbol, Lithic::Models::PaymentSimulateActionParams::DeclineReason] :decline_reason Decline reason
-      #
-      #   @option params [String] :return_reason_code Return Reason Code
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param payment_token [String]
+      # @param event_type [Symbol, Lithic::Models::PaymentSimulateActionParams::EventType]
+      # @param decline_reason [Symbol, Lithic::Models::PaymentSimulateActionParams::DeclineReason]
+      # @param return_reason_code [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::PaymentSimulateActionResponse]
+      #
+      # @see Lithic::Models::PaymentSimulateActionParams
       def simulate_action(payment_token, params)
         parsed, options = Lithic::Models::PaymentSimulateActionParams.dump_request(params)
         @client.request(
           method: :post,
-          path: ["v1/simulate/payments/%0s/action", payment_token],
+          path: ["v1/simulate/payments/%1$s/action", payment_token],
           body: parsed,
           model: Lithic::Models::PaymentSimulateActionResponse,
           options: options
@@ -149,21 +128,18 @@ module Lithic
 
       # Simulates a receipt of a Payment.
       #
-      # @param params [Lithic::Models::PaymentSimulateReceiptParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :token Payment token
+      # @overload simulate_receipt(token:, amount:, financial_account_token:, receipt_type:, memo: nil, request_options: {})
       #
-      #   @option params [Integer] :amount Amount
-      #
-      #   @option params [String] :financial_account_token Financial Account Token
-      #
-      #   @option params [Symbol, Lithic::Models::PaymentSimulateReceiptParams::ReceiptType] :receipt_type Receipt Type
-      #
-      #   @option params [String] :memo Memo
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param token [String]
+      # @param amount [Integer]
+      # @param financial_account_token [String]
+      # @param receipt_type [Symbol, Lithic::Models::PaymentSimulateReceiptParams::ReceiptType]
+      # @param memo [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::PaymentSimulateReceiptResponse]
+      #
+      # @see Lithic::Models::PaymentSimulateReceiptParams
       def simulate_receipt(params)
         parsed, options = Lithic::Models::PaymentSimulateReceiptParams.dump_request(params)
         @client.request(
@@ -177,13 +153,14 @@ module Lithic
 
       # Simulates a release of a Payment.
       #
-      # @param params [Lithic::Models::PaymentSimulateReleaseParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :payment_token Payment Token
+      # @overload simulate_release(payment_token:, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param payment_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::PaymentSimulateReleaseResponse]
+      #
+      # @see Lithic::Models::PaymentSimulateReleaseParams
       def simulate_release(params)
         parsed, options = Lithic::Models::PaymentSimulateReleaseParams.dump_request(params)
         @client.request(
@@ -197,15 +174,15 @@ module Lithic
 
       # Simulates a return of a Payment.
       #
-      # @param params [Lithic::Models::PaymentSimulateReturnParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :payment_token Payment Token
-      #
-      #   @option params [String] :return_reason_code Return Reason Code
+      # @overload simulate_return(payment_token:, return_reason_code: nil, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param payment_token [String]
+      # @param return_reason_code [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::PaymentSimulateReturnResponse]
+      #
+      # @see Lithic::Models::PaymentSimulateReturnParams
       def simulate_return(params)
         parsed, options = Lithic::Models::PaymentSimulateReturnParams.dump_request(params)
         @client.request(
@@ -217,6 +194,8 @@ module Lithic
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/resources/reports/settlement/network_totals.rb

@@ -7,17 +7,18 @@ module Lithic
         class NetworkTotals
           # Retrieve a specific network total record by token. Not available in sandbox.
           #
-          # @param token [String] Token of the network total record to retrieve
+          # @overload retrieve(token, request_options: {})
           #
-          # @param params [Lithic::Models::Reports::Settlement::NetworkTotalRetrieveParams, Hash{Symbol=>Object}] .
-          #
-          #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+          # @param token [String]
+          # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Lithic::Models::Reports::Settlement::NetworkTotalRetrieveResponse]
+          #
+          # @see Lithic::Models::Reports::Settlement::NetworkTotalRetrieveParams
           def retrieve(token, params = {})
             @client.request(
               method: :get,
-              path: ["v1/reports/settlement/network_totals/%0s", token],
+              path: ["v1/reports/settlement/network_totals/%1$s", token],
               model: Lithic::Models::Reports::Settlement::NetworkTotalRetrieveResponse,
               options: params[:request_options]
             )
@@ -25,38 +26,24 @@ module Lithic
 
           # List network total records with optional filters. Not available in sandbox.
           #
-          # @param params [Lithic::Models::Reports::Settlement::NetworkTotalListParams, Hash{Symbol=>Object}] .
-          #
-          #   @option params [Time] :begin_ Datetime in RFC 3339 format. Only entries created after the specified time will
-          #     be included. UTC time zone.
-          #
-          #   @option params [Time] :end_ Datetime in RFC 3339 format. Only entries created before the specified time will
-          #     be included. UTC time zone.
-          #
-          #   @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 [String] :institution_id Institution ID to filter on.
-          #
-          #   @option params [Symbol, Lithic::Models::Reports::Settlement::NetworkTotalListParams::Network] :network Network to filter on.
-          #
-          #   @option params [Integer] :page_size Number of records per page.
-          #
-          #   @option params [Date] :report_date Singular report date to filter on (YYYY-MM-DD). Cannot be populated in
-          #     conjunction with report_date_begin or report_date_end.
-          #
-          #   @option params [Date] :report_date_begin Earliest report date to filter on, inclusive (YYYY-MM-DD).
-          #
-          #   @option params [Date] :report_date_end Latest report date to filter on, inclusive (YYYY-MM-DD).
-          #
-          #   @option params [String] :settlement_institution_id Settlement institution ID to filter on.
-          #
-          #   @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.
-          #
-          #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+          # @overload list(begin_: nil, end_: nil, ending_before: nil, institution_id: nil, network: nil, page_size: nil, report_date: nil, report_date_begin: nil, report_date_end: nil, settlement_institution_id: nil, starting_after: nil, request_options: {})
+          #
+          # @param begin_ [Time]
+          # @param end_ [Time]
+          # @param ending_before [String]
+          # @param institution_id [String]
+          # @param network [Symbol, Lithic::Models::Reports::Settlement::NetworkTotalListParams::Network]
+          # @param page_size [Integer]
+          # @param report_date [Date]
+          # @param report_date_begin [Date]
+          # @param report_date_end [Date]
+          # @param settlement_institution_id [String]
+          # @param starting_after [String]
+          # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Lithic::CursorPage<Lithic::Models::Reports::Settlement::NetworkTotalListResponse>]
+          #
+          # @see Lithic::Models::Reports::Settlement::NetworkTotalListParams
           def list(params = {})
             parsed, options = Lithic::Models::Reports::Settlement::NetworkTotalListParams.dump_request(params)
             @client.request(
@@ -69,6 +56,8 @@ module Lithic
             )
           end
 
+          # @api private
+          #
           # @param client [Lithic::Client]
           def initialize(client:)
             @client = client

data/lib/lithic/resources/reports/settlement.rb

@@ -9,26 +9,22 @@ module Lithic
 
         # List details.
         #
-        # @param report_date [Date] Date of the settlement report to retrieve. Not available in sandbox.
+        # @overload list_details(report_date, ending_before: nil, page_size: nil, starting_after: nil, request_options: {})
         #
-        # @param params [Lithic::Models::Reports::SettlementListDetailsParams, Hash{Symbol=>Object}] .
-        #
-        #   @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.
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param report_date [Date]
+        # @param ending_before [String]
+        # @param page_size [Integer]
+        # @param starting_after [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::CursorPage<Lithic::Models::SettlementDetail>]
+        #
+        # @see Lithic::Models::Reports::SettlementListDetailsParams
         def list_details(report_date, params = {})
           parsed, options = Lithic::Models::Reports::SettlementListDetailsParams.dump_request(params)
           @client.request(
             method: :get,
-            path: ["v1/reports/settlement/details/%0s", report_date],
+            path: ["v1/reports/settlement/details/%1$s", report_date],
             query: parsed,
             page: Lithic::CursorPage,
             model: Lithic::Models::SettlementDetail,
@@ -38,22 +34,25 @@ module Lithic
 
         # Get the settlement report for a specified report date. Not available in sandbox.
         #
-        # @param report_date [Date] Date of the settlement report to retrieve.
-        #
-        # @param params [Lithic::Models::Reports::SettlementSummaryParams, Hash{Symbol=>Object}] .
+        # @overload summary(report_date, request_options: {})
         #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param report_date [Date]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::Models::SettlementReport]
+        #
+        # @see Lithic::Models::Reports::SettlementSummaryParams
         def summary(report_date, params = {})
           @client.request(
             method: :get,
-            path: ["v1/reports/settlement/summary/%0s", report_date],
+            path: ["v1/reports/settlement/summary/%1$s", report_date],
             model: Lithic::Models::SettlementReport,
             options: params[:request_options]
           )
         end
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client

data/lib/lithic/resources/reports.rb

@@ -6,6 +6,8 @@ module Lithic
       # @return [Lithic::Resources::Reports::Settlement]
       attr_reader :settlement
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/resources/responder_endpoints.rb

@@ -5,15 +5,15 @@ module Lithic
     class ResponderEndpoints
       # Enroll a responder endpoint
       #
-      # @param params [Lithic::Models::ResponderEndpointCreateParams, Hash{Symbol=>Object}] .
+      # @overload create(type: nil, url: nil, request_options: {})
       #
-      #   @option params [Symbol, Lithic::Models::ResponderEndpointCreateParams::Type] :type The type of the endpoint.
-      #
-      #   @option params [String] :url The URL for the responder endpoint (must be http(s)).
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param type [Symbol, Lithic::Models::ResponderEndpointCreateParams::Type]
+      # @param url [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::ResponderEndpointCreateResponse]
+      #
+      # @see Lithic::Models::ResponderEndpointCreateParams
       def create(params = {})
         parsed, options = Lithic::Models::ResponderEndpointCreateParams.dump_request(params)
         @client.request(
@@ -27,13 +27,14 @@ module Lithic
 
       # Disenroll a responder endpoint
       #
-      # @param params [Lithic::Models::ResponderEndpointDeleteParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Symbol, Lithic::Models::ResponderEndpointDeleteParams::Type] :type The type of the endpoint.
+      # @overload delete(type:, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param type [Symbol, Lithic::Models::ResponderEndpointDeleteParams::Type]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
+      #
+      # @see Lithic::Models::ResponderEndpointDeleteParams
       def delete(params)
         parsed, options = Lithic::Models::ResponderEndpointDeleteParams.dump_request(params)
         @client.request(
@@ -47,13 +48,14 @@ module Lithic
 
       # Check the status of a responder endpoint
       #
-      # @param params [Lithic::Models::ResponderEndpointCheckStatusParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Symbol, Lithic::Models::ResponderEndpointCheckStatusParams::Type] :type The type of the endpoint.
+      # @overload check_status(type:, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param type [Symbol, Lithic::Models::ResponderEndpointCheckStatusParams::Type]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::ResponderEndpointStatus]
+      #
+      # @see Lithic::Models::ResponderEndpointCheckStatusParams
       def check_status(params)
         parsed, options = Lithic::Models::ResponderEndpointCheckStatusParams.dump_request(params)
         @client.request(
@@ -65,6 +67,8 @@ module Lithic
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/resources/three_ds/authentication.rb

@@ -6,17 +6,18 @@ module Lithic
       class Authentication
         # Get 3DS Authentication by token
         #
-        # @param three_ds_authentication_token [String] 3DS Authentication Token
+        # @overload retrieve(three_ds_authentication_token, request_options: {})
         #
-        # @param params [Lithic::Models::ThreeDS::AuthenticationRetrieveParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param three_ds_authentication_token [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::Models::ThreeDS::AuthenticationRetrieveResponse]
+        #
+        # @see Lithic::Models::ThreeDS::AuthenticationRetrieveParams
         def retrieve(three_ds_authentication_token, params = {})
           @client.request(
             method: :get,
-            path: ["v1/three_ds_authentication/%0s", three_ds_authentication_token],
+            path: ["v1/three_ds_authentication/%1$s", three_ds_authentication_token],
             model: Lithic::Models::ThreeDS::AuthenticationRetrieveResponse,
             options: params[:request_options]
           )
@@ -27,20 +28,17 @@ module Lithic
         #   authentications requires your customer decisioning endpoint to be set up
         #   properly (respond with a valid JSON).
         #
-        # @param params [Lithic::Models::ThreeDS::AuthenticationSimulateParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [Lithic::Models::ThreeDS::AuthenticationSimulateParams::Merchant] :merchant
-        #
-        #   @option params [String] :pan Sixteen digit card number.
-        #
-        #   @option params [Lithic::Models::ThreeDS::AuthenticationSimulateParams::Transaction] :transaction
-        #
-        #   @option params [Symbol, Lithic::Models::ThreeDS::AuthenticationSimulateParams::CardExpiryCheck] :card_expiry_check When set will use the following values as part of the Simulated Authentication.
-        #     When not set defaults to MATCH
+        # @overload simulate(merchant:, pan:, transaction:, card_expiry_check: nil, request_options: {})
         #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param merchant [Lithic::Models::ThreeDS::AuthenticationSimulateParams::Merchant]
+        # @param pan [String]
+        # @param transaction [Lithic::Models::ThreeDS::AuthenticationSimulateParams::Transaction]
+        # @param card_expiry_check [Symbol, Lithic::Models::ThreeDS::AuthenticationSimulateParams::CardExpiryCheck]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::Models::ThreeDS::AuthenticationSimulateResponse]
+        #
+        # @see Lithic::Models::ThreeDS::AuthenticationSimulateParams
         def simulate(params)
           parsed, options = Lithic::Models::ThreeDS::AuthenticationSimulateParams.dump_request(params)
           @client.request(
@@ -57,16 +55,15 @@ module Lithic
         #   challenge must precede. Only a single attempt is supported; upon entering OTP,
         #   the challenge is either approved or declined.
         #
-        # @param params [Lithic::Models::ThreeDS::AuthenticationSimulateOtpEntryParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :token A unique token returned as part of a /v1/three_ds_authentication/simulate call
-        #     that resulted in PENDING_CHALLENGE authentication result.
-        #
-        #   @option params [String] :otp The OTP entered by the cardholder
+        # @overload simulate_otp_entry(token:, otp:, request_options: {})
         #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param token [String]
+        # @param otp [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
+        #
+        # @see Lithic::Models::ThreeDS::AuthenticationSimulateOtpEntryParams
         def simulate_otp_entry(params)
           parsed, options = Lithic::Models::ThreeDS::AuthenticationSimulateOtpEntryParams.dump_request(params)
           @client.request(
@@ -78,6 +75,8 @@ module Lithic
           )
         end
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client

data/lib/lithic/resources/three_ds/decisioning.rb

@@ -6,18 +6,15 @@ module Lithic
       class Decisioning
         # Card program's response to a 3DS Challenge Request (CReq)
         #
-        # @param params [Lithic::Models::ThreeDS::DecisioningChallengeResponseParams, Hash{Symbol=>Object}] .
+        # @overload challenge_response(token:, challenge_response:, request_options: {})
         #
-        #   @option params [String] :token Globally unique identifier for the 3DS authentication. This token is sent as
-        #     part of the initial 3DS Decisioning Request and as part of the 3DS Challenge
-        #     Event in the [ThreeDSAuthentication](#/components/schemas/ThreeDSAuthentication)
-        #     object
-        #
-        #   @option params [Symbol, Lithic::Models::ThreeDS::ChallengeResult] :challenge_response Whether the Cardholder has Approved or Declined the issued Challenge
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param token [String]
+        # @param challenge_response [Symbol, Lithic::Models::ThreeDS::ChallengeResult]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
+        #
+        # @see Lithic::Models::ThreeDS::DecisioningChallengeResponseParams
         def challenge_response(params)
           parsed, options = Lithic::Models::ThreeDS::DecisioningChallengeResponseParams.dump_request(params)
           @client.request(
@@ -36,11 +33,13 @@ module Lithic
         #   [this page](https://docs.lithic.com/docs/3ds-decisioning#3ds-decisioning-hmac-secrets)
         #   for more detail about verifying 3DS Decisioning requests.
         #
-        # @param params [Lithic::Models::ThreeDS::DecisioningRetrieveSecretParams, 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::ThreeDS::DecisioningRetrieveSecretResponse]
+        #
+        # @see Lithic::Models::ThreeDS::DecisioningRetrieveSecretParams
         def retrieve_secret(params = {})
           @client.request(
             method: :get,
@@ -55,11 +54,13 @@ module Lithic
         #   [`GET /three_ds_decisioning/secret`](https://docs.lithic.com/reference/getthreedsdecisioningsecret)
         #   request to retrieve the new secret key.
         #
-        # @param params [Lithic::Models::ThreeDS::DecisioningRotateSecretParams, 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 [nil]
+        #
+        # @see Lithic::Models::ThreeDS::DecisioningRotateSecretParams
         def rotate_secret(params = {})
           @client.request(
             method: :post,
@@ -69,6 +70,8 @@ module Lithic
           )
         end
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client

data/lib/lithic/resources/three_ds.rb

@@ -9,6 +9,8 @@ module Lithic
       # @return [Lithic::Resources::ThreeDS::Decisioning]
       attr_reader :decisioning
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client