cybersource_rest_client 0.0.87 → 0.0.88

data/lib/cybersource_rest_client/api/ucp_checkout_api.rb

@@ -0,0 +1,453 @@
+=begin
+#CyberSource Merged Spec
+
+#All CyberSource API specs merged together. These are available at https://developer.cybersource.com/api/reference/api-reference.html
+
+OpenAPI spec version: 0.0.1
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.38
+=end
+
+require 'uri'
+require 'AuthenticationSDK/util/MLEUtility'
+module CyberSource
+  class UCPCheckoutApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default, config)
+      @api_client = api_client
+      @api_client.set_configuration(config)
+    end
+    # Cancel Checkout UCP
+    # Cancels an active UCP checkout session. No charge is made.  This operation is idempotent — cancelling an already-cancelled session returns a successful response. Sessions also expire automatically after 30 minutes of inactivity. 
+    #
+    # @param session_id The unique identifier of the UCP checkout session to cancel.
+    # @param [Hash] opts the optional parameters
+    # @return [InlineResponse20113]
+    #
+    def ucp_cancel_checkout(session_id, opts = {})
+      data, status_code, headers = ucp_cancel_checkout_with_http_info(session_id, opts)
+      return data, status_code, headers
+    end
+
+    # Cancel Checkout UCP
+    # Cancels an active UCP checkout session. No charge is made.  This operation is idempotent — cancelling an already-cancelled session returns a successful response. Sessions also expire automatically after 30 minutes of inactivity. 
+    # @param session_id The unique identifier of the UCP checkout session to cancel.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(InlineResponse20113, Fixnum, Hash)>] InlineResponse20113 data, response status code and response headers
+    def ucp_cancel_checkout_with_http_info(session_id, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: UCPCheckoutApi.ucp_cancel_checkout ...'
+            rescue
+                puts 'Cannot write to log'
+            end
+      end
+      # verify the required parameter 'session_id' is set
+      if @api_client.config.client_side_validation && session_id.nil?
+        fail ArgumentError, "Missing the required parameter 'session_id' when calling UCPCheckoutApi.ucp_cancel_checkout"
+      end
+      # resource path
+      local_var_path = 'icc/v1/checkout-sessions/{session_id}/cancel'.sub('{' + 'session_id' + '}', session_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/hal+json;charset=utf-8'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      if 'POST' == 'POST'
+        post_body = '{}'
+      else
+        post_body = nil
+      end
+      inbound_mle_status = "mandatory"
+      if MLEUtility.check_is_mle_for_API(@api_client.merchantconfig, inbound_mle_status, ["ucp_cancel_checkout","ucp_cancel_checkout_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["ucp_cancel_checkout","ucp_cancel_checkout_with_http_info"])
+
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'InlineResponse20113',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: UCPCheckoutApi#ucp_cancel_checkout\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        rescue
+            puts 'Cannot write to log'
+        end
+      end
+      return data, status_code, headers
+    end
+    # Complete Checkout UCP
+    # **Final step of the UCP checkout flow.**  Finalizes the session and places the order with the merchant. ACG translates the UCP completion request to the merchant's checkout API.  On success, the session transitions to `completed`. An `order_id` is not returned in the UCP response — use the ACP Complete endpoint if you need order confirmation details.  **Always use an `idempotency-key`** to prevent duplicate orders on network retries. 
+    #
+    # @param session_id The unique identifier of the UCP checkout session to complete.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key **Strongly recommended.** A unique key that ensures this order is placed exactly once on retries. Lowercase per UCP spec. 
+    # @option opts [UcpCompleteCheckoutRequest] :ucp_complete_checkout_request UCP completion payload containing payment instrument and optional risk signals. If payment context was already provided in the Create or Update call, the body can be omitted. Risk signals are logged for fraud analysis and are not forwarded to the merchant. 
+    # @return [InlineResponse20113]
+    #
+    def ucp_complete_checkout(session_id, opts = {})
+      data, status_code, headers = ucp_complete_checkout_with_http_info(session_id, opts)
+      return data, status_code, headers
+    end
+
+    # Complete Checkout UCP
+    # **Final step of the UCP checkout flow.**  Finalizes the session and places the order with the merchant. ACG translates the UCP completion request to the merchant&#39;s checkout API.  On success, the session transitions to &#x60;completed&#x60;. An &#x60;order_id&#x60; is not returned in the UCP response — use the ACP Complete endpoint if you need order confirmation details.  **Always use an &#x60;idempotency-key&#x60;** to prevent duplicate orders on network retries. 
+    # @param session_id The unique identifier of the UCP checkout session to complete.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key **Strongly recommended.** A unique key that ensures this order is placed exactly once on retries. Lowercase per UCP spec. 
+    # @option opts [UcpCompleteCheckoutRequest] :ucp_complete_checkout_request UCP completion payload containing payment instrument and optional risk signals. If payment context was already provided in the Create or Update call, the body can be omitted. Risk signals are logged for fraud analysis and are not forwarded to the merchant. 
+    # @return [Array<(InlineResponse20113, Fixnum, Hash)>] InlineResponse20113 data, response status code and response headers
+    def ucp_complete_checkout_with_http_info(session_id, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: UCPCheckoutApi.ucp_complete_checkout ...'
+            rescue
+                puts 'Cannot write to log'
+            end
+      end
+      # verify the required parameter 'session_id' is set
+      if @api_client.config.client_side_validation && session_id.nil?
+        fail ArgumentError, "Missing the required parameter 'session_id' when calling UCPCheckoutApi.ucp_complete_checkout"
+      end
+      # resource path
+      local_var_path = 'icc/v1/checkout-sessions/{session_id}/complete'.sub('{' + 'session_id' + '}', session_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/hal+json;charset=utf-8'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params[:'idempotency-key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(opts[:'ucp_complete_checkout_request'])
+      sdk_tracker = SdkTracker.new
+      post_body = sdk_tracker.insert_developer_id_tracker(post_body, 'UcpCompleteCheckoutRequest', @api_client.config.host, @api_client.merchantconfig.defaultDeveloperId)
+      inbound_mle_status = "mandatory"
+      if MLEUtility.check_is_mle_for_API(@api_client.merchantconfig, inbound_mle_status, ["ucp_complete_checkout","ucp_complete_checkout_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["ucp_complete_checkout","ucp_complete_checkout_with_http_info"])
+
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'InlineResponse20113',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: UCPCheckoutApi#ucp_complete_checkout\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        rescue
+            puts 'Cannot write to log'
+        end
+      end
+      return data, status_code, headers
+    end
+    # Create Checkout Session UCP
+    # **Step 1 of the UCP checkout flow.**  Creates a new UCP checkout session using Google's Universal Commerce Protocol format. ACG translates the UCP request into the internal ACP format, applies merchant pricing, and returns a UCP-format session response with a session `id`.  UCP uses `line_items` (instead of `items`) and lowercase header names (`idempotency-key`) per the UCP specification.  **Store the `id`** from the response — it is required for all subsequent UCP calls. 
+    #
+    # @param ucp_create_checkout_session_request UCP checkout session creation payload containing line items, buyer details, currency, and optional payment, fulfillment, and discount information. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key (UUID recommended) to ensure this request is processed exactly once. Lowercase per UCP specification. 
+    # @return [InlineResponse20113]
+    #
+    def ucp_create_checkout_session(ucp_create_checkout_session_request, opts = {})
+      data, status_code, headers = ucp_create_checkout_session_with_http_info(ucp_create_checkout_session_request, opts)
+      return data, status_code, headers
+    end
+
+    # Create Checkout Session UCP
+    # **Step 1 of the UCP checkout flow.**  Creates a new UCP checkout session using Google&#39;s Universal Commerce Protocol format. ACG translates the UCP request into the internal ACP format, applies merchant pricing, and returns a UCP-format session response with a session &#x60;id&#x60;.  UCP uses &#x60;line_items&#x60; (instead of &#x60;items&#x60;) and lowercase header names (&#x60;idempotency-key&#x60;) per the UCP specification.  **Store the &#x60;id&#x60;** from the response — it is required for all subsequent UCP calls. 
+    # @param ucp_create_checkout_session_request UCP checkout session creation payload containing line items, buyer details, currency, and optional payment, fulfillment, and discount information. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key (UUID recommended) to ensure this request is processed exactly once. Lowercase per UCP specification. 
+    # @return [Array<(InlineResponse20113, Fixnum, Hash)>] InlineResponse20113 data, response status code and response headers
+    def ucp_create_checkout_session_with_http_info(ucp_create_checkout_session_request, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: UCPCheckoutApi.ucp_create_checkout_session ...'
+            rescue
+                puts 'Cannot write to log'
+            end
+      end
+      # verify the required parameter 'ucp_create_checkout_session_request' is set
+      if @api_client.config.client_side_validation && ucp_create_checkout_session_request.nil?
+        fail ArgumentError, "Missing the required parameter 'ucp_create_checkout_session_request' when calling UCPCheckoutApi.ucp_create_checkout_session"
+      end
+      # resource path
+      local_var_path = 'icc/v1/checkout-sessions'
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/hal+json;charset=utf-8'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params[:'idempotency-key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(ucp_create_checkout_session_request)
+      sdk_tracker = SdkTracker.new
+      post_body = sdk_tracker.insert_developer_id_tracker(post_body, 'UcpCreateCheckoutSessionRequest', @api_client.config.host, @api_client.merchantconfig.defaultDeveloperId)
+      inbound_mle_status = "mandatory"
+      if MLEUtility.check_is_mle_for_API(@api_client.merchantconfig, inbound_mle_status, ["ucp_create_checkout_session","ucp_create_checkout_session_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["ucp_create_checkout_session","ucp_create_checkout_session_with_http_info"])
+
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'InlineResponse20113',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: UCPCheckoutApi#ucp_create_checkout_session\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        rescue
+            puts 'Cannot write to log'
+        end
+      end
+      return data, status_code, headers
+    end
+    # Get Checkout Session UCP
+    # Retrieves the current state of a UCP checkout session.  Use this to verify session status, retrieve updated totals after a fulfillment change, or resume a session after an interruption. 
+    #
+    # @param session_id The unique identifier of the UCP checkout session to retrieve. Obtained from the &#x60;id&#x60; field in the Create Session response. 
+    # @param ucp_get_checkout_session_request Empty request body.
+    # @param [Hash] opts the optional parameters
+    # @return [InlineResponse20113]
+    #
+    def ucp_get_checkout_session(session_id, ucp_get_checkout_session_request, opts = {})
+      data, status_code, headers = ucp_get_checkout_session_with_http_info(session_id, ucp_get_checkout_session_request, opts)
+      return data, status_code, headers
+    end
+
+    # Get Checkout Session UCP
+    # Retrieves the current state of a UCP checkout session.  Use this to verify session status, retrieve updated totals after a fulfillment change, or resume a session after an interruption. 
+    # @param session_id The unique identifier of the UCP checkout session to retrieve. Obtained from the &#x60;id&#x60; field in the Create Session response. 
+    # @param ucp_get_checkout_session_request Empty request body.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(InlineResponse20113, Fixnum, Hash)>] InlineResponse20113 data, response status code and response headers
+    def ucp_get_checkout_session_with_http_info(session_id, ucp_get_checkout_session_request, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: UCPCheckoutApi.ucp_get_checkout_session ...'
+            rescue
+                puts 'Cannot write to log'
+            end
+      end
+      # verify the required parameter 'session_id' is set
+      if @api_client.config.client_side_validation && session_id.nil?
+        fail ArgumentError, "Missing the required parameter 'session_id' when calling UCPCheckoutApi.ucp_get_checkout_session"
+      end
+      # verify the required parameter 'ucp_get_checkout_session_request' is set
+      if @api_client.config.client_side_validation && ucp_get_checkout_session_request.nil?
+        fail ArgumentError, "Missing the required parameter 'ucp_get_checkout_session_request' when calling UCPCheckoutApi.ucp_get_checkout_session"
+      end
+      # resource path
+      local_var_path = 'icc/v1/checkout-sessions/{session_id}'.sub('{' + 'session_id' + '}', session_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/hal+json;charset=utf-8'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(ucp_get_checkout_session_request)
+      sdk_tracker = SdkTracker.new
+      post_body = sdk_tracker.insert_developer_id_tracker(post_body, 'Object', @api_client.config.host, @api_client.merchantconfig.defaultDeveloperId)
+      inbound_mle_status = "false"
+      if MLEUtility.check_is_mle_for_API(@api_client.merchantconfig, inbound_mle_status, ["ucp_get_checkout_session","ucp_get_checkout_session_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["ucp_get_checkout_session","ucp_get_checkout_session_with_http_info"])
+
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'InlineResponse20113',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: UCPCheckoutApi#ucp_get_checkout_session\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        rescue
+            puts 'Cannot write to log'
+        end
+      end
+      return data, status_code, headers
+    end
+    # Update Checkout Session UCP
+    # Modifies an active UCP checkout session and returns the updated session state.  Use this to change line item quantities, update fulfillment address or method, or apply discount codes. Totals are recalculated and returned in the response.  Only the fields you include in the request body are updated. 
+    #
+    # @param session_id The unique identifier of the UCP checkout session to update.
+    # @param ucp_update_checkout_session_request UCP session update payload. All fields are optional — only fields you include will be applied. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key for idempotency. Lowercase per UCP spec.
+    # @return [InlineResponse20113]
+    #
+    def ucp_update_checkout_session(session_id, ucp_update_checkout_session_request, opts = {})
+      data, status_code, headers = ucp_update_checkout_session_with_http_info(session_id, ucp_update_checkout_session_request, opts)
+      return data, status_code, headers
+    end
+
+    # Update Checkout Session UCP
+    # Modifies an active UCP checkout session and returns the updated session state.  Use this to change line item quantities, update fulfillment address or method, or apply discount codes. Totals are recalculated and returned in the response.  Only the fields you include in the request body are updated. 
+    # @param session_id The unique identifier of the UCP checkout session to update.
+    # @param ucp_update_checkout_session_request UCP session update payload. All fields are optional — only fields you include will be applied. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key for idempotency. Lowercase per UCP spec.
+    # @return [Array<(InlineResponse20113, Fixnum, Hash)>] InlineResponse20113 data, response status code and response headers
+    def ucp_update_checkout_session_with_http_info(session_id, ucp_update_checkout_session_request, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: UCPCheckoutApi.ucp_update_checkout_session ...'
+            rescue
+                puts 'Cannot write to log'
+            end
+      end
+      # verify the required parameter 'session_id' is set
+      if @api_client.config.client_side_validation && session_id.nil?
+        fail ArgumentError, "Missing the required parameter 'session_id' when calling UCPCheckoutApi.ucp_update_checkout_session"
+      end
+      # verify the required parameter 'ucp_update_checkout_session_request' is set
+      if @api_client.config.client_side_validation && ucp_update_checkout_session_request.nil?
+        fail ArgumentError, "Missing the required parameter 'ucp_update_checkout_session_request' when calling UCPCheckoutApi.ucp_update_checkout_session"
+      end
+      # resource path
+      local_var_path = 'icc/v1/checkout-sessions/{session_id}'.sub('{' + 'session_id' + '}', session_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/hal+json;charset=utf-8'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params[:'idempotency-key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(ucp_update_checkout_session_request)
+      sdk_tracker = SdkTracker.new
+      post_body = sdk_tracker.insert_developer_id_tracker(post_body, 'UcpUpdateCheckoutSessionRequest', @api_client.config.host, @api_client.merchantconfig.defaultDeveloperId)
+      inbound_mle_status = "mandatory"
+      if MLEUtility.check_is_mle_for_API(@api_client.merchantconfig, inbound_mle_status, ["ucp_update_checkout_session","ucp_update_checkout_session_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["ucp_update_checkout_session","ucp_update_checkout_session_with_http_info"])
+
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'InlineResponse20113',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: UCPCheckoutApi#ucp_update_checkout_session\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        rescue
+            puts 'Cannot write to log'
+        end
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/cybersource_rest_client/models/activate_merchant_key_response200.rb

@@ -32,7 +32,7 @@ module CyberSource
     # JWE key wrap algorithm  Possible values: - RSA-OAEP - RSA-OAEP-256 - RSA-OAEP-384 - RSA-OAEP-512
     attr_accessor :algorithm
 
-    # JWE content encryption algorithm  Possible values: - A256GCM - A128GCM - C20P - A256CBC-HS512 - A128CBC-HS256 - A256CCM - A128CCM
+    # JWE content encryption algorithm  Possible values: - A256GCM - A128GCM - C20P - A256CBC_HS512 - A128CBC_HS256 - A256CCM - A128CCM
     attr_accessor :encryption_type
 
     # Key expiration date in UTC

data/lib/cybersource_rest_client/models/add_agent_key_response201.rb

@@ -14,37 +14,37 @@ require 'date'
 module CyberSource
   # Response object for a single agent public key, including agent context.
   class AddAgentKeyResponse201
-    # Unique key identifier. Generated from VARS.
+    # Unique key identifier (UUID) generated by VARS on creation
     attr_accessor :id
 
-    # Agent identifier
+    # Unique identifier of the agent this key belongs to (64-char SHA-256 hash)
     attr_accessor :agent_id
 
-    # Agent name
+    # Display name of the agent this key belongs to
     attr_accessor :agent_name
 
-    # Agent classification  Possible values: - trusted - known
+    # Agent classification: 'trusted' (commercially onboarded via Visa) or 'known' (open-source/community agent, unverified)  Possible values: - trusted - known
     attr_accessor :agent_type
 
-    # Unique identifier for the key
+    # Name for this key, unique within the agent
     attr_accessor :key_name
 
-    # Base64-encoded public key
+    # Base64-encoded public key. Supported formats: PEM (PKCS#8, PKCS#1) and JWK
     attr_accessor :public_key
 
-    # Signing algorithm  Possible values: - RSA-SHA256 - RSA-SHA512 - ECDSA-SHA256 - ECDSA-SHA512 - EdDSA
+    # HTTP Signature signing algorithm (RFC 9421 §3.3). Must match the key type and curve.  Possible values: - rsa-pss-sha256 - rsa-pss-sha512 - ecdsa-p256-sha256 - ecdsa-p384-sha384 - ed25519
     attr_accessor :algorithm
 
-    # Key expiration date in UTC
+    # ISO 8601 UTC datetime when this key expires. Expired keys cannot be activated.
     attr_accessor :expiration_date
 
-    # Key lifecycle status  Possible values: - active - deactivated - expired
+    # Current lifecycle status of the key: 'active' (in use), 'deactivated' (manually disabled), or 'expired' (past expiration date)  Possible values: - active - deactivated - expired
     attr_accessor :status
 
-    # Creation timestamp
+    # ISO 8601 UTC timestamp when the key was created
     attr_accessor :created_at
 
-    # Last update timestamp
+    # ISO 8601 UTC timestamp when the key was last updated
     attr_accessor :updated_at
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/cybersource_rest_client/models/agent_registration_response201.rb

@@ -17,37 +17,37 @@ module CyberSource
     # Unique agent identifier (64-char SHA-256 hash of domain + email + tokenRequestorId)
     attr_accessor :id
 
-    # Agent name
+    # Display name for the agent
     attr_accessor :name
 
-    # Agent domain URL
+    # Fully-qualified HTTPS URL of the agent's home domain
     attr_accessor :domain
 
-    # Agent description
+    # Description of the agent's purpose or capabilities
     attr_accessor :description
 
-    # Contact email
+    # Contact email for the team or individual responsible for this agent
     attr_accessor :contact_email
 
-    # Unique token requestor identifier
+    # Token Requestor ID (TRID) assigned by Visa, shared with the parent trusted agent for OSAs
     attr_accessor :token_requestor_id
 
-    # Agent classification: 'trusted' (commercially onboarded) or 'known' (open-source/unverified)  Possible values: - trusted - known
+    # Agent classification: 'trusted' (commercially onboarded via Visa) or 'known' (open-source/community agent, unverified)  Possible values: - trusted - known
     attr_accessor :agent_type
 
-    # Additional agent metadata
+    # Free-form metadata object for agent context (e.g., AI framework, language, runtime). Max 10KB.
     attr_accessor :agent_metadata
 
-    # Whether the agent is active
+    # Whether the agent is currently active. Deactivated agents cannot add or activate keys.
     attr_accessor :is_active
 
-    # Creation timestamp
+    # ISO 8601 UTC timestamp when the agent was registered
     attr_accessor :created_at
 
-    # Last update timestamp
+    # ISO 8601 UTC timestamp when the agent was last updated
     attr_accessor :updated_at
 
-    # List of keys associated with the agent
+    # List of public keys associated with the agent (both active and deactivated)
     attr_accessor :keys
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -96,7 +96,7 @@ module CyberSource
         :'contact_email' => :'String',
         :'token_requestor_id' => :'String',
         :'agent_type' => :'String',
-        :'agent_metadata' => :'Hash<String, String>',
+        :'agent_metadata' => :'Object',
         :'is_active' => :'BOOLEAN',
         :'created_at' => :'DateTime',
         :'updated_at' => :'DateTime',
@@ -141,9 +141,7 @@ module CyberSource
       end
 
       if attributes.has_key?(:'agentMetadata')
-        if (value = attributes[:'agentMetadata']).is_a?(Hash)
-          self.agent_metadata = value
-        end
+        self.agent_metadata = attributes[:'agentMetadata']
       end
 
       if attributes.has_key?(:'isActive')

data/lib/cybersource_rest_client/models/agent_registration_response201_keys.rb

@@ -14,28 +14,28 @@ require 'date'
 module CyberSource
   # Key item for agent keys list response (excludes agentId/agentName/agentType since they are at parent level)
   class AgentRegistrationResponse201Keys
-    # Unique key identifier. Generated from VARS.
+    # Unique key identifier (UUID) generated by VARS on creation
     attr_accessor :id
 
-    # Unique identifier for the key
+    # Name for this key, unique within the agent
     attr_accessor :key_name
 
-    # Base64-encoded public key
+    # Base64-encoded public key. Supported formats: PEM (PKCS#8, PKCS#1) and JWK
     attr_accessor :public_key
 
-    # Signing algorithm  Possible values: - RSA-SHA256 - RSA-SHA512 - ECDSA-SHA256 - ECDSA-SHA512 - EdDSA
+    # HTTP Signature signing algorithm (RFC 9421 §3.3). Must match the key type and curve.  Possible values: - rsa-pss-sha256 - rsa-pss-sha512 - ecdsa-p256-sha256 - ecdsa-p384-sha384 - ed25519
     attr_accessor :algorithm
 
-    # Key expiration date in UTC
+    # ISO 8601 UTC datetime when this key expires. Expired keys cannot be activated.
     attr_accessor :expiration_date
 
-    # Key lifecycle status  Possible values: - active - deactivated - expired
+    # Current lifecycle status of the key: 'active' (in use), 'deactivated' (manually disabled), or 'expired' (past expiration date)  Possible values: - active - deactivated - expired
     attr_accessor :status
 
-    # Creation timestamp
+    # ISO 8601 UTC timestamp when the key was created
     attr_accessor :created_at
 
-    # Last update timestamp
+    # ISO 8601 UTC timestamp when the key was last updated
     attr_accessor :updated_at
 
     # Attribute mapping from ruby-style variable name to JSON key.