checkout_sdk 0.3.0 → 1.0.0.beta.0

data/lib/checkout_sdk/apm/previous/klarna/klarna_client.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Previous
+    module Apm
+      module Klarna
+        class KlarnaClient < Client
+          CREDIT_SESSIONS = 'credit-sessions'
+          ORDERS = 'orders'
+          CAPTURES = 'captures'
+          VOIDS = 'voids'
+          private_constant :CREDIT_SESSIONS, :ORDERS, :CAPTURES, :VOIDS
+
+          # @param [ApiClient] api_client
+          # @param [CheckoutConfiguration] configuration
+          def initialize(api_client, configuration)
+            super api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY
+          end
+
+          # @param credit_session_request [CreditSessionRequest]
+          def create_credit_session(credit_session_request)
+            api_client.invoke_post(build_path(base_url, CREDIT_SESSIONS), sdk_authorization, credit_session_request)
+          end
+
+          # @param session_id [String]
+          def get_credit_session(session_id)
+            api_client.invoke_get(build_path(base_url, CREDIT_SESSIONS, session_id), sdk_authorization)
+          end
+
+          # @param payment_id [String]
+          # @param order_capture_request [OrderCaptureRequest]
+          def capture_payment(payment_id, order_capture_request)
+            api_client.invoke_post(build_path(base_url, ORDERS, payment_id, CAPTURES),
+                                   sdk_authorization,
+                                   order_capture_request)
+          end
+
+          # @param payment_id [String]
+          # @param void_request [CheckoutSdk::Payments::VoidRequest]
+          def void_payment(payment_id, void_request)
+            api_client.invoke_post(build_path(base_url, ORDERS, payment_id, VOIDS),
+                                   sdk_authorization,
+                                   void_request)
+          end
+
+          private
+
+          def base_url
+            sandbox? ? 'klarna-external' : 'klarna'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/checkout_sdk/apm/previous/klarna/klarna_product.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Previous
+    module Apm
+      module Klarna
+        # @!attribute name
+        #   @return [String]
+        # @!attribute quantity
+        #   @return [Integer]
+        # @!attribute unit_price
+        #   @return [Integer]
+        # @!attribute tax_rate
+        #   @return [Integer]
+        # @!attribute total_amount
+        #   @return [Integer]
+        # @!attribute total_tax_amount
+        #   @return [Integer]
+        class KlarnaProduct
+          attr_accessor :name,
+                        :quantity,
+                        :unit_price,
+                        :tax_rate,
+                        :total_amount,
+                        :total_tax_amount
+        end
+      end
+    end
+  end
+end

data/lib/checkout_sdk/apm/previous/klarna/klarna_shipping_info.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Previous
+    module Apm
+      module Klarna
+        # @!attribute shipping_company
+        #   @return [String]
+        # @!attribute shipping_method
+        #   @return [String]
+        # @!attribute tracking_number
+        #   @return [String]
+        # @!attribute tracking_uri
+        #   @return [String]
+        # @!attribute return_shipping_company
+        #   @return [String]
+        # @!attribute return_tracking_number
+        #   @return [String]
+        # @!attribute return_tracking_uri
+        #   @return [String]
+        class KlarnaShippingInfo
+          attr_accessor :shipping_company,
+                        :shipping_method,
+                        :tracking_number,
+                        :tracking_uri,
+                        :return_shipping_company,
+                        :return_tracking_number,
+                        :return_tracking_uri
+        end
+      end
+    end
+  end
+end

data/lib/checkout_sdk/apm/previous/klarna/order_capture_request.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Previous
+    module Apm
+      module Klarna
+        # @!attribute type
+        #   @return [CheckoutSdk::Common::PaymentSourceType]
+        # @!attribute amount
+        #   @return [Integer]
+        # @!attribute reference
+        #   @return [String]
+        # @!attribute metadata
+        #   @return [Hash(String=>Object)]
+        # @!attribute klarna
+        #   @return [Klarna]
+        # @!attribute shipping_info
+        #   @return [KlarnaShippingInfo]
+        # @!attribute shipping_delay
+        #   @return [Integer]
+        class OrderCaptureRequest
+          attr_reader :type
+          attr_accessor :amount,
+                        :reference,
+                        :metadata,
+                        :klarna,
+                        :shipping_info,
+                        :shipping_delay
+
+          def initialize
+            @type = CheckoutSdk::Common::PaymentSourceType::KLARNA
+          end
+        end
+      end
+    end
+  end
+end

