genesis_ruby 0.1.0

data/lib/genesis_ruby/api/constants/date_time_formats.rb

@@ -0,0 +1,45 @@
+module GenesisRuby
+  module Api
+    module Constants
+      # Date Time string representation formats
+      class DateTimeFormats
+
+        extend Mixins::Constants::Common
+
+        # Little endian(day, month, year) system with hyphens in between
+        DD_MM_YYYY_L_HYPHENS  = '%d-%m-%Y'.freeze
+
+        # Little endian(day, month, year) system with dots in between
+        DD_MM_YYYY_L_DOTS     = '%d.%m.%Y'.freeze
+
+        # Little endian(day, month, year) system with dots in between
+        DD_MM_YYYY_L_SLASHES  = '%d/%m/%Y'.freeze
+
+        # Zulu timestamp
+        YYYY_MM_DD_H_I_S_ZULU = '%Y-%m-%dT%H:%M:%S%z'.freeze
+
+        # Modified Zulu timestamp
+        YYYY_MM_DD_H_I_S      = '%Y-%m-%d %H:%M:%S'.freeze
+
+        # Date Format ISO 8601
+        YYYY_MM_DD_ISO_8601   = '%Y-%m-%d'.freeze
+
+        class << self
+
+          def all
+            [
+              DD_MM_YYYY_L_HYPHENS,
+              DD_MM_YYYY_L_DOTS,
+              DD_MM_YYYY_L_SLASHES,
+              YYYY_MM_DD_H_I_S_ZULU,
+              YYYY_MM_DD_H_I_S,
+              YYYY_MM_DD_ISO_8601 # Always keep it last!!!
+            ]
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/endpoints.rb

@@ -0,0 +1,18 @@
+module GenesisRuby
+  module Api
+    module Constants
+      # List of possible Genesis Endpoints
+      class Endpoints
+
+        # Domain for E-ComProcessing's Genesis instance
+        # http://www.e-comprocessing.com/
+        ECOMPROCESSING = 'e-comprocessing.net'.freeze
+
+        # Domain for emerchantpay's Genesis instance
+        # https://www.emerchantpay.com
+        EMERCHANTPAY   = 'emerchantpay.net'.freeze
+
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/environments.rb

@@ -0,0 +1,17 @@
+module GenesisRuby
+  module Api
+    module Constants
+      # List of server environments
+      class Environments
+
+        # Live (Production) environment
+        PRODUCTION = 'production'.freeze
+
+        # Staging/Test environment
+        # NO MONEY are being transferred
+        STAGING    = 'sandbox'.freeze
+
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/states/state.rb

@@ -0,0 +1,43 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module States
+        # Genesis Response Status definitions
+        class State
+
+          # Helper method for defining available dynamic methods
+          def self.handle_respond_to_states(symbol)
+            name = symbol.to_s.downcase
+
+            name.slice!('?') == '?' && GenesisRuby::Api::Constants::States.valid?(name)
+          end
+
+          attr_accessor :state
+
+          def initialize(state)
+            @state = state
+          end
+
+          # States dynamic methods. Must be valid Genesis Transaction State
+          # Ex. new?, approved?
+          def method_missing(symbol, *args)
+            name = symbol.to_s.upcase
+
+            super unless GenesisRuby::Api::Constants::States::State.handle_respond_to_states(name)
+
+            name.chomp! '?'
+
+            GenesisRuby::Api::Constants::States.valid?(name) &&
+              state == GenesisRuby::Api::Constants::States.const_get(name)
+          end
+
+          # Respond to missing implementation
+          def respond_to_missing?(symbol, include_private = false)
+            GenesisRuby::Api::Constants::States::State.handle_respond_to_states(symbol) || super
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/states.rb

