cybersource_rest_client 0.0.87 → 0.0.88

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 731beb93fa86e56af43050a567a8512e712695b8bb9006a5593c7c3841de6b32
-  data.tar.gz: a2697272183c38f8d180d17b294f98412c8c729785e81521bc11140496a54651
+  metadata.gz: e1e5c2b604a9baf468ed5dd9dbc71a830b1124514911c6334e2e8d889bc98d33
+  data.tar.gz: 8002de77b368c36e76e91ae0307cfdaeb31af01c888a5dc5494f62690ae8e7fe
 SHA512:
-  metadata.gz: 271897597451a5b631c1be2f341c7965b2dbfa07a9b7bf18371265481f7e924e6d8dd6cfa39fcc390a96f23efce0d5260bcf92eab66b4f7033c499a4e818dcb3
-  data.tar.gz: dece6dfe825872d035cfab32b63b3439dcb81a834a61b775a8b0b5cf9df11fad58cec8dfc484da5b29a8c7a1219dfd1622f8990cb6dad19c601d017283119afe
+  metadata.gz: 59c65c5e4e13d30a66cd8a8e8da030a24b8200f084ad6dc2cfcfc1723fb586a4bff8726066ecb6e0d6e74887015eb1449ab9c84729db9efd93818881fcf29f58
+  data.tar.gz: 46ec71529aa59f09552e05634cb36bb273a8194fdf638051a501764e97392ae42c82443dd7ad1b411b1fb9c7f7d6ac8aadab1a394d2e82ec523a06f62eed0528

data/lib/cybersource_rest_client/api/acp_checkout_api.rb

@@ -0,0 +1,553 @@
+=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 [InlineResponse20018]
+    #
+    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<(InlineResponse20018, Fixnum, Hash)>] InlineResponse20018 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'])
+      # 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?
+      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)
+        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 => 'InlineResponse20018',
+        :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 [InlineResponse20017]
+    #
+    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<(InlineResponse20017, Fixnum, Hash)>] InlineResponse20017 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'])
+      # 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?
+      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)
+        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 => 'InlineResponse20017',
+        :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 [InlineResponse20112]
+    #
+    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<(InlineResponse20112, Fixnum, Hash)>] InlineResponse20112 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'])
+      # 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?
+      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)
+        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 => 'InlineResponse20112',
+        :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 [InlineResponse20112]
+    #
+    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<(InlineResponse20112, Fixnum, Hash)>] InlineResponse20112 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'])
+      # 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?
+      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)
+        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 => 'InlineResponse20112',
+        :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 [InlineResponse20112]
+    #
+    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<(InlineResponse20112, Fixnum, Hash)>] InlineResponse20112 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'])
+      # 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?
+      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)
+        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 => 'InlineResponse20112',
+        :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