data/lib/checkout_sdk/apm/previous/sepa/sepa_client.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Previous
+    module Apm
+      module Sepa
+        class SepaClient < Client
+          SEPA_MANDATES = 'sepa/mandates'
+          PPRO = 'ppro'
+          CANCEL = 'cancel'
+          private_constant :SEPA_MANDATES, :PPRO, :CANCEL
+
+          # @param [ApiClient] api_client
+          # @param [CheckoutConfiguration] configuration
+          def initialize(api_client, configuration)
+            super api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY
+          end
+
+          # @param mandate_id [String]
+          def get_mandate(mandate_id)
+            api_client.invoke_get(build_path(SEPA_MANDATES, mandate_id), sdk_authorization)
+          end
+
+          # @param mandate_id [String]
+          def cancel_mandate(mandate_id)
+            api_client.invoke_post(build_path(SEPA_MANDATES, mandate_id, CANCEL), sdk_authorization)
+          end
+
+          # @param mandate_id [String]
+          def get_mandate_via_ppro(mandate_id)
+            api_client.invoke_get(build_path(PPRO, SEPA_MANDATES, mandate_id), sdk_authorization)
+          end
+
+          # @param mandate_id [String]
+          def cancel_mandate_via_ppro(mandate_id)
+            api_client.invoke_post(build_path(PPRO, SEPA_MANDATES, mandate_id, CANCEL), sdk_authorization)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/checkout_sdk/authorization_type.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module AuthorizationType
+    PUBLIC_KEY = 'PUBLIC_KEY'
+    SECRET_KEY = 'SECRET_KEY'
+    PUBLIC_KEY_OR_OAUTH = 'PUBLIC_KEY_OR_OAUTH'
+    SECRET_KEY_OR_OAUTH = 'SECRET_KEY_OR_OAUTH'
+    OAUTH = 'OAUTH'
+    CUSTOM = 'CUSTOM'
+  end
+end

data/lib/checkout_sdk/checkout_api.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  # @!attribute customers
+  #   @return [CheckoutSdk::Customers::CustomersClient]
+  # @!attribute disputes
+  #   @return [CheckoutSdk::Disputes::DisputesClient]
+  # @!attribute forex
+  #   @return [CheckoutSdk::Forex::ForexClient]
+  # @!attribute instruments
+  #   @return [CheckoutSdk::Instruments::InstrumentsClient]
+  # @!attribute payments
+  #   @return [CheckoutSdk::Payments::PaymentsClient]
+  # @!attribute sessions
+  #   @return [CheckoutSdk::Sessions::SessionsClient]
+  # @!attribute tokens
+  #   @return [CheckoutSdk::Tokens::TokensClient]
+  # @!attribute ideal
+  #   @return [CheckoutSdk::Apm::IdealClient]
+  class CheckoutApi
+    attr_reader :customers,
+                :disputes,
+                :forex,
+                :instruments,
+                :payments,
+                :sessions,
+                :tokens,
+                :ideal
+
+    # @param [CheckoutConfiguration] configuration
+    def initialize(configuration)
+      api_client = base_api_client configuration
+      @customers = CheckoutSdk::Customers::CustomersClient.new api_client, configuration
+      @disputes = CheckoutSdk::Disputes::DisputesClient.new api_client, configuration
+      @forex = CheckoutSdk::Forex::ForexClient.new api_client, configuration
+      @instruments = CheckoutSdk::Instruments::InstrumentsClient.new api_client, configuration
+      @payments = CheckoutSdk::Payments::PaymentsClient.new api_client, configuration
+      @sessions = CheckoutSdk::Sessions::SessionsClient.new api_client, configuration
+      @tokens = CheckoutSdk::Tokens::TokensClient.new api_client, configuration
+      @ideal = CheckoutSdk::Apm::IdealClient.new api_client, configuration
+    end
+
+    private
+
+    # @param [CheckoutConfiguration] configuration
+    # @return [ApiClient]
+    def base_api_client(configuration)
+      CheckoutSdk::ApiClient.new configuration, configuration.environment.base_uri
+    end
+  end
+end

data/lib/checkout_sdk/checkout_configuration.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  # @!attribute credentials
+  #   @return [SdkCredentials]
+  # @!attribute environment
+  #   @return [Environment]
+  # @!attribute http_client
+  #   @return [Object]
+  class CheckoutConfiguration
+    attr_accessor :credentials, :environment, :http_client
+
+    # @param [SdkCredentials] credentials
+    # @param [Environment] environment
+    # @param [Object] http_client
+    def initialize(credentials, environment, http_client)
+      @credentials = credentials
+      @environment = environment
+      @http_client = http_client
+    end
+  end
+end