@@ -0,0 +1,86 @@
+module GenesisRuby
+  module Api
+    module Constants
+      # Genesis Response States
+      module States
+
+        extend Mixins::Constants::Common
+
+        # Transaction was approved by the schemes and is successful.
+        APPROVED            = 'approved'.freeze
+
+        # Transaction was declined by the schemes or risk management.
+        DECLINED            = 'declined'.freeze
+
+        # The outcome of the transaction could not be determined, e.g. at a timeout situation.
+        # Transaction state will eventually change, so make a reconcile after a certain time frame.
+        PENDING             = 'pending'.freeze
+
+        # An asynchronous transaction (3-D secure payment) has been initiated and is waiting for user
+        # input.
+        # Updates of this state will be sent to the notification url specified in request.
+        PENDING_ASYNC       = 'pending_async'.freeze
+
+        # Transaction is in-progress
+        IN_PROGRESS         = 'in_progress'.freeze
+
+        # Once an approved transaction is refunded the state changes to refunded.
+        REFUNDED            = 'refunded'.freeze
+
+        # Transaction was authorized, but later the merchant canceled it.
+        VOIDED              = 'voided'.freeze
+
+        # An error has occurred while negotiating with the schemes.
+        ERROR               = 'error'.freeze
+
+        # Transaction failed, but it was not declined
+        UNSUCCESSFUL        = 'unsuccessful'.freeze
+
+        # WPF initial status
+        NEW                 = 'new'.freeze
+
+        # WPF in-progress status
+        USER                = 'user'.freeze
+
+        # WPF timeout has occurred
+        TIMEOUT             = 'timeout'.freeze
+
+        # Once an approved transaction is chargeback the state changes to change- backed.
+        #
+        # Chargeback is the state of rejecting an accepted transaction (with funds transferred)
+        # by the cardholder or the issuer
+        CHARGEBACKED        = 'chargebacked'.freeze
+
+        # Once a chargebacked transaction is charged, the state changes to charge- back reversed.
+        #
+        # Chargeback has been canceled.
+        CHARGEBACK_REVERSED = 'chargeback_reversed'.freeze
+
+        # Once a chargeback reversed transaction is chargebacked the state changes to pre arbitrated.
+        PRE_ARBITRATED      = 'pre_arbitrated'.freeze
+
+        # Status of the consumer from Consumer API
+        ENABLED             = 'enabled'.freeze
+
+        # Status of the consumer from Consumer API
+        DISABLED            = 'disabled'.freeze
+
+        # Transaction API success status
+        SUCCESS             = 'success'.freeze
+
+        # WPF status represent submitted form
+        SUBMITTED           = 'submitted'.freeze
+
+        # An asynchronous transaction has been finalized by user but is waiting final update from provider.
+        PENDING_HOLD        = 'pending_hold'.freeze
+
+        # Once a chargeback_reversed/represented transaction is chargebacked the state changes to second chargebacked.
+        SECOND_CHARGEBACKED = 'second_chargebacked'.freeze
+
+        # Once a chargebacked transaction is charged, the state changes to represented. Chargeback has been canceled.
+        REPRESENTED         = 'represented'.freeze
+
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/business/payment_types.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Business
+            # Business Attributes Payment Types
+            class PaymentTypes
+
+              extend Mixins::Constants::Common
+
+              # Deposit
+              DEPOSIT = 'deposit'.freeze
+
+              # Balance
+              BALANCE = 'balance'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/recurring/categories.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Recurring
+            # Recurring Categories
+            class Categories
+
+              extend Mixins::Constants::Common
+
+              # Recurring Category Subscription - fixed amount, fixed intervals
+              SUBSCRIPTION   = 'subscription'.freeze
+
+              # Recurring Category Standing Order - varying amount, fixed intervals
+              STANDING_ORDER = 'standing_order'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/recurring/types.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Recurring
+            # Recurring Types
+            class Types
+
+              extend Mixins::Constants::Common
+
+              # Indication for an Initial Recurring Transaction. Respond to Init_Recurring
+              INITIAL    = 'initial'.freeze
+
+              # Indication for a Managed Recurring Transaction. Respond to Managed Recurring transactions.
+              MANAGED    = 'managed'.freeze
+
+              # Indication for a Subsequent Transaction on the Initial Recurring.
+              # Respond to subsequent Recurring payments.
+              SUBSEQUENT = 'subsequent'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/sca_exemptions.rb

