first_data_gateway 1.0.1

data/lib/simple/client_context.rb

@@ -0,0 +1,15 @@
+module SimpleClient
+	class ClientContext
+		attr_reader :client, :config, :credentials
+
+		def self.create(credentials)
+			return self.new(credentials)
+		end
+
+		def initialize(credentials)
+			@config = SwaggerClient::Configuration.new
+			@client = SwaggerClient::ApiClient.new(@config)
+			@credentials = credentials
+		end
+	end
+end

data/lib/simple/gateway.rb

@@ -0,0 +1,155 @@
+require "json"
+
+module SimpleClient
+	class Gateway
+
+		CONTENT_TYPE = "application/json"
+
+		def self.create(credentials)
+			return self.new(ClientContext.new(credentials))
+		end
+
+		def initialize(context)
+			@context = context
+			@authentication_api = SwaggerClient::AuthenticationApi.new(@context.client)
+			@order_api = SwaggerClient::OrderApi.new(@context.client)
+			@payment_api = SwaggerClient::PaymentApi.new(@context.client)
+		end
+
+		def request_access_token
+			signature_service = get_signature_service
+			message_signature = signature_service.sign
+			return @authentication_api.v1_authentication_access_tokens_post(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature
+			)
+		end
+
+		def primary_payment_transaction(payload)
+			signature_service = get_signature_service
+			message_signature = signature_service.sign(payload)
+			return @payment_api.primary_payment_transaction(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature,
+				payload
+			)
+		end
+
+		def return_transaction(transaction_id, payload, store_id=nil)
+			opts = {store_id: store_id}
+			signature_service = get_signature_service
+			message_signature = signature_service.sign(payload)
+			return @payment_api.return_transaction(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature,
+				transaction_id,
+				payload,
+				opts
+			)
+		end
+
+		def transaction_inquiry(transaction_id, store_id=nil)
+			opts = {store_id: store_id}
+			signature_service = get_signature_service
+			message_signature = signature_service.sign
+			return @payment_api.transaction_inquiry(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature,
+				transaction_id,
+				opts
+			)
+		end
+
+		def void_transaction(transaction_id, store_id=nil)
+			opts = {store_id: store_id}
+			signature_service = get_signature_service
+			message_signature = signature_service.sign
+			return @payment_api.void_transaction(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature,
+				transaction_id,
+				opts
+			)
+		end
+
+		def perform_payment_post_authorization_by_order(order_id, payload, store_id=nil)
+			opts = {store_id: store_id}
+			signature_service = get_signature_service
+			message_signature = signature_service.sign(payload)
+			return @order_api.perform_payment_post_authorisation(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature, 
+				order_id,
+				payload,
+				opts
+			)
+		end
+
+		def perform_payment_authorization_by_transaction(transaction_id, payload, store_id=nil)
+			opts = {store_id: store_id}
+			signature_service = get_signature_service
+			message_signature = signature_service.sign(payload)
+			return @payment_api.perform_payment_post_authorisation(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature,
+				transaction_id,
+				payload,
+				opts
+			)
+		end
+
+		def return_transaction_by_order(order_id, payload, store_id=nil)
+			opts = {store_id: store_id}
+			signature_service = get_signature_service
+			message_signature = signature_service.sign(payload)
+			return @order_api.return_transaction(
+				CONTENT_TYPE, 
+				signature_service.client_request_id, 
+				get_api_key, 
+				signature_service.timestamp, 
+				message_signature,
+				order_id,
+				payload,
+				opts
+			)
+		end
+
+		private
+
+		def get_signature_service
+			return Signature.new(
+				api_key: get_api_key,
+				api_secret: get_api_secret
+			)
+		end
+
+		def get_api_key
+			@context.credentials.api_key
+		end
+
+		def get_api_secret
+			@context.credentials.api_secret
+		end
+	end
+end

data/lib/simple/merchant_credentials.rb

@@ -0,0 +1,10 @@
+module SimpleClient
+	class MerchantCredentials
+		attr_reader :api_key, :api_secret
+
+		def initialize(api_key, api_secret)
+			@api_secret = api_secret
+			@api_key = api_key
+		end
+	end
+end

data/lib/simple/signature.rb

