paypal-server-sdk 0.5.0

data/lib/paypal_server_sdk/exceptions/error_exception.rb

@@ -0,0 +1,71 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # The error details.
+  class ErrorException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The human-readable, unique name of the error.
+    # @return [String]
+    attr_accessor :name
+
+    # The message that describes the error.
+    # @return [String]
+    attr_accessor :message
+
+    # The PayPal internal ID. Used for correlation purposes.
+    # @return [String]
+    attr_accessor :debug_id
+
+    # An array of additional details about the error.
+    # @return [Array[ErrorDetails]]
+    attr_accessor :details
+
+    # An array of request-related [HATEOAS
+    # links](/api/rest/responses/#hateoas-links).
+    # @return [Array[LinkDescription]]
+    attr_accessor :links
+
+    # The constructor.
+    # @param [String] The reason for raising an exception.
+    # @param [HttpResponse] The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      @name = hash.key?('name') ? hash['name'] : nil
+      @message = hash.key?('message') ? hash['message'] : nil
+      @debug_id = hash.key?('debug_id') ? hash['debug_id'] : nil
+      # Parameter is an array, so we need to iterate through it
+      @details = nil
+      unless hash['details'].nil?
+        @details = []
+        hash['details'].each do |structure|
+          @details << (ErrorDetails.from_hash(structure) if structure)
+        end
+      end
+
+      @details = SKIP unless hash.key?('details')
+      # Parameter is an array, so we need to iterate through it
+      @links = nil
+      unless hash['links'].nil?
+        @links = []
+        hash['links'].each do |structure|
+          @links << (LinkDescription.from_hash(structure) if structure)
+        end
+      end
+
+      @links = SKIP unless hash.key?('links')
+    end
+  end
+end

data/lib/paypal_server_sdk/exceptions/o_auth_provider_exception.rb

@@ -0,0 +1,48 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # OAuth 2 Authorization endpoint exception.
+  class OAuthProviderException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Gets or sets error code.
+    # @return [OAuthProviderError]
+    attr_accessor :error
+
+    # Gets or sets human-readable text providing additional information on
+    # error.
+    # Used to assist the client developer in understanding the error that
+    # occurred.
+    # @return [String]
+    attr_accessor :error_description
+
+    # Gets or sets a URI identifying a human-readable web page with information
+    # about the error, used to provide the client developer with additional
+    # information about the error.
+    # @return [String]
+    attr_accessor :error_uri
+
+    # The constructor.
+    # @param [String] The reason for raising an exception.
+    # @param [HttpResponse] The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      @error = hash.key?('error') ? hash['error'] : nil
+      @error_description =
+        hash.key?('error_description') ? hash['error_description'] : SKIP
+      @error_uri = hash.key?('error_uri') ? hash['error_uri'] : SKIP
+    end
+  end
+end

data/lib/paypal_server_sdk/http/api_response.rb

@@ -0,0 +1,21 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # Http response received.
+  class ApiResponse < CoreLibrary::ApiResponse
+
+
+    # The constructor
+    # @param [HttpResponse] http_response The original, raw response from the api.
+    # @param [Object] data The data field specified for the response.
+    # @param [Array<String>] errors Any errors returned by the server.
+    def initialize(http_response,
+                   data: nil,
+                   errors: nil)
+      super
+    end
+  end
+end

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

