paypal-server-sdk 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 384df7b8cdbd6c07409b2de2c58d791cf3c734063bb265c725533294641dab43
-  data.tar.gz: aa1e3012f01cf06e65da38895a2ce3dc11cf867a1971fe4f1f89401c87706ffd
+  metadata.gz: 716ca4b1a12121acd6e221becbf2d29c55063b4f8b46eb68b499a84d6c22a175
+  data.tar.gz: c875e40983c4bb398f4d40849540c2e3e8a612f94383ca70326bd7a5a24f7223
 SHA512:
-  metadata.gz: bd7a3566df23ff352223eb346a73a35b5ec5d097ab40bd023d472ae12554b17b3d3bef6a5b2dd308b8b1e89de20f886c1f8c3b7ee2f581eb12e0dd80e99f3afb
-  data.tar.gz: 2e4440a555149afce96d67f99b5adccc8f69b5653edb352d29105cc8b91a70345a537145cf8892879ad7c50127b256d299fa4617d3fef4e5d19b2c0dca32128e
+  metadata.gz: 96c1fd80ecdf37001dc6e351e81677e02740414aba53b4913a71c56a82a1bafcc5d5f55caf6af264a5e065fdbcfcb7ddd07875358c09b893087277016371a6a3
+  data.tar.gz: 0d5bb3db5f27cddfff1c1712fd14d0519108a9d5239605615f6ade8aa5c452cdf5b2cb59986e9e99066e44ea04042867c5c79491b4e21f10be0db6eddb228ebc

data/README.md

@@ -22,20 +22,55 @@ The PayPal Server SDK provides integration access to the PayPal REST APIs. The A
 Install the gem from the command line:
 
 ```bash
-gem install paypal-server-sdk -v 2.0.0
+gem install paypal-server-sdk -v 2.1.0
 ```
 
 Or add the gem to your Gemfile and run `bundle`:
 
 ```ruby
-gem 'paypal-server-sdk', '2.0.0'
+gem 'paypal-server-sdk', '2.1.0'
 ```
 