@@ -0,0 +1,34 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          # SCA Exemptions
+          class ScaExemptions
+
+            extend Mixins::Constants::Common
+
+            # Exemption Low Value
+            LOW_VALUE                = 'low_value'.freeze
+
+            # Exemption Low Risk
+            LOW_RISK                 = 'low_risk'.freeze
+
+            # Exemption Trusted Merchant
+            TRUSTED_MERCHANT         = 'trusted_merchant'.freeze
+
+            # Exemption Corporate Payment
+            CORPORATE_PAYMENT        = 'corporate_payment'.freeze
+
+            # Exemption Delegated Authentication
+            DELEGATED_AUTHENTICATION = 'delegated_authentication'.freeze
+
+            # Exemption Auth Network Outage
+            AUTH_NETWORK_OUTAGE      = 'auth_network_outage'.freeze
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/browser/color_depths.rb

@@ -0,0 +1,46 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module Browser
+                # Threeds Version2 Browser ColorDepths
+                class ColorDepths
+
+                  extend Mixins::Constants::Common
+
+                  # Color Depth 1
+                  BIT_1  = 1
+
+                  # Color Depth 4
+                  BITS_4  = 4
+
+                  # Color Depth 8
+                  BITS_8  = 8
+
+                  # Color Depth 15
+                  BITS_15 = 15
+
+                  # Color Depth 16
+                  BITS_16 = 16
+
+                  # Color Depth 24
+                  BITS_24 = 24
+
+                  # Color Depth 32
+                  BITS_32 = 32
+
+                  # Color Depth 48
+                  BITS_48 = 48
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/card_holder_account/password_change_indicators.rb

@@ -0,0 +1,37 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module CardHolderAccount
+                # Threeds Version2 Card Holder Account Password Change Indicators
+                class PasswordChangeIndicators
+
+                  extend Mixins::Constants::Common
+
+                  #  No change
+                  NO_CHANGE          = 'no_change'.freeze
+
+                  #  During Transaction
+                  DURING_TRANSACTION = 'during_transaction'.freeze
+
+                  #  Less than 30 days
+                  LESS_THAN_30DAYS   = 'less_than_30days'.freeze
+
+                  #  From 30 to 60 days
+                  FROM_30_TO_60_DAYS = '30_to_60_days'.freeze
+
+                  #  More than 60 days
+                  MORE_THAN_60DAYS   = 'more_than_60days'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/card_holder_account/registration_indicators.rb

@@ -0,0 +1,37 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module CardHolderAccount
+                # Threeds Version2 Card Holder Account Registration Indicators
+                class RegistrationIndicators
+
+                  extend Mixins::Constants::Common
+
+                  # Guest Checkout
+                  GUEST_CHECKOUT      = 'guest_checkout'.freeze
+
+                  # Current Transaction
+                  CURRENT_TRANSACTION = 'current_transaction'.freeze
+
+                  # Less than 30 days
+                  LESS_THAN_30DAYS    = 'less_than_30days'.freeze
+
+                  # From 30 to 60 days
+                  FROM_30_TO_60_DAYS  = '30_to_60_days'.freeze
+
+                  # More than 60 days
+                  MORE_THAN_60DAYS    = 'more_than_60days'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/card_holder_account/shipping_address_usage_indicators.rb