@@ -0,0 +1,136 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # Utility class for OAuth 2 authorization and token management.
+  class OAuth2 < CoreLibrary::HeaderAuth
+    include CoreLibrary
+    # Display error message on occurrence of authentication failure.
+    # @returns [String] The oAuth error message.
+    def error_message
+      'ClientCredentialsAuth: OAuthToken is undefined or expired.'
+    end
+
+    # Initialization constructor.
+    def initialize(client_credentials_auth_credentials, config)
+      @_o_auth_client_id = client_credentials_auth_credentials.o_auth_client_id unless
+        client_credentials_auth_credentials.nil? || client_credentials_auth_credentials.o_auth_client_id.nil?
+      @_o_auth_client_secret = client_credentials_auth_credentials.o_auth_client_secret unless
+        client_credentials_auth_credentials.nil? || client_credentials_auth_credentials.o_auth_client_secret.nil?
+      @_o_auth_token = client_credentials_auth_credentials.o_auth_token unless
+        client_credentials_auth_credentials.nil? || client_credentials_auth_credentials.o_auth_token.nil?
+      @_o_auth_clock_skew = client_credentials_auth_credentials.o_auth_clock_skew unless
+        client_credentials_auth_credentials.nil? || client_credentials_auth_credentials.o_auth_clock_skew.nil?
+      @_o_auth_token_provider = client_credentials_auth_credentials.o_auth_token_provider unless
+        client_credentials_auth_credentials.nil? || client_credentials_auth_credentials.o_auth_token_provider.nil?
+      @_o_auth_on_token_update = client_credentials_auth_credentials.o_auth_on_token_update unless
+        client_credentials_auth_credentials.nil? || client_credentials_auth_credentials.o_auth_on_token_update.nil?
+      @_o_auth_api = OAuthAuthorizationController.new(config)
+      super({})
+    end
+
+    # Validates the oAuth token.
+    # @return [Boolean] true if the token is present and not expired.
+    def valid
+      @_o_auth_token = get_token_from_provider
+      @_o_auth_token.is_a?(OAuthToken) && !token_expired?(@_o_auth_token)
+    end
+
+    # Builds the basic auth header for endpoints in the OAuth Authorization Controller.
+    # @return [String] The value of the Authentication header.
+    def build_basic_auth_header
+      "Basic #{AuthHelper.get_base64_encoded_value(@_o_auth_client_id, @_o_auth_client_secret)}"
+    end
+
+    # Fetches the token.
+    # @param [Hash] additional_params Any additional form parameters.
+    # @return [OAuthToken] The oAuth token instance.
+    def fetch_token(additional_params: nil)
+      token = @_o_auth_api.request_token(
+        {
+          'authorization' => build_basic_auth_header
+        },
+        _field_parameters: additional_params
+      ).data
+      if token.respond_to?('expires_in') && !token.expires_in.nil?
+        token.expiry = AuthHelper.get_token_expiry(token.expires_in, Time.now.utc.to_i)
+      end
+      token
+    end
+
+    # Checks if OAuth token has expired.
+    # @param [OAuthToken] token The oAuth token instance.
+    # @return [Boolean] true if the token's expiry exist and also the token is expired, false otherwise.
+    def token_expired?(token)
+      token.respond_to?('expiry') && AuthHelper.token_expired?(token.expiry, @_o_auth_clock_skew)
+    end
+
+    def apply(http_request)
+      auth_params = { 'Authorization' => "Bearer #{@_o_auth_token.access_token}" }
+      AuthHelper.apply(auth_params, http_request.method(:add_header))
+    end
+
+    private
+
+    # This provides the OAuth Token from either the user configured callbacks or from default provider.
+    # @return [OAuthToken] The fetched oauth token.
+    def get_token_from_provider
+      return @_o_auth_token if @_o_auth_token && !token_expired?(@_o_auth_token)
+
+      if @_o_auth_token_provider
+        o_auth_token = @_o_auth_token_provider.call(@_o_auth_token, self)
+        @_o_auth_on_token_update&.call(o_auth_token)
+        return o_auth_token
+      end
+      begin
+        o_auth_token = fetch_token
+        @_o_auth_on_token_update&.call(o_auth_token)
+        o_auth_token
+      rescue ApiException
+        @_o_auth_token
+      end
+    end
+  end
+
+  # Data class for ClientCredentialsAuthCredentials.
+  class ClientCredentialsAuthCredentials
+    attr_reader :o_auth_client_id, :o_auth_client_secret, :o_auth_token,
+                :o_auth_token_provider, :o_auth_on_token_update,
+                :o_auth_clock_skew
+
+    def initialize(o_auth_client_id:, o_auth_client_secret:, o_auth_token: nil,
+                   o_auth_token_provider: nil, o_auth_on_token_update: nil,
+                   o_auth_clock_skew: nil)
+      raise ArgumentError, 'o_auth_client_id cannot be nil' if o_auth_client_id.nil?
+      raise ArgumentError, 'o_auth_client_secret cannot be nil' if o_auth_client_secret.nil?
+
+      @o_auth_client_id = o_auth_client_id
+      @o_auth_client_secret = o_auth_client_secret
+      @o_auth_token = o_auth_token
+      @o_auth_token_provider = o_auth_token_provider
+      @o_auth_on_token_update = o_auth_on_token_update
+      @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)
+      o_auth_client_id ||= self.o_auth_client_id
+      o_auth_client_secret ||= self.o_auth_client_secret
+      o_auth_token ||= self.o_auth_token
+      o_auth_token_provider ||= self.o_auth_token_provider
+      o_auth_on_token_update ||= self.o_auth_on_token_update
+      o_auth_clock_skew ||= self.o_auth_clock_skew
+
+      ClientCredentialsAuthCredentials.new(
+        o_auth_client_id: o_auth_client_id,
+        o_auth_client_secret: o_auth_client_secret, o_auth_token: o_auth_token,
+        o_auth_token_provider: o_auth_token_provider,
+        o_auth_on_token_update: o_auth_on_token_update,
+        o_auth_clock_skew: o_auth_clock_skew
+      )
+    end
+  end
+end

