cybersource_rest_client 0.0.87 → 0.0.89

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 731beb93fa86e56af43050a567a8512e712695b8bb9006a5593c7c3841de6b32
-  data.tar.gz: a2697272183c38f8d180d17b294f98412c8c729785e81521bc11140496a54651
+  metadata.gz: fabcaebf22d2bdc9a00144ecd8af3d487c8774cff85df4fdf0c1a18d0ac824ef
+  data.tar.gz: dae5e5a7d7943cd9abeb93c3931ccd24bb3046fa4bde41cf305cdaac93ad7099
 SHA512:
-  metadata.gz: 271897597451a5b631c1be2f341c7965b2dbfa07a9b7bf18371265481f7e924e6d8dd6cfa39fcc390a96f23efce0d5260bcf92eab66b4f7033c499a4e818dcb3
-  data.tar.gz: dece6dfe825872d035cfab32b63b3439dcb81a834a61b775a8b0b5cf9df11fad58cec8dfc484da5b29a8c7a1219dfd1622f8990cb6dad19c601d017283119afe
+  metadata.gz: cab40e8b2682933bec915a1d97502eb94d3abd784a53bd13e4e00cf6318cea49667616a6136b91002b6bbeef84012b46eabc027e863543c0a8291154dd113db7
+  data.tar.gz: 8471493a16f73a7ffd347b81ad61d3f4da1fd6d1a581028635c48e591b924c92bcde33566097c64c7baa44a1356e33980d50f2e20b2a6f1e2294c704270d4810

data/lib/AuthenticationSDK/authentication/jwt/JwtToken.rb

@@ -107,6 +107,7 @@ public
       if isResponseMLEForApi
         mle_kid = MLEUtility.validate_and_auto_extract_response_mle_kid(merchantconfig_obj)
         jwt_payload['v-c-response-mle-kid'] = mle_kid
+        jwt_payload['v-c-response-mle-algo'] = 'RSA-OAEP-256'
       end
 
       return jwt_payload

data/lib/AuthenticationSDK/util/Cache.rb

@@ -93,7 +93,7 @@ public
           mleCertificate = certificateList[0]
         end
 
-        cacheValue = CacheValue.new(nil, mleCertificate, fileModifiedTime)
+        cacheValue = CacheValue.new(nil, Base64.strict_encode64(mleCertificate.to_der), fileModifiedTime)
 
         @@cache_obj.write(cacheKey, cacheValue)
         return

data/lib/AuthenticationSDK/util/MLEUtility.rb

@@ -54,9 +54,8 @@ public
       is_mle_for_api
     end
 
-    def self.encrypt_request_payload(merchantConfig, requestBody)
+    def self.encrypt_request_payload(merchantConfig, requestBody, contentType = nil)
       return nil if requestBody.nil?
-      return requestBody if requestBody == '{}'
 
       @log_obj ||= Log.new(merchantConfig.log_config, 'MLEUtility')
 
@@ -91,10 +90,10 @@ public
         headers = {
           'alg' => 'RSA-OAEP-256',
           'enc'  => 'A256GCM',
-          'typ' => 'JWT',
           'kid' => serial_number,
           'iat' => Time.now.to_i
         }
+        headers['cty'] = contentType if contentType && !contentType.to_s.strip.empty?
         jwe = JOSE::JWE.block_encrypt(jwk, requestBody, headers)
 
         compact_jwe = jwe.compact

data/lib/cybersource_rest_client/api/acp_checkout_api.rb