@@ -0,0 +1,34 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module CardHolderAccount
+                # Threeds Version2 Card Holder Shipping Address Usage Indicators
+                class ShippingAddressUsageIndicators
+
+                  extend Mixins::Constants::Common
+
+                  # Current Transaction
+                  CURRENT_TRANSACTION = 'current_transaction'.freeze
+
+                  # Less than 30 days
+                  LESS_THAN_30DAYS    = 'less_than_30days'.freeze
+
+                  # From 30 to 60 days
+                  FROM_30_TO_60_DAYS  = '30_to_60_days'.freeze
+
+                  # More than 60 days
+                  MORE_THAN_60DAYS    = 'more_than_60days'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/card_holder_account/suspicious_activity_indicators.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module CardHolderAccount
+                # Threeds Version2 Card Holder Shipping Address Usage Indicators
+                class SuspiciousActivityIndicators
+
+                  extend Mixins::Constants::Common
+
+                  # No Suspicious Observed
+                  NO_SUSPICIOUS_OBSERVED = 'no_suspicious_observed'.freeze
+
+                  # Suspicious Observed
+                  SUSPICIOUS_OBSERVED    = 'suspicious_observed'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/card_holder_account/update_indicators.rb

@@ -0,0 +1,34 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module CardHolderAccount
+                # Threeds Version2 Card Holder Update Indicators
+                class UpdateIndicators
+
+                  extend Mixins::Constants::Common
+
+                  # Current Transaction
+                  CURRENT_TRANSACTION = 'current_transaction'.freeze
+
+                  # Less than 30 days
+                  LESS_THAN_30DAYS    = 'less_than_30days'.freeze
+
+                  # From 30 to 60 days
+                  FROM_30_TO_60_DAYS  = '30_to_60_days'.freeze
+
+                  # More than 60 days
+                  MORE_THAN_60DAYS    = 'more_than_60days'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/control/challenge_indicators.rb

@@ -0,0 +1,34 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module Control
+                # Threeds Version2 Control Challenge Indicators
+                class ChallengeIndicators
+
+                  extend Mixins::Constants::Common
+
+                  # Don't have any preferences related to the Challenge flow (default)
+                  NO_PREFERENCE          = 'no_preference'.freeze
+
+                  # I prefer that a Challenge flow does not take place
+                  NO_CHALLENGE_REQUESTED = 'no_challenge_requested'.freeze
+
+                  # A request for the Challenge flow to take place
+                  PREFERENCE             = 'preference'.freeze
+
+                  # A Challenge flow must take place to fulfill a mandate
+                  MANDATE                = 'mandate'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/control/challenge_window_sizes.rb

@@ -0,0 +1,37 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module Control
+                # Threeds Version2 Control Challenge Window Sizes
+                class ChallengeWindowSizes
+
+                  extend Mixins::Constants::Common
+
+                  # Challenge Window Size 250x400
+                  SIZE_250X400 = '250x400'.freeze
+
+                  # Challenge Window Size 390x400
+                  SIZE_390X400 = '390x400'.freeze
+
+                  # Challenge Window Size 500x600
+                  SIZE_500X600 = '500x600'.freeze
+
+                  # Challenge Window Size 600x400
+                  SIZE_600X400 = '600x400'.freeze
+
+                  # Challenge Window Size Full Screen
+                  FULLSCREEN   = 'full_screen'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/control/device_types.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module Control
+                # Threeds Version2 Control Device Types
+                class DeviceTypes
+
+                  extend Mixins::Constants::Common
+
+                  # Browser-based consumer interface. All the browser parameters are required.
+                  BROWSER     = 'browser'.freeze
+
+                  # Application
+                  APPLICATION = 'application'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/merchant_risk/delivery_timeframes.rb

@@ -0,0 +1,34 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Threeds
+            module Version2
+              module MerchantRisk
+                # Threeds Version2 Merchant Risk Delivery Timeframes
+                class DeliveryTimeframes
+
+                  extend Mixins::Constants::Common
+
+                  # Electronics
+                  ELECTRONICS = 'electronic'.freeze
+
+                  # Same Day
+                  SAME_DAY    = 'same_day'.freeze
+
+                  # Over Night
+                  OVER_NIGHT  = 'over_night'.freeze
+
+                  # Another Day
+                  ANOTHER_DAY = 'another_day'.freeze
+
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end