data/lib/paypal_server_sdk/http/http_call_back.rb

@@ -0,0 +1,10 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # HttpCallBack allows defining callables for pre and post API calls.
+  class HttpCallBack < CoreLibrary::HttpCallback
+  end
+end

data/lib/paypal_server_sdk/http/http_method_enum.rb

@@ -0,0 +1,10 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # HTTP Methods Enumeration.
+  class HttpMethodEnum < CoreLibrary::HttpMethod
+  end
+end

data/lib/paypal_server_sdk/http/http_request.rb

@@ -0,0 +1,10 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # Represents a single Http Request.
+  class HttpRequest < CoreLibrary::HttpRequest
+  end
+end

data/lib/paypal_server_sdk/http/http_response.rb

@@ -0,0 +1,10 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # Http response received.
+  class HttpResponse < CoreLibrary::HttpResponse
+  end
+end

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

@@ -0,0 +1,114 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://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

data/lib/paypal_server_sdk/logging/sdk_logger.rb

@@ -0,0 +1,17 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # Represents the generic logger facade
+  class AbstractLogger < Logger
+    # Logs a message with a specified log level and additional parameters.
+    # @param level [Symbol] The log level of the message.
+    # @param message [String] The message to log.
+    # @param params [Hash] Additional parameters to include in the log message.
+    def log(level, message, params)
+      raise NotImplementedError, 'This method needs to be implemented in a child class.'
+    end
+  end
+end

data/lib/paypal_server_sdk/models/activity_timestamps.rb