-For additional gem details, see the [RubyGems page for the paypal-server-sdk gem](https://rubygems.org/gems/paypal-server-sdk/versions/2.0.0).
+For additional gem details, see the [RubyGems page for the paypal-server-sdk gem](https://rubygems.org/gems/paypal-server-sdk/versions/2.1.0).
+
+## IRB Console Usage
+
+You can explore the SDK interactively using IRB in two ways
+
+### 1. Use IRB with Installed Gem
+
+Open your system terminal (Command Prompt, Git Bash or macOS Terminal) and type the following command to start the irb console.
+
+```bash
+irb
+```
+
+Now you can load the SDK in the IRB
+
+```ruby
+require 'paypal_server_sdk'
+include PaypalServerSdk
+```
+
+### 2. Use IRB within SDK
+
+Open your system terminal (Command Prompt, Git Bash or macOS Terminal) and navigate to the root folder of SDK.
+
+```
+cd path/to/paypal_server_sdk
+```
+
+Now you can start the preconfigured irb console by running the following command
+
+```bash
+ruby bin/console
+```
+
+**_Note:_** This automatically loads the SDK from lib/
 
 ## Initialize the API Client
 
-**_Note:_** Documentation for the client can be found [here.](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/client.md)
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/client.md)
 
 The following parameters are configurable for the API Client:
 
@@ -51,12 +86,14 @@ The following parameters are configurable for the API Client:
 | retry_statuses | `Array` | A list of HTTP statuses to retry. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
 | retry_methods | `Array` | A list of HTTP methods to retry. <br> **Default: %i[get put]** |
 | http_callback | `HttpCallBack` | The Http CallBack allows defining callables for pre and post API calls. |
-| proxy_settings | [`ProxySettings`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
-| logging_configuration | [`LoggingConfiguration`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/logging-configuration.md) | The SDK logging configuration for API calls |
-| client_credentials_auth_credentials | [`ClientCredentialsAuthCredentials`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/auth/oauth-2-client-credentials-grant.md) | The credential object for OAuth 2 Client Credentials Grant |
+| proxy_settings | [`ProxySettings`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
+| logging_configuration | [`LoggingConfiguration`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/logging-configuration.md) | The SDK logging configuration for API calls |
+| client_credentials_auth_credentials | [`ClientCredentialsAuthCredentials`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/auth/oauth-2-client-credentials-grant.md) | The credential object for OAuth 2 Client Credentials Grant |
 
 The API client can be initialized as follows:
 
+### Code-Based Client Initialization
+
 ```ruby
 require 'paypal_server_sdk'
 include PaypalServerSdk
@@ -79,6 +116,18 @@ client = Client.new(
 )
 ```
 
+### Environment-Based Client Initialization
+
+```ruby
+require 'paypal_server_sdk'
+include PaypalServerSdk
+
+# Create client from environment
+client = Client.from_env
+```
+
+See the [`Environment-Based Client Initialization`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/environment-based-client-initialization.md) section for details.
+
 ## Environments
 
 The SDK can be configured to use a different environment for making API calls. Available environments are:
@@ -94,34 +143,35 @@ The SDK can be configured to use a different environment for making API calls. A
 
 This API uses the following authentication schemes.
 
-* [`Oauth2 (OAuth 2 Client Credentials Grant)`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/auth/oauth-2-client-credentials-grant.md)
+* [`Oauth2 (OAuth 2 Client Credentials Grant)`](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/auth/oauth-2-client-credentials-grant.md)
 
 ## List of APIs
 
-* [Transactionsearch](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/controllers/transactionsearch.md)
-* [Orders](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/controllers/orders.md)
-* [Payments](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/controllers/payments.md)
-* [Vault](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/controllers/vault.md)
-* [Subscriptions](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/controllers/subscriptions.md)
+* [Orders](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/controllers/orders.md)
+* [Payments](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/controllers/payments.md)
+* [Vault](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/controllers/vault.md)
+* [Transaction Search](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/controllers/transaction-search.md)
+* [Subscriptions](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/controllers/subscriptions.md)
 
 ## SDK Infrastructure
 
 ### Configuration
 
-* [ProxySettings](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/proxy-settings.md)
-* [AbstractLogger](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/abstract-logger.md)
-* [LoggingConfiguration](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/logging-configuration.md)
-* [RequestLoggingConfiguration](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/request-logging-configuration.md)
-* [ResponseLoggingConfiguration](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/response-logging-configuration.md)
+* [ProxySettings](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/proxy-settings.md)
+* [Environment-Based Client Initialization](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/environment-based-client-initialization.md)
+* [AbstractLogger](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/abstract-logger.md)
+* [LoggingConfiguration](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/logging-configuration.md)
+* [RequestLoggingConfiguration](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/request-logging-configuration.md)
+* [ResponseLoggingConfiguration](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/response-logging-configuration.md)
 
 ### HTTP
 
-* [HttpResponse](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/http-response.md)
-* [HttpRequest](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/http-request.md)
+* [HttpResponse](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/http-response.md)
+* [HttpRequest](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/http-request.md)
 
 ### Utilities
 
-* [ApiResponse](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/api-response.md)
-* [ApiHelper](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/api-helper.md)
-* [DateTimeHelper](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.0.0/doc/date-time-helper.md)
+* [ApiResponse](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/api-response.md)
+* [ApiHelper](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/api-helper.md)
+* [DateTimeHelper](https://www.github.com/paypal/PayPal-Ruby-Server-SDK/tree/2.1.0/doc/date-time-helper.md)
 

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# Load the lib folder into Ruby's load path
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+
+# Require the gem
+require 'paypal_server_sdk'
+
+puts 'PaypalServerSdk SDK loaded!'
+puts 'You can now create a client with: client = PaypalServerSdk::Client.new'
+puts 'Or use from_env: client = PaypalServerSdk::Client.from_env'
+
+# Start an interactive IRB session
+require 'irb'
+IRB.start

data/lib/paypal_server_sdk/client.rb

@@ -8,6 +8,10 @@ module PaypalServerSdk
   class Client
     include CoreLibrary
     attr_reader :config, :auth_managers
+
+    def user_agent_detail
+      config.user_agent_detail
+    end
 
     # Returns the configured authentication Oauth2 instance.
     def oauth2
@@ -94,5 +98,12 @@ module PaypalServerSdk
       @auth_managers['Oauth2'] = OAuth2.new(http_client_config.client_credentials_auth_credentials,
                                             global_config)
     end
+
+    # Creates a client directly from environment variables.
+    def self.from_env(**overrides)
+      default_config = Configuration.build_default_config_from_env
+      new_config = default_config.clone_with(**overrides)
+      new(config: new_config)
+    end
   end
 end

data/lib/paypal_server_sdk/configuration.rb

@@ -12,6 +12,21 @@ module PaypalServerSdk
       PRODUCTION = 'Production'.freeze,
       SANDBOX = 'Sandbox'.freeze
     ].freeze
+
+    # Converts a string or symbol into a valid Environment constant.
+    def self.from_value(value, default_value = PRODUCTION)
+      return default_value if value.nil?
+
+      str = value.to_s.strip.downcase
+      case str
+      when 'production' then PRODUCTION
+      when 'sandbox' then SANDBOX
+
+      else
+        warn "[Environment] Unknown environment '#{value}', falling back to #{default_value} "
+        default_value
+      end
+    end
   end
 
   # An enum for API servers.
@@ -19,6 +34,13 @@ module PaypalServerSdk
     SERVER = [
       DEFAULT = 'default'.freeze
     ].freeze
+
+    # Converts a string or symbol into a valid Server constant.
+    def self.from_value(value, default_value = DEFAULT)
+      return default_value if value.nil?
+
+      default_value
+    end
   end
 
   # All configuration including auth info and base URI for the API access
@@ -107,5 +129,49 @@ module PaypalServerSdk
     def get_base_uri(server = Server::DEFAULT)
       ENVIRONMENTS[environment][server].clone
     end
+
+    # Builds a Configuration instance using environment variables.
+    def self.build_default_config_from_env
+      # === Core environment ===
+      environment = Environment.from_value(ENV.fetch('ENVIRONMENT', 'sandbox'))
+      timeout = (ENV['TIMEOUT'] || 60).to_f
+      max_retries = (ENV['MAX_RETRIES'] || 0).to_i
+      retry_interval = (ENV['RETRY_INTERVAL'] || 1).to_f
+      backoff_factor = (ENV['BACKOFF_FACTOR'] || 2).to_f
+      retry_statuses = ENV.fetch('RETRY_STATUSES',
+                                 '[408, 413, 429, 500, 502, 503, 504, 521, 522, 524]').gsub(/[\[\]]/, '')
+                                          .split(',')
+                                          .map(&:strip)
+                                          .map do |item|
+                                            item.match?(/\A\d+\z/) ? item.to_i : item.downcase
+                                          end
+      retry_methods = ENV.fetch('RETRY_METHODS', '%i[get put]').gsub(/[\[\]]/, '')
+                                          .split(',')
+                                          .map(&:strip)
+                                          .map do |item|
+                                            item.match?(/\A\d+\z/) ? item.to_i : item.downcase
+                                          end
+
+      # === Authentication credentials ===
+      client_credentials_auth_credentials = ClientCredentialsAuthCredentials.from_env
+
+      # === Proxy settings ===
+      proxy_settings = ProxySettings.from_env
+      # === Logging Configuration ===
+      logging_configuration = LoggingConfiguration.from_env if LoggingConfiguration.any_logging_configured?
+
+      Configuration.new(
+        environment: environment,
+        timeout: timeout,
+        max_retries: max_retries,
+        retry_interval: retry_interval,
+        backoff_factor: backoff_factor,
+        retry_statuses: retry_statuses,
+        retry_methods: retry_methods,
+        client_credentials_auth_credentials: client_credentials_auth_credentials,
+        proxy_settings: proxy_settings,
+        logging_configuration: logging_configuration
+      )
+    end
   end
 end

data/lib/paypal_server_sdk/controllers/base_controller.rb

@@ -10,7 +10,7 @@ module PaypalServerSdk
     attr_accessor :config, :http_call_back
 
     def self.user_agent
-      'PayPal REST API Ruby SDK, Version: 2.0.0, on OS {os-info}'
+      'PayPal REST API Ruby SDK, Version: 2.1.0, on OS {os-info}'
     end
 
     def self.user_agent_parameters

data/lib/paypal_server_sdk/http/auth/o_auth2.rb

@@ -114,6 +114,21 @@ module PaypalServerSdk
       @o_auth_clock_skew = o_auth_clock_skew
     end
 
+    def self.from_env
+      o_auth_client_id = ENV['O_AUTH_CLIENT_ID']
+      o_auth_client_secret = ENV['O_AUTH_CLIENT_SECRET']
+      o_auth_clock_skew = ENV['O_AUTH_CLOCK_SKEW']
+      all_nil = [
+        o_auth_client_id,
+        o_auth_client_secret
+      ].all?(&:nil?)
+      return nil if all_nil
+
+      new(o_auth_client_id: o_auth_client_id,
+          o_auth_client_secret: o_auth_client_secret,
+          o_auth_clock_skew: o_auth_clock_skew)
+    end
+
     def clone_with(o_auth_client_id: nil, o_auth_client_secret: nil,
                    o_auth_token: nil, o_auth_token_provider: nil,
                    o_auth_on_token_update: nil, o_auth_clock_skew: nil)

data/lib/paypal_server_sdk/http/proxy_settings.rb

@@ -9,5 +9,14 @@ module PaypalServerSdk
   # including optional basic authentication.
   #
   class ProxySettings < CoreLibrary::ProxySettings
+    def self.from_env
+      address = ENV['PROXY_ADDRESS']
+      port = ENV['PROXY_PORT']
+      username = ENV['PROXY_USERNAME']
+      password = ENV['PROXY_PASSWORD']
+      return nil if address.nil? || address.strip.empty?
+
+      new(address: address, port: port, username: username, password: password)
+    end
   end
 end

data/lib/paypal_server_sdk/logging/configuration/api_logging_configuration.rb

@@ -3,112 +3,184 @@
 # This file was automatically generated by APIMATIC v3.0
 # ( https://www.apimatic.io ).
 
-module PaypalServerSdk
-  # Initializes a new instance of RequestLoggingConfiguration.
-  class RequestLoggingConfiguration < CoreLibrary::ApiRequestLoggingConfiguration
-    # @param log_body [Boolean] Indicates whether the message body should be logged. Default is false.
-    # @param log_headers [Boolean] Indicates whether the message headers should be logged. Default is false.
-    # @param headers_to_exclude [Array<String>] Array of headers not displayed in logging. Default is an empty array.
-    # @param headers_to_include [Array<String>] Array of headers to be displayed in logging. Default is an empty array.
-    # @param headers_to_unmask [Array<String>] Array of headers which values are non-sensitive to display in logging.
-    #   Default is an empty array.
-    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
-                   headers_to_exclude: nil, headers_to_unmask: nil,
-                   include_query_in_path: false)
-      super(
-        log_body,
-        log_headers,
-        headers_to_exclude,
-        headers_to_include,
-        headers_to_unmask,
-        include_query_in_path
-      )
-    end
-
-    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
-                   headers_to_exclude: nil, headers_to_unmask: nil, include_query_in_path: nil)
-      log_body ||= self.log_body
-      log_headers ||= self.log_headers
-      headers_to_include ||= self.headers_to_include
-      headers_to_exclude ||= self.headers_to_exclude
-      headers_to_unmask ||= self.headers_to_unmask
-      include_query_in_path ||= self.include_query_in_path
-
-      RequestLoggingConfiguration.class.new(log_body: log_body, log_headers: log_headers,
-                                            headers_to_include: headers_to_include,
-                                            headers_to_exclude: headers_to_exclude,
-                                            headers_to_unmask: headers_to_unmask,
-                                            include_query_in_path: include_query_in_path)
-    end
-  end
-
-  # Initializes a new instance of ResponseLoggingConfiguration.
-  class ResponseLoggingConfiguration < CoreLibrary::ApiResponseLoggingConfiguration
-    # @param log_body [Boolean] Indicates whether the message body should be logged. Default is false.
-    # @param log_headers [Boolean] Indicates whether the message headers should be logged. Default is false.
-    # @param headers_to_exclude [Array<String>] Array of headers not displayed in logging. Default is an empty array.
-    # @param headers_to_include [Array<String>] Array of headers to be displayed in logging. Default is an empty array.
-    # @param headers_to_unmask [Array<String>] Array of headers which values are non-sensitive to display in logging.
-    #   Default is an empty array.
-    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
-                   headers_to_exclude: nil, headers_to_unmask: nil)
-      super(
-        log_body,
-        log_headers,
-        headers_to_exclude,
-        headers_to_include,
-        headers_to_unmask
-      )
-    end
-
-    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
-                   headers_to_exclude: nil, headers_to_unmask: nil)
-      log_body ||= self.log_body
-      log_headers ||= self.log_headers
-      headers_to_include ||= self.headers_to_include
-      headers_to_exclude ||= self.headers_to_exclude
-      headers_to_unmask ||= self.headers_to_unmask
-
-      ResponseLoggingConfiguration.new(log_body: log_body, log_headers: log_headers,
-                                       headers_to_include: headers_to_include,
-                                       headers_to_exclude: headers_to_exclude,
-                                       headers_to_unmask: headers_to_unmask)
-    end
-  end
-
-  # Initializes a new instance of LoggingConfiguration.
-  class LoggingConfiguration < CoreLibrary::ApiLoggingConfiguration
-    # @param logger [LoggerInterface] The logger to use for logging messages.
-    # @param log_level [LogLevel] The log level to determine which messages should be logged.
-    # @param request_logging_config [RequestLoggingConfiguration] Options for logging HTTP requests.
-    # @param response_logging_config [ResponseLoggingConfiguration] Options for logging HTTP responses.
-    # @param mask_sensitive_headers [Boolean] Indicates whether sensitive headers should be masked in logged messages.
-    def initialize(logger: nil, log_level: nil, mask_sensitive_headers: true,
-                   request_logging_config: nil,
-                   response_logging_config: nil)
-      request_logging_config ||= RequestLoggingConfiguration.new
-      response_logging_config ||= ResponseLoggingConfiguration.new
-      super(
-        logger,
-        log_level,
-        request_logging_config,
-        response_logging_config,
-        mask_sensitive_headers
-      )
-    end
-
-    def clone_with(logger: nil, log_level: nil, mask_sensitive_headers: nil,
-                   request_logging_config: nil, response_logging_config: nil)
-      logger ||= self.logger
-      log_level ||= self.log_level
-      mask_sensitive_headers = self.mask_sensitive_headers ||= mask_sensitive_headers
-      request_logging_config ||= self.request_logging_config.clone
-      response_logging_config ||= self.response_logging_config.clone
-
-      LoggingConfiguration.new(logger: logger, log_level: log_level,
-                               mask_sensitive_headers: mask_sensitive_headers,
-                               request_logging_config: request_logging_config,
-                               response_logging_config: response_logging_config)
-    end
-  end
-end
+module PaypalServerSdk
+  # Initializes a new instance of RequestLoggingConfiguration.
+  class RequestLoggingConfiguration < CoreLibrary::ApiRequestLoggingConfiguration
+    # @param log_body [Boolean] Indicates whether the message body should be logged. Default is false.
+    # @param log_headers [Boolean] Indicates whether the message headers should be logged. Default is false.
+    # @param headers_to_exclude [Array<String>] Array of headers not displayed in logging. Default is an empty array.
+    # @param headers_to_include [Array<String>] Array of headers to be displayed in logging. Default is an empty array.
+    # @param headers_to_unmask [Array<String>] Array of headers which values are non-sensitive to display in logging.
+    #   Default is an empty array.
+    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil,
+                   include_query_in_path: false)
+      super(
+        log_body,
+        log_headers,
+        headers_to_exclude,
+        headers_to_include,
+        headers_to_unmask,
+        include_query_in_path
+      )
+    end
+
+    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil, include_query_in_path: nil)
+      log_body ||= self.log_body
+      log_headers ||= self.log_headers
+      headers_to_include ||= self.headers_to_include
+      headers_to_exclude ||= self.headers_to_exclude
+      headers_to_unmask ||= self.headers_to_unmask
+      include_query_in_path ||= self.include_query_in_path
+
+      RequestLoggingConfiguration.new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask,
+        include_query_in_path: include_query_in_path
+      )
+    end
+
+    def self.from_env
+      log_body = ENV['REQUEST_LOG_BODY']
+      log_headers = ENV['REQUEST_LOG_HEADERS']
+      headers_to_include = ENV['REQUEST_HEADERS_TO_INCLUDE']
+      headers_to_exclude = ENV['REQUEST_HEADERS_TO_EXCLUDE']
+      headers_to_unmask = ENV['REQUEST_HEADERS_TO_UNMASK']
+      include_query_in_path = ENV['REQUEST_INCLUDE_QUERY_IN_PATH']
+
+      new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask,
+        include_query_in_path: include_query_in_path
+      )
+    end
+
+    def self.any_logging_configured?
+      %w[
+        REQUEST_LOG_BODY
+        REQUEST_LOG_HEADERS
+        REQUEST_HEADERS_TO_INCLUDE
+        REQUEST_HEADERS_TO_EXCLUDE
+        REQUEST_HEADERS_TO_UNMASK
+        REQUEST_INCLUDE_QUERY_IN_PATH
+      ].any? { |key| ENV.key?(key) && !ENV[key].nil? && !ENV[key].empty? }
+    end
+  end
+
+  # Initializes a new instance of ResponseLoggingConfiguration.
+  class ResponseLoggingConfiguration < CoreLibrary::ApiResponseLoggingConfiguration
+    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil)
+      super(
+        log_body,
+        log_headers,
+        headers_to_exclude,
+        headers_to_include,
+        headers_to_unmask
+      )
+    end
+
+    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil)
+      log_body ||= self.log_body
+      log_headers ||= self.log_headers
+      headers_to_include ||= self.headers_to_include
+      headers_to_exclude ||= self.headers_to_exclude
+      headers_to_unmask ||= self.headers_to_unmask
+
+      ResponseLoggingConfiguration.new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask
+      )
+    end
+
+    def self.from_env
+      log_body = ENV['RESPONSE_LOG_BODY']
+      log_headers = ENV['RESPONSE_LOG_HEADERS']
+      headers_to_include = ENV['RESPONSE_HEADERS_TO_INCLUDE']
+      headers_to_exclude = ENV['RESPONSE_HEADERS_TO_EXCLUDE']
+      headers_to_unmask = ENV['RESPONSE_HEADERS_TO_UNMASK']
+
+      new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask
+      )
+    end
+
+    def self.any_logging_configured?
+      %w[
+        RESPONSE_LOG_BODY
+        RESPONSE_LOG_HEADERS
+        RESPONSE_HEADERS_TO_INCLUDE
+        RESPONSE_HEADERS_TO_EXCLUDE
+        RESPONSE_HEADERS_TO_UNMASK
+      ].any? { |key| ENV.key?(key) && !ENV[key].nil? && !ENV[key].empty? }
+    end
+  end
+
+  # Initializes a new instance of LoggingConfiguration.
+  class LoggingConfiguration < CoreLibrary::ApiLoggingConfiguration
+    def initialize(logger: nil, log_level: nil, mask_sensitive_headers: true,
+                   request_logging_config: nil,
+                   response_logging_config: nil)
+      request_logging_config ||= RequestLoggingConfiguration.new
+      response_logging_config ||= ResponseLoggingConfiguration.new
+      super(
+        logger,
+        log_level,
+        request_logging_config,
+        response_logging_config,
+        mask_sensitive_headers
+      )
+    end
+
+    def clone_with(logger: nil, log_level: nil, mask_sensitive_headers: nil,
+                   request_logging_config: nil, response_logging_config: nil)
+      logger ||= self.logger
+      log_level ||= self.log_level
+      mask_sensitive_headers ||= self.mask_sensitive_headers
+      request_logging_config ||= self.request_logging_config.clone
+      response_logging_config ||= self.response_logging_config.clone
+
+      LoggingConfiguration.new(
+        logger: logger,
+        log_level: log_level,
+        mask_sensitive_headers: mask_sensitive_headers,
+        request_logging_config: request_logging_config,
+        response_logging_config: response_logging_config
+      )
+    end
+
+    def self.from_env
+      log_level = ENV['LOG_LEVEL']
+      mask_sensitive_headers = ENV['MASK_SENSITIVE_HEADERS']
+
+      new(
+        log_level: log_level,
+        mask_sensitive_headers: mask_sensitive_headers,
+        request_logging_config: RequestLoggingConfiguration.from_env,
+        response_logging_config: ResponseLoggingConfiguration.from_env
+      )
+    end
+
+    def self.any_logging_configured?
+      RequestLoggingConfiguration.any_logging_configured? ||
+        ResponseLoggingConfiguration.any_logging_configured? ||
+        ENV.key?('LOG_LEVEL') ||
+        ENV.key?('MASK_SENSITIVE_HEADERS')
+    end
+  end
+end

data/lib/paypal_server_sdk/models/apple_pay_payment_data_type.rb

@@ -24,5 +24,18 @@ module PaypalServerSdk
 
       true
     end
+
+    def self.from_value(value, default_value = ENUM_3DSECURE)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'enum_3dsecure' then ENUM_3DSECURE
+      when 'emv' then EMV
+      else
+        default_value
+      end
+    end
   end
 end