@@ -0,0 +1,52 @@
+require "json"
+require "openssl"
+require "base64"
+require "securerandom"
+require "date"
+
+module SimpleClient
+	class Signature
+	
+		ATTR = [
+			:api_key,
+			:api_secret,
+			:digest
+		]
+
+		attr_reader :client_request_id, :timestamp
+		
+		def initialize(params)
+			ATTR.each { |attr| instance_variable_set("@#{attr}", params[attr]) if params[attr] }
+			@digest = "sha256" if !@digest
+			@client_request_id = SecureRandom.uuid
+			@timestamp = DateTime.now.strftime("%Q")
+		end
+
+		def sign(payload=nil)
+			data = @api_key + @client_request_id + @timestamp
+			data += jsonify(payload) if payload
+			hmac = OpenSSL::HMAC.hexdigest(@digest, @api_secret, data)
+			Base64.urlsafe_encode64(hmac)
+		end
+
+		def jsonify(model)
+			return model if model.nil? || model.is_a?(String)
+			local_body = nil
+			if model.is_a?(Array)
+				local_body = model.map{|m| object_to_hash(m) }
+			else
+				local_body = object_to_hash(model)
+			end
+			local_body.to_json
+		end
+	
+		def object_to_hash(obj)
+			if obj.respond_to?(:to_hash)
+		 		obj.to_hash
+			else
+				obj
+			end
+		end
+		
+	end
+end

data/lib/simple_client.rb

@@ -0,0 +1,4 @@
+require_relative 'simple/gateway'
+require_relative 'simple/client_context'
+require_relative 'simple/merchant_credentials'
+require_relative 'simple/signature'

data/lib/swagger_client.rb

@@ -0,0 +1,91 @@
+=begin
+#Payment Gateway API Specification
+
+#Payment Gateway API for payment processing. 
+
+OpenAPI spec version: 0.0.1
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: unset
+
+=end
+
+# Common files
+require 'swagger_client/api_client'
+require 'swagger_client/api_error'
+require 'swagger_client/version'
+require 'swagger_client/configuration'
+
+# Models
+require 'swagger_client/models/access_token_response'
+require 'swagger_client/models/address'
+require 'swagger_client/models/airline'
+require 'swagger_client/models/airline_ancillary_service_category'
+require 'swagger_client/models/airline_travel_route'
+require 'swagger_client/models/amount'
+require 'swagger_client/models/amount_components'
+require 'swagger_client/models/authentication_response_verification'
+require 'swagger_client/models/basket_item'
+require 'swagger_client/models/billing'
+require 'swagger_client/models/car_rental'
+require 'swagger_client/models/car_rental_extra_charges'
+require 'swagger_client/models/card_verifications_transaction'
+require 'swagger_client/models/client_locale'
+require 'swagger_client/models/contact'
+require 'swagger_client/models/error'
+require 'swagger_client/models/error_details'
+require 'swagger_client/models/error_response'
+require 'swagger_client/models/expiration'
+require 'swagger_client/models/frequency'
+require 'swagger_client/models/industry_specific_extensions'
+require 'swagger_client/models/installment_options'
+require 'swagger_client/models/lodging'
+require 'swagger_client/models/lodging_extra_charges'
+require 'swagger_client/models/order'
+require 'swagger_client/models/pay_pal'
+require 'swagger_client/models/payment_card'
+require 'swagger_client/models/payment_card_authentication_request'
+require 'swagger_client/models/payment_card_authentication_result'
+require 'swagger_client/models/payment_method'
+require 'swagger_client/models/payment_schedules_request'
+require 'swagger_client/models/payment_schedules_response'
+require 'swagger_client/models/payment_url_request'
+require 'swagger_client/models/payment_url_response'
+require 'swagger_client/models/primary_transaction'
+require 'swagger_client/models/primary_transaction_additional_details'
+require 'swagger_client/models/processor_data'
+require 'swagger_client/models/response_type'
+require 'swagger_client/models/secondary_transaction'
+require 'swagger_client/models/sepa'
+require 'swagger_client/models/sepa_mandate'
+require 'swagger_client/models/shipping'
+require 'swagger_client/models/split_shipment'
+require 'swagger_client/models/stored_credential'
+require 'swagger_client/models/transaction_response'
+require 'swagger_client/models/transaction_response_authentication_redirect'
+require 'swagger_client/models/transaction_response_authentication_redirect_params'
+require 'swagger_client/models/transaction_type'
+require 'swagger_client/models/transaction_error_response'
+
+# APIs
+require 'swagger_client/api/authentication_api'
+require 'swagger_client/api/order_api'
+require 'swagger_client/api/payment_api'
+
+module SwaggerClient
+  class << self
+    # Customize default settings for the SDK using block.
+    #   SwaggerClient.configure do |config|
+    #     config.username = "xxx"
+    #     config.password = "xxx"
+    #   end
+    # If no block given, return the default Configuration object.
+    def configure
+      if block_given?
+        yield(Configuration.default)
+      else
+        Configuration.default
+      end
+    end
+  end
+end