@@ -0,0 +1,68 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # The date and time stamps that are common to authorized payment, captured
+  # payment, and refund transactions.
+  class ActivityTimestamps < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The date and time, in [Internet date and time
+    # format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are
+    # required while fractional seconds are
+    # optional.<blockquote><strong>Note:</strong> The regular expression
+    # provides guidance but does not reject all invalid dates.</blockquote>
+    # @return [String]
+    attr_accessor :create_time
+
+    # The date and time, in [Internet date and time
+    # format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are
+    # required while fractional seconds are
+    # optional.<blockquote><strong>Note:</strong> The regular expression
+    # provides guidance but does not reject all invalid dates.</blockquote>
+    # @return [String]
+    attr_accessor :update_time
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['create_time'] = 'create_time'
+      @_hash['update_time'] = 'update_time'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        create_time
+        update_time
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(create_time: SKIP, update_time: SKIP)
+      @create_time = create_time unless create_time == SKIP
+      @update_time = update_time unless update_time == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      create_time = hash.key?('create_time') ? hash['create_time'] : SKIP
+      update_time = hash.key?('update_time') ? hash['update_time'] : SKIP
+
+      # Create object from extracted values.
+      ActivityTimestamps.new(create_time: create_time,
+                             update_time: update_time)
+    end
+  end
+end

data/lib/paypal_server_sdk/models/address.rb

@@ -0,0 +1,116 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # The portable international postal address. Maps to
+  # [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wi
+  # ki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the
+  # autocomplete
+  # attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-cont
+  # rols-the-autocomplete-attribute).
+  class Address < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The first line of the address, such as number and street, for example,
+    # `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks.
+    # This field needs to pass the full address.
+    # @return [String]
+    attr_accessor :address_line_1
+
+    # The second line of the address, for example, a suite or apartment number.
+    # @return [String]
+    attr_accessor :address_line_2
+
+    # A city, town, or village. Smaller than `admin_area_level_1`.
+    # @return [String]
+    attr_accessor :admin_area_2
+
+    # The highest-level sub-division in a country, which is usually a province,
+    # state, or ISO-3166-2 subdivision. This data is formatted for postal
+    # delivery, for example, `CA` and not `California`. Value, by country,
+    # is:<ul><li>UK. A county.</li><li>US. A state.</li><li>Canada. A
+    # province.</li><li>Japan. A prefecture.</li><li>Switzerland. A
+    # *kanton*.</li></ul>
+    # @return [String]
+    attr_accessor :admin_area_1
+
+    # The postal code, which is the ZIP code or equivalent. Typically required
+    # for countries with a postal code or an equivalent. See [postal
+    # code](https://en.wikipedia.org/wiki/Postal_code).
+    # @return [String]
+    attr_accessor :postal_code
+
+    # The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that
+    # identifies the country or region.<blockquote><strong>Note:</strong> The
+    # country code for Great Britain is <code>GB</code> and not <code>UK</code>
+    # as used in the top-level domain names for that country. Use the `C2`
+    # country code for China worldwide for comparable uncontrolled price (CUP)
+    # method, bank card, and cross-border transactions.</blockquote>
+    # @return [String]
+    attr_accessor :country_code
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['address_line_1'] = 'address_line_1'
+      @_hash['address_line_2'] = 'address_line_2'
+      @_hash['admin_area_2'] = 'admin_area_2'
+      @_hash['admin_area_1'] = 'admin_area_1'
+      @_hash['postal_code'] = 'postal_code'
+      @_hash['country_code'] = 'country_code'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        address_line_1
+        address_line_2
+        admin_area_2
+        admin_area_1
+        postal_code
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(country_code:, address_line_1: SKIP, address_line_2: SKIP,
+                   admin_area_2: SKIP, admin_area_1: SKIP, postal_code: SKIP)
+      @address_line_1 = address_line_1 unless address_line_1 == SKIP
+      @address_line_2 = address_line_2 unless address_line_2 == SKIP
+      @admin_area_2 = admin_area_2 unless admin_area_2 == SKIP
+      @admin_area_1 = admin_area_1 unless admin_area_1 == SKIP
+      @postal_code = postal_code unless postal_code == SKIP
+      @country_code = country_code
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      country_code = hash.key?('country_code') ? hash['country_code'] : nil
+      address_line_1 =
+        hash.key?('address_line_1') ? hash['address_line_1'] : SKIP
+      address_line_2 =
+        hash.key?('address_line_2') ? hash['address_line_2'] : SKIP
+      admin_area_2 = hash.key?('admin_area_2') ? hash['admin_area_2'] : SKIP
+      admin_area_1 = hash.key?('admin_area_1') ? hash['admin_area_1'] : SKIP
+      postal_code = hash.key?('postal_code') ? hash['postal_code'] : SKIP
+
+      # Create object from extracted values.
+      Address.new(country_code: country_code,
+                  address_line_1: address_line_1,
+                  address_line_2: address_line_2,
+                  admin_area_2: admin_area_2,
+                  admin_area_1: admin_area_1,
+                  postal_code: postal_code)
+    end
+  end
+end