data/lib/checkout_sdk/checkout_oauth_sdk_builder.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  # @!attribute client_id
+  #   @return [String]
+  # @!attribute client_secret
+  #   @return [String]
+  # @!attribute authorization_uri
+  #   @return [String]
+  # @!attribute scopes
+  #   @return [Array(CheckoutSdk::OAuthScopes)]
+  class CheckoutOAuthSdkBuilder < AbstractCheckoutSdkBuilder
+    attr_accessor :client_id,
+                  :client_secret,
+                  :authorization_uri,
+                  :scopes
+
+    # @param [String] client_id
+    # @param [String] client_secret
+    # @return [CheckoutOAuthSdkBuilder]
+    def with_client_credentials(client_id, client_secret)
+      @client_id = client_id
+      @client_secret = client_secret
+      self
+    end
+
+    # @param [String] authorization_uri
+    # @return [CheckoutOAuthSdkBuilder]
+    def with_authorization_uri(authorization_uri)
+      @authorization_uri = authorization_uri
+      self
+    end
+
+    # @param [Array(CheckoutSdk::OAuthScopes)] scopes
+    # @return [CheckoutOAuthSdkBuilder]
+    def with_scopes(scopes)
+      @scopes = scopes
+      self
+    end
+
+    # @return [CheckoutSdk::CheckoutApi]
+    def build
+      CheckoutSdk::CheckoutApi.new(
+        CheckoutConfiguration.new(
+          OAuthSdkCredentials.new(client_id, client_secret, scopes, http_client, environment, authorization_uri),
+          environment,
+          http_client
+        )
+      )
+    end
+  end
+end

data/lib/checkout_sdk/checkout_sdk_builder.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  class CheckoutSdkBuilder
+    # @return [CheckoutSdk::CheckoutStaticKeysSdkBuilder]
+    def static_keys
+      CheckoutSdk::CheckoutStaticKeysSdkBuilder.new
+    end
+
+    # @return [CheckoutSdk::CheckoutOAuthSdkBuilder]
+    def oauth
+      CheckoutSdk::CheckoutOAuthSdkBuilder.new
+    end
+
+    # @return [CheckoutSdk::Previous::CheckoutPreviousSdkBuilder]
+    def previous
+      CheckoutSdk::Previous::CheckoutPreviousSdkBuilder.new
+    end
+  end
+end

data/lib/checkout_sdk/checkout_static_keys_sdk_builder.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  class CheckoutStaticKeysSdkBuilder < StaticKeysBuilder
+    SECRET_KEY_PATTERN = '^sk_(sbox_)?[a-z2-7]{26}[a-z2-7*#$=]$'
+    PUBLIC_KEY_PATTERN = '^pk_(sbox_)?[a-z2-7]{26}[a-z2-7*#$=]$'
+    private_constant :SECRET_KEY_PATTERN, :PUBLIC_KEY_PATTERN
+
+    # @return [CheckoutSdk::CheckoutApi]
+    def build
+      @secret_key_pattern = SECRET_KEY_PATTERN
+      @public_key_pattern = PUBLIC_KEY_PATTERN
+      super
+      CheckoutApi.new(
+        CheckoutConfiguration.new(
+          StaticKeysSdkCredentials.new(secret_key, public_key),
+          environment,
+          http_client
+        )
+      )
+    end
+  end
+end

data/lib/checkout_sdk/checkout_utils.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  class CheckoutUtils
+    # @return [CheckoutSdk::HttpMetadata]
+    def self.map_to_http_metadata(response)
+      metadata = CheckoutSdk::HttpMetadata.new
+      # TODO: convert to hash
+      metadata.headers = response[:headers]
+      metadata.status_code = response[:status]
+      metadata.body = response[:body]
+      metadata
+    end
+  end
+end

data/lib/checkout_sdk/client.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  # @!attribute api_client
+  #   @return [ApiClient]
+  # @!attribute authorization_type
+  #   @return [CheckoutConfiguration]
+  # @!attribute configuration
+  #   @return [String] {AuthorizationType}
+  class Client
+    attr_reader :api_client,
+                :authorization_type,
+                :configuration
+    protected :api_client, :authorization_type, :configuration
+
+    # @param [CheckoutSdk::ApiClient] api_client
+    # @param [CheckoutConfiguration] configuration
+    # @param [String] authorization_type {AuthorizationType}
+    def initialize(api_client, configuration, authorization_type)
+      @api_client = api_client
+      @authorization_type = authorization_type
+      @configuration = configuration
+    end
+
+    protected
+
+    # @param [Array] args
+    def build_path(*args)
+      args.join('/')
+    end
+
+    # @return [TrueClass, FalseClass]
+    def sandbox?
+      @configuration.environment.is_sandbox
+    end
+
+    # @param [String, nil] authorization_type {AuthorizationType}
+    def sdk_authorization(authorization_type = nil)
+      if authorization_type.nil?
+        configuration.credentials.get_authorization(@authorization_type)
+      else
+        configuration.credentials.get_authorization(authorization_type)
+      end
+    end
+  end
+end