@@ -0,0 +1,563 @@
+=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 ACPCheckoutApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default, config)
+      @api_client = api_client
+      @api_client.set_configuration(config)
+    end
+    # Cancel Checkout ACP
+    # Cancels an active ACP checkout session. No charge is made to the buyer.  This call is safe to make multiple times — cancelling an already-cancelled session returns a successful response without error.  Sessions also expire automatically after 30 minutes of inactivity, so explicit cancellation is optional but recommended to release any reserved inventory immediately. 
+    #
+    # @param session_id The unique identifier of the ACP checkout session to cancel. Obtained from the `id` field in the Create Session response. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. `en-US`, `fr-FR`). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. `2024-01-01`). When omitted, the latest supported version is assumed. 
+    # @return [CancelCheckoutResponse]
+    #
+    def cancel_checkout(session_id, opts = {})
+      data, status_code, headers = cancel_checkout_with_http_info(session_id, opts)
+      return data, status_code, headers
+    end
+
+    # Cancel Checkout ACP
+    # Cancels an active ACP checkout session. No charge is made to the buyer.  This call is safe to make multiple times — cancelling an already-cancelled session returns a successful response without error.  Sessions also expire automatically after 30 minutes of inactivity, so explicit cancellation is optional but recommended to release any reserved inventory immediately. 
+    # @param session_id The unique identifier of the ACP checkout session to cancel. Obtained from the `id` field in the Create Session response. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. `en-US`, `fr-FR`). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. `2024-01-01`). When omitted, the latest supported version is assumed. 
+    # @return [Array<(CancelCheckoutResponse, Fixnum, Hash)>] CancelCheckoutResponse data, response status code and response headers
+    def cancel_checkout_with_http_info(session_id, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: ACPCheckoutApi.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 ACPCheckoutApi.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'])
+      local_header_content_type = nil
+      # HTTP header 'Content-Type'
+      local_header_content_type = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params['Content-Type'] = local_header_content_type if local_header_content_type
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+      header_params[:'User-Agent'] = opts[:'user_agent'] if !opts[:'user_agent'].nil?
+      header_params[:'Request-Id'] = opts[:'request_id'] if !opts[:'request_id'].nil?
+      header_params[:'Signature'] = opts[:'signature'] if !opts[:'signature'].nil?
+      header_params[:'Timestamp'] = opts[:'timestamp'] if !opts[:'timestamp'].nil?
+      header_params[:'API-Version'] = opts[:'api_version'] if !opts[:'api_version'].nil?
+
+      # 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, ["cancel_checkout","cancel_checkout_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body, local_header_content_type)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["cancel_checkout","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 => 'CancelCheckoutResponse',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: ACPCheckoutApi#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 ACP
+    # **Final step of the ACP checkout flow.**  Submits payment and buyer information to place the order with the merchant. On success, the session transitions to `completed` and an `order_id` is returned confirming the merchant accepted the order.  Once completed, the session is immutable — it cannot be updated or cancelled.  **Payment token:** The `payment.token` must be a valid token from the payment provider configured for the merchant (e.g. a tokenized card from Stripe or Braintree). ACG forwards the token to the merchant's payment processor — it is never stored. 
+    #
+    # @param session_id The unique identifier of the ACP checkout session to complete.
+    # @param acp_complete_checkout_request Final buyer and payment details needed to place the order. Both &#x60;buyer&#x60; and &#x60;payment&#x60; may have been provided in earlier Create/Update calls; if so, they can be omitted here. At least a valid payment token is required to process the transaction. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [CompleteCheckoutResponse]
+    #
+    def complete_checkout(session_id, acp_complete_checkout_request, opts = {})
+      data, status_code, headers = complete_checkout_with_http_info(session_id, acp_complete_checkout_request, opts)
+      return data, status_code, headers
+    end
+
+    # Complete Checkout ACP
+    # **Final step of the ACP checkout flow.**  Submits payment and buyer information to place the order with the merchant. On success, the session transitions to &#x60;completed&#x60; and an &#x60;order_id&#x60; is returned confirming the merchant accepted the order.  Once completed, the session is immutable — it cannot be updated or cancelled.  **Payment token:** The &#x60;payment.token&#x60; must be a valid token from the payment provider configured for the merchant (e.g. a tokenized card from Stripe or Braintree). ACG forwards the token to the merchant&#39;s payment processor — it is never stored. 
+    # @param session_id The unique identifier of the ACP checkout session to complete.
+    # @param acp_complete_checkout_request Final buyer and payment details needed to place the order. Both &#x60;buyer&#x60; and &#x60;payment&#x60; may have been provided in earlier Create/Update calls; if so, they can be omitted here. At least a valid payment token is required to process the transaction. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [Array<(CompleteCheckoutResponse, Fixnum, Hash)>] CompleteCheckoutResponse data, response status code and response headers
+    def complete_checkout_with_http_info(session_id, acp_complete_checkout_request, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: ACPCheckoutApi.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 ACPCheckoutApi.complete_checkout"
+      end
+      # verify the required parameter 'acp_complete_checkout_request' is set
+      if @api_client.config.client_side_validation && acp_complete_checkout_request.nil?
+        fail ArgumentError, "Missing the required parameter 'acp_complete_checkout_request' when calling ACPCheckoutApi.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'])
+      local_header_content_type = nil
+      # HTTP header 'Content-Type'
+      local_header_content_type = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params['Content-Type'] = local_header_content_type if local_header_content_type
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+      header_params[:'User-Agent'] = opts[:'user_agent'] if !opts[:'user_agent'].nil?
+      header_params[:'Request-Id'] = opts[:'request_id'] if !opts[:'request_id'].nil?
+      header_params[:'Signature'] = opts[:'signature'] if !opts[:'signature'].nil?
+      header_params[:'Timestamp'] = opts[:'timestamp'] if !opts[:'timestamp'].nil?
+      header_params[:'API-Version'] = opts[:'api_version'] if !opts[:'api_version'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(acp_complete_checkout_request)
+      sdk_tracker = SdkTracker.new
+      post_body = sdk_tracker.insert_developer_id_tracker(post_body, 'AcpCompleteCheckoutRequest', @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, ["complete_checkout","complete_checkout_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body, local_header_content_type)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["complete_checkout","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 => 'CompleteCheckoutResponse',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: ACPCheckoutApi#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 ACP
+    # **Step 1 of the ACP checkout flow.**  Initiates a new ACP checkout session with the buyer's cart. ACG validates item availability against the merchant's catalog, calculates initial pricing and tax, and returns a session object with a unique `id`.  **Store the `id`** — every subsequent call in this checkout flow (update, complete, cancel) requires it.  The session remains active for 30 minutes. A new session must be created after expiry.  **Idempotency:** Supply an `Idempotency-Key` header to safely retry this call without creating duplicate sessions. 
+    #
+    # @param acp_create_checkout_session_request The cart contents and buyer context for this checkout session. &#x60;items&#x60; is required. &#x60;buyer&#x60; and &#x60;fulfillment_address&#x60; are optional on creation and can be provided via Update Session before completing checkout. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [CheckoutSessionResponse]
+    #
+    def create_checkout_session(acp_create_checkout_session_request, opts = {})
+      data, status_code, headers = create_checkout_session_with_http_info(acp_create_checkout_session_request, opts)
+      return data, status_code, headers
+    end
+
+    # Create Checkout Session ACP
+    # **Step 1 of the ACP checkout flow.**  Initiates a new ACP checkout session with the buyer&#39;s cart. ACG validates item availability against the merchant&#39;s catalog, calculates initial pricing and tax, and returns a session object with a unique &#x60;id&#x60;.  **Store the &#x60;id&#x60;** — every subsequent call in this checkout flow (update, complete, cancel) requires it.  The session remains active for 30 minutes. A new session must be created after expiry.  **Idempotency:** Supply an &#x60;Idempotency-Key&#x60; header to safely retry this call without creating duplicate sessions. 
+    # @param acp_create_checkout_session_request The cart contents and buyer context for this checkout session. &#x60;items&#x60; is required. &#x60;buyer&#x60; and &#x60;fulfillment_address&#x60; are optional on creation and can be provided via Update Session before completing checkout. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [Array<(CheckoutSessionResponse, Fixnum, Hash)>] CheckoutSessionResponse data, response status code and response headers
+    def create_checkout_session_with_http_info(acp_create_checkout_session_request, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: ACPCheckoutApi.create_checkout_session ...'
+            rescue
+                puts 'Cannot write to log'
+            end
+      end
+      # verify the required parameter 'acp_create_checkout_session_request' is set
+      if @api_client.config.client_side_validation && acp_create_checkout_session_request.nil?
+        fail ArgumentError, "Missing the required parameter 'acp_create_checkout_session_request' when calling ACPCheckoutApi.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'])
+      local_header_content_type = nil
+      # HTTP header 'Content-Type'
+      local_header_content_type = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params['Content-Type'] = local_header_content_type if local_header_content_type
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+      header_params[:'User-Agent'] = opts[:'user_agent'] if !opts[:'user_agent'].nil?
+      header_params[:'Request-Id'] = opts[:'request_id'] if !opts[:'request_id'].nil?
+      header_params[:'Signature'] = opts[:'signature'] if !opts[:'signature'].nil?
+      header_params[:'Timestamp'] = opts[:'timestamp'] if !opts[:'timestamp'].nil?
+      header_params[:'API-Version'] = opts[:'api_version'] if !opts[:'api_version'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(acp_create_checkout_session_request)
+      sdk_tracker = SdkTracker.new
+      post_body = sdk_tracker.insert_developer_id_tracker(post_body, 'AcpCreateCheckoutSessionRequest', @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, ["create_checkout_session","create_checkout_session_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body, local_header_content_type)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["create_checkout_session","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 => 'CheckoutSessionResponse',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: ACPCheckoutApi#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 ACP
+    # Retrieves the current state of an ACP checkout session, including line items, buyer information,  and current totals.  Use this to: - Verify session status before presenting a checkout summary to the buyer - Resume an interrupted checkout flow - Poll for status after an async operation - Confirm a session has not expired before submitting payment 
+    #
+    # @param session_id The unique identifier of the ACP checkout session to retrieve. Obtained from the &#x60;id&#x60; field in the Create Session response. 
+    # @param acp_get_checkout_session_request Empty request body.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [CheckoutSessionResponse]
+    #
+    def get_checkout_session(session_id, acp_get_checkout_session_request, opts = {})
+      data, status_code, headers = get_checkout_session_with_http_info(session_id, acp_get_checkout_session_request, opts)
+      return data, status_code, headers
+    end
+
+    # Get Checkout Session ACP
+    # Retrieves the current state of an ACP checkout session, including line items, buyer information,  and current totals.  Use this to: - Verify session status before presenting a checkout summary to the buyer - Resume an interrupted checkout flow - Poll for status after an async operation - Confirm a session has not expired before submitting payment 
+    # @param session_id The unique identifier of the ACP checkout session to retrieve. Obtained from the &#x60;id&#x60; field in the Create Session response. 
+    # @param acp_get_checkout_session_request Empty request body.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [Array<(CheckoutSessionResponse, Fixnum, Hash)>] CheckoutSessionResponse data, response status code and response headers
+    def get_checkout_session_with_http_info(session_id, acp_get_checkout_session_request, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: ACPCheckoutApi.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 ACPCheckoutApi.get_checkout_session"
+      end
+      # verify the required parameter 'acp_get_checkout_session_request' is set
+      if @api_client.config.client_side_validation && acp_get_checkout_session_request.nil?
+        fail ArgumentError, "Missing the required parameter 'acp_get_checkout_session_request' when calling ACPCheckoutApi.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'])
+      local_header_content_type = nil
+      # HTTP header 'Content-Type'
+      local_header_content_type = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params['Content-Type'] = local_header_content_type if local_header_content_type
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+      header_params[:'User-Agent'] = opts[:'user_agent'] if !opts[:'user_agent'].nil?
+      header_params[:'Request-Id'] = opts[:'request_id'] if !opts[:'request_id'].nil?
+      header_params[:'Signature'] = opts[:'signature'] if !opts[:'signature'].nil?
+      header_params[:'Timestamp'] = opts[:'timestamp'] if !opts[:'timestamp'].nil?
+      header_params[:'API-Version'] = opts[:'api_version'] if !opts[:'api_version'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(acp_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, ["get_checkout_session","get_checkout_session_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body, local_header_content_type)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["get_checkout_session","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 => 'CheckoutSessionResponse',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: ACPCheckoutApi#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 ACP
+    # Modifies an active ACP checkout session and returns the updated session state with recalculated totals.  Use this to: - Add, remove, or change quantities of cart items - Apply or remove discount codes - Update the buyer's shipping address or contact details - Trigger re-calculation of shipping costs and tax  Only fields included in the request body are updated — omitted fields retain their current values.  **Idempotency:** Supply an `Idempotency-Key` to safely retry updates without applying them twice. 
+    #
+    # @param session_id The unique identifier of the ACP checkout session to update. Obtained from the &#x60;id&#x60; field in the Create Session response. 
+    # @param acp_update_checkout_session_request Fields to update. All fields are optional — only included fields are changed. To replace the cart entirely, provide the full &#x60;items&#x60; array. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [CheckoutSessionResponse]
+    #
+    def update_checkout_session(session_id, acp_update_checkout_session_request, opts = {})
+      data, status_code, headers = update_checkout_session_with_http_info(session_id, acp_update_checkout_session_request, opts)
+      return data, status_code, headers
+    end
+
+    # Update Checkout Session ACP
+    # Modifies an active ACP checkout session and returns the updated session state with recalculated totals.  Use this to: - Add, remove, or change quantities of cart items - Apply or remove discount codes - Update the buyer&#39;s shipping address or contact details - Trigger re-calculation of shipping costs and tax  Only fields included in the request body are updated — omitted fields retain their current values.  **Idempotency:** Supply an &#x60;Idempotency-Key&#x60; to safely retry updates without applying them twice. 
+    # @param session_id The unique identifier of the ACP checkout session to update. Obtained from the &#x60;id&#x60; field in the Create Session response. 
+    # @param acp_update_checkout_session_request Fields to update. All fields are optional — only included fields are changed. To replace the cart entirely, provide the full &#x60;items&#x60; array. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Client-generated unique key to ensure this request is processed exactly once. If a request with the same key was already processed, the original response is returned. 
+    # @option opts [String] :accept_language Preferred language for the response (e.g. &#x60;en-US&#x60;, &#x60;fr-FR&#x60;). Passed to the merchant backend for localized content. 
+    # @option opts [String] :user_agent Client user agent string identifying the AI agent platform and version. 
+    # @option opts [String] :request_id Unique request identifier for distributed tracing and debugging. Echoed back in the response headers. 
+    # @option opts [String] :signature Request signature for payload integrity verification. 
+    # @option opts [String] :timestamp ISO 8601 timestamp of when the request was generated. Used in conjunction with Signature for replay protection. 
+    # @option opts [String] :api_version ACP specification version the client is targeting (e.g. &#x60;2024-01-01&#x60;). When omitted, the latest supported version is assumed. 
+    # @return [Array<(CheckoutSessionResponse, Fixnum, Hash)>] CheckoutSessionResponse data, response status code and response headers
+    def update_checkout_session_with_http_info(session_id, acp_update_checkout_session_request, opts = {})
+
+      if @api_client.config.debugging
+          begin
+            raise
+                @api_client.config.logger.debug 'Calling API: ACPCheckoutApi.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 ACPCheckoutApi.update_checkout_session"
+      end
+      # verify the required parameter 'acp_update_checkout_session_request' is set
+      if @api_client.config.client_side_validation && acp_update_checkout_session_request.nil?
+        fail ArgumentError, "Missing the required parameter 'acp_update_checkout_session_request' when calling ACPCheckoutApi.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'])
+      local_header_content_type = nil
+      # HTTP header 'Content-Type'
+      local_header_content_type = @api_client.select_header_content_type(['application/json;charset=utf-8'])
+      header_params['Content-Type'] = local_header_content_type if local_header_content_type
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+      header_params[:'User-Agent'] = opts[:'user_agent'] if !opts[:'user_agent'].nil?
+      header_params[:'Request-Id'] = opts[:'request_id'] if !opts[:'request_id'].nil?
+      header_params[:'Signature'] = opts[:'signature'] if !opts[:'signature'].nil?
+      header_params[:'Timestamp'] = opts[:'timestamp'] if !opts[:'timestamp'].nil?
+      header_params[:'API-Version'] = opts[:'api_version'] if !opts[:'api_version'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(acp_update_checkout_session_request)
+      sdk_tracker = SdkTracker.new
+      post_body = sdk_tracker.insert_developer_id_tracker(post_body, 'AcpUpdateCheckoutSessionRequest', @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, ["update_checkout_session","update_checkout_session_with_http_info"])
+        begin
+          post_body = MLEUtility.encrypt_request_payload(@api_client.merchantconfig, post_body, local_header_content_type)
+        rescue
+          raise
+        end
+      end
+
+      is_response_mle_for_api = MLEUtility.check_is_response_mle_for_api(@api_client.merchantconfig, ["update_checkout_session","update_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 => 'CheckoutSessionResponse',
+        :isResponseMLEForApi => is_response_mle_for_api)
+      if @api_client.config.debugging
+        begin
+        raise
+            @api_client.config.logger.debug "API called: ACPCheckoutApi#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