data/lib/swagger_client/api/authentication_api.rb

@@ -0,0 +1,111 @@
+=begin
+#Payment Gateway API Specification
+
+#Payment Gateway API for payment processing. 
+
+OpenAPI spec version: 0.0.1
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: unset
+
+=end
+
+require "uri"
+
+module SwaggerClient
+  class AuthenticationApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+
+    # Generate an access token for user authentication
+    # This is the access token generation call for authorizing subsequent financial transactions. A valid access token is required for web client requests. 
+    # @param content_type content type
+    # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
+    # @param api_key 
+    # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
+    # @param message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @param [Hash] opts the optional parameters
+    # @return [AccessTokenResponse]
+    def v1_authentication_access_tokens_post(content_type, client_request_id, api_key, timestamp, message_signature, opts = {})
+      data, _status_code, _headers = v1_authentication_access_tokens_post_with_http_info(content_type, client_request_id, api_key, timestamp, message_signature, opts)
+      return data
+    end
+
+    # Generate an access token for user authentication
+    # This is the access token generation call for authorizing subsequent financial transactions. A valid access token is required for web client requests. 
+    # @param content_type content type
+    # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
+    # @param api_key 
+    # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
+    # @param message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AccessTokenResponse, Fixnum, Hash)>] AccessTokenResponse data, response status code and response headers
+    def v1_authentication_access_tokens_post_with_http_info(content_type, client_request_id, api_key, timestamp, message_signature, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: AuthenticationApi.v1_authentication_access_tokens_post ..."
+      end
+      # verify the required parameter 'content_type' is set
+      if @api_client.config.client_side_validation && content_type.nil?
+        fail ArgumentError, "Missing the required parameter 'content_type' when calling AuthenticationApi.v1_authentication_access_tokens_post"
+      end
+      # verify enum value
+      if @api_client.config.client_side_validation && !['application/json'].include?(content_type)
+        fail ArgumentError, "invalid value for 'content_type', must be one of application/json"
+      end
+      # verify the required parameter 'client_request_id' is set
+      if @api_client.config.client_side_validation && client_request_id.nil?
+        fail ArgumentError, "Missing the required parameter 'client_request_id' when calling AuthenticationApi.v1_authentication_access_tokens_post"
+      end
+      # verify the required parameter 'api_key' is set
+      if @api_client.config.client_side_validation && api_key.nil?
+        fail ArgumentError, "Missing the required parameter 'api_key' when calling AuthenticationApi.v1_authentication_access_tokens_post"
+      end
+      # verify the required parameter 'timestamp' is set
+      if @api_client.config.client_side_validation && timestamp.nil?
+        fail ArgumentError, "Missing the required parameter 'timestamp' when calling AuthenticationApi.v1_authentication_access_tokens_post"
+      end
+      # verify the required parameter 'message_signature' is set
+      if @api_client.config.client_side_validation && message_signature.nil?
+        fail ArgumentError, "Missing the required parameter 'message_signature' when calling AuthenticationApi.v1_authentication_access_tokens_post"
+      end
+      # resource path
+      local_var_path = "/v1/authentication/access-tokens"
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      # header_params[:'Content-Type'] = content_type
+      header_params[:'Client-Request-Id'] = client_request_id
+      header_params[:'Api-Key'] = api_key
+      header_params[:'Timestamp'] = timestamp
+      header_params[:'Message-Signature'] = message_signature
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      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 => 'AccessTokenResponse',
+        :error_type => 'ErrorResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AuthenticationApi#v1_authentication_access_tokens_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end