data/lib/checkout_sdk/common/abstract_file_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # @!attribute file
+    #   @return [String]
+    class AbstractFileRequest
+      attr_accessor :file
+    end
+  end
+end

data/lib/checkout_sdk/common/account_holder.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # @!attribute type
+    #   @return [String] {AccountHolderType}
+    # @!attribute first_name
+    #   @return [String]
+    # @!attribute last_name
+    #   @return [String]
+    # @!attribute company_name
+    #   @return [String]
+    # @!attribute tax_id
+    #   @return [String]
+    # @!attribute date_of_birth
+    #   @return [String]
+    # @!attribute country_of_birth
+    #   @return [Country]
+    # @!attribute residential_status
+    #   @return [String]
+    # @!attribute billing_address
+    #   @return [Address]
+    # @!attribute phone
+    #   @return [Phone]
+    # @!attribute identification
+    #   @return [AccountHolderIdentification]
+    # @!attribute email
+    #   @return [String]
+    class AccountHolder
+      attr_accessor :type,
+                    :first_name,
+                    :last_name,
+                    :company_name,
+                    :tax_id,
+                    :date_of_birth,
+                    :country_of_birth,
+                    :residential_status,
+                    :billing_address,
+                    :phone,
+                    :identification,
+                    :email
+    end
+  end
+end

data/lib/checkout_sdk/common/account_holder_identification.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # @!attribute type
+    #   @return [String] {AccountHolderIdentificationType}
+    # @!attribute number
+    #   @return [String]
+    # @!attribute issuing_country
+    #   @return [String] {Country}
+    # @!attribute date_of_expiry
+    #   @return [String]
+    class AccountHolderIdentification
+      attr_accessor :type,
+                    :number,
+                    :issuing_country,
+                    :date_of_expiry
+    end
+  end
+end

data/lib/checkout_sdk/common/account_holder_identification_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    module AccountHolderIdentificationType
+      PASSPORT = 'passport'
+      DRIVING_LICENSE = 'driving_licence'
+      NATIONAL_ID = 'national_id'
+      COMPANY_REGISTRATION = 'company_registration'
+      TAX_ID = 'tax_id'
+    end
+  end
+end

data/lib/checkout_sdk/common/account_holder_type.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    module AccountHolderType
+      INDIVIDUAL = 'individual'
+      CORPORATE = 'corporate'
+      INSTRUMENT = 'instrument'
+    end
+  end
+end

data/lib/checkout_sdk/common/account_type.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    module AccountType
+      SAVINGS = 'savings'
+      CURRENT = 'current'
+      CASH = 'cash'
+    end
+  end
+end

data/lib/checkout_sdk/common/address.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # @!attribute address_line1
+    #   @return [String]
+    # @!attribute address_line2
+    #   @return [String]
+    # @!attribute city
+    #   @return [String]
+    # @!attribute state
+    #   @return [String]
+    # @!attribute zip
+    #   @return [String]
+    # @!attribute country
+    #   @return [String]
+    class Address
+      attr_accessor :address_line1,
+                    :address_line2,
+                    :city,
+                    :state,
+                    :zip,
+                    :country
+    end
+  end
+end

data/lib/checkout_sdk/common/amount_allocations.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # @!attribute id
+    #   @return [String]
+    # @!attribute amount
+    #   @return [Integer]
+    # @!attribute reference
+    #   @return [String]
+    # @!attribute commission
+    #   @return [Commission]
+    class AmountAllocations
+      attr_accessor :id,
+                    :amount,
+                    :reference,
+                    :commission
+    end
+  end
+end

data/lib/checkout_sdk/common/bank_details.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # @!attribute name
+    #   @return [String]
+    # @!attribute branch
+    #   @return [String]
+    # @!attribute address
+    #   @return [Address]
+    class BankDetails
+      attr_accessor :name,
+                    :branch,
+                    :address
+    end
+  end
+end

data/lib/checkout_sdk/common/challenge_indicator.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    module ChallengeIndicator
+      NO_PREFERENCE = 'no_preference'
+      NO_CHALLENGE_REQUESTED = 'no_challenge_requested'
+      CHALLENGE_REQUESTED = 'challenge_requested'
+      CHALLENGE_REQUESTED_MANDATE = 'challenge_requested_mandate'
+    end
+  end
+end

data/lib/checkout_sdk/common/commission.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # @!attribute amount
+    #   @return [Integer]
+    # @!attribute percentage
+    #   @return [Integer]
+    class Commission
+      attr_accessor :amount,
+                    :percentage
+    end
+  end
+end