genesis_ruby 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c16e207efd1721cd293a6749709104f57410f684e5bbb3d0b3378001cdfe5d19
-  data.tar.gz: 495b1333514eecfc206cac7ae713b9593fdd886233ef840be3af610f499f80c8
+  metadata.gz: 5629a8aa5e0635fa0106507b7ca62e605065007441fff2479c1ec390237d8382
+  data.tar.gz: c618d130f46775abfeda2cc340050c6cdb5492fcd97ba64a2bc0bafac5db086b
 SHA512:
-  metadata.gz: 58dba79785a36d57714cf28f6b56878cbf2c8a748584bf7c5e0a4440775c77b39db44eb0a3cf645b399aef81ca3e84967ea05be8e513014b7498ae61a078eec4
-  data.tar.gz: 8fea90819598e5f3830de518c4a044fbbf2f7c83dc96f56fe1b1b9c2479a157f095fe5ec1cc8b9fddc4de51a80bbaad0167fe9c84df77f5b0e79652fcf6bc5f6
+  metadata.gz: 592d0e476d4e7a0bb1920eef3c807ff420adb6c35e3bd32a6ad1bef6e7582ddc90d4b1b4d7d1998d9873865af22ded0c7bcacc2950331234705f1658a61a71f9
+  data.tar.gz: c3d712b3f128740ce84d32bad8302e030fc2826cb0f0b06cfaec1e26e2e96efe0ef2f271e6afe869b72b9db823f0724644dab4b3b30a1e6240008cc740617a8a

data/CHANGELOG.md

@@ -1,3 +1,31 @@
+0.1.7
+-----
+**Features**:
+
+* Removed GiroPay transaction type support through the Web Payment Form
+* Added Protocol Sub Version parameter support part of the MPI attributes
+* Added Level 3 Travel Data attributes support to the following transaction requests:
+  * Sale
+  * Sale 3D
+  * Authorize
+  * Authorize 3D
+  * Init Recurring Sale
+  * Init Recurring Sale 3D
+  * RecurringSale
+  * Capture
+
+0.1.6
+-----
+**Features**:
+
+* Added Web Payment Form `lifetime` validations with a maximum allowed value of 3 months in minutes (131487)
+* Added Web Payment Form `lifetime` default value of 30 minutes
+* Added Web Payment Form Reminders support
+* Added Pay Later parameter support to the Web Payment Form
+  * Reminders will be sent to the Gateway only when `pay_later=true`
+* Added Reminder Language parameter support to the Web Payment Form. It accepts only available WPF locales.
+* Added validation for Web Payment Form `locale` attribute. It accepts only available WPF locales.
+
 0.1.5
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.1.5)
+    genesis_ruby (0.1.7)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 
@@ -12,7 +12,7 @@ GEM
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     base64 (0.2.0)
-    bigdecimal (3.1.6)
+    bigdecimal (3.1.7)
     concurrent-ruby (1.2.3)
     crack (1.0.0)
       bigdecimal
@@ -34,19 +34,17 @@ GEM
     httparty (0.21.0)
       mini_mime (>= 1.0.0)
       multi_xml (>= 0.5.2)
-    i18n (1.14.1)
+    i18n (1.14.4)
       concurrent-ruby (~> 1.0)
     json (2.7.1)
     language_server-protocol (3.17.0.3)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.5)
     multi_xml (0.6.0)
     mustermann (3.0.0)
       ruby2_keywords (~> 0.0.1)
     net-http (0.3.2)
       uri
-    nokogiri (1.15.5)
-      mini_portile2 (~> 2.8.2)
+    nokogiri (1.16.6-x86_64-darwin)
       racc (~> 1.4)
     octokit (7.2.0)
       faraday (>= 1, < 3)
@@ -68,7 +66,7 @@ GEM
       rubocop (>= 0.63.1, < 2.0)
     public_suffix (5.0.4)
     racc (1.7.3)
-    rack (2.2.8.1)
+    rack (2.2.9)
     rack-protection (3.2.0)
       base64 (>= 0.1.0)
       rack (~> 2.2, >= 2.2.4)
@@ -91,7 +89,7 @@ GEM
     rspec-support (3.13.1)
     rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (1.61.0)
+    rubocop (1.62.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
@@ -99,10 +97,10 @@ GEM
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.1)
+    rubocop-ast (1.31.2)
       parser (>= 3.3.0.4)
     rubocop-capybara (2.20.0)
       rubocop (~> 1.41)
@@ -111,7 +109,7 @@ GEM
     rubocop-faker (1.1.0)
       faker (>= 2.12.0)
       rubocop (>= 0.82.0)
-    rubocop-rspec (2.27.0)
+    rubocop-rspec (2.27.1)
       rubocop (~> 1.40)
       rubocop-capybara (~> 2.17)
       rubocop-factory_bot (~> 2.22)

data/README.md

@@ -1,11 +1,13 @@
 
-# Genesis Ruby
-
+Genesis Ruby
+========
+[![Gem Version](https://badge.fury.io/rb/genesis_ruby.svg)](https://badge.fury.io/rb/genesis_ruby)
 [![Software License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](LICENSE)
 
 Ruby Client for Genesis Payment Processing Gateway
 
-## Overview
+Overview
+--------
 
 Client Library for processing payments through Genesis Payment Processing Gateway. Its highly recommended to checkout "Genesis Payment Gateway API Documentation" first, in order to get an overview of Genesis's Payment Gateway API and functionality.
 
@@ -98,6 +100,11 @@ begin
     # Other
     request.lifetime            = 30
     request.web_payment_form_id = '987654321'
+
+    # Reminders
+    request.pay_later           = true
+    request.add_reminder channel: 'email', after: 10
+    request.add_reminder channel: 'sms', after: 30
   end.execute
   
   puts genesis.response.response_object
@@ -480,6 +487,89 @@ request.recurring_type = GenesisRuby::Api::Constants::Transactions::Parameters::
   ```
   </details>
 
+#### Level 3 Travel Data
+Level 3 travel data is supplied as optional data to the standard API request. If the supplied is valid travel data then the transaction will be processed as a travel transaction and will qualify for the travel Incentive rates. Otherwise the transaction will be processed normally as a regular transaction. Note that the travel data will be stored as part of the transaction in all cases.
+
+<details>
+<summary>Example Leg Data</summary>
+
+```ruby
+GenesisRuby::Utils::Transactions::TravelData::AirlineItinerary::Leg.new departure_date:         '2034-12-31',
+                                                                        arrival_date:           '2034-12-31',
+                                                                        carrier_code:           12,
+                                                                        service_class:          1,
+                                                                        origin_city:            'VAR',
+                                                                        destination_city:       'FRA',
+                                                                        stopover_code:          0,
+                                                                        fare_basis_code:        1,
+                                                                        flight_number:          'W1234',
+                                                                        departure_time:         '11:37',
+                                                                        departure_time_segment: 'P'
+```
+
+</details>
+
+<details>
+<summary>Example Tax Data</summary>
+
+```ruby
+GenesisRuby::Utils::Transactions::TravelData::AirlineItinerary::Tax.new fee_type: 'type', 
+                                                                        fee_amount: 0.99 # will converted automatically to minor format based on the currency
+```
+
+</details>
+
+<details>
+<summary>Example Level 3 Travel Data</summary>
+
+```ruby
+# Ticket attributes
+request.travel_aid_ticket_number               = '123456789012345'
+request.travel_aid_passenger_name              = 'Test Example'
+request.travel_aid_customer_code               = 1
+request.travel_aid_issuing_carrier             = 'AAAA'
+request.travel_aid_total_fare                  = '0.99' # will converted automatically to minor format based on the currency
+request.travel_aid_agency_name                 = 'Agency'
+request.travel_aid_agency_code                 = 'AG001'
+request.travel_aid_date_of_issue               = '2018-02-01'
+request.travel_aid_restricted_ticket_indicator = 1
+request.travel_aid_confirmation_information    = 'Confirmation'
+
+request.add_travel_aid_leg leg
+request.add_travel_aid_tax tax
+
+# Car rental
+request.travel_car_rental_purchase_identifier       = '12478'
+request.travel_car_rental_class_id                  = 3
+request.travel_car_rental_pickup_date               = '2034-12-31'
+request.travel_car_rental_renter_name               = 'John Smith'
+request.travel_car_rental_return_city               = 'Varna'
+request.travel_car_rental_return_state              = 'VAR'
+request.travel_car_rental_return_country            = 'BGR'
+request.travel_car_rental_return_date               = '2034-12-31'
+request.travel_car_rental_renter_return_location_id = '12478'
+request.travel_car_rental_customer_code             = 1
+request.travel_car_rental_extra_charges             = 2
+request.travel_car_rental_no_show_indicator         = 1
+
+# Hotel Rental attributes
+request.travel_hotel_rental_purchase_identifier = '12478'
+request.travel_hotel_rental_arrival_date        = '2034-12-31'
+request.travel_hotel_rental_departure_date      = '2034-12-31'
+request.travel_hotel_rental_customer_code       = '12478'
+request.travel_hotel_rental_no_show_indicator   = 1
+
+# Reference Ticket Attributes
+request.travel_ac_ticket_reference_id       = '8b7e3575e5605ea7e1895707a3e92837'
+request.travel_ac_ticket_document_number    = '1111'
+request.travel_ac_issued_with_ticket_number = '12321'
+
+# Ancillary Charges
+request.travel_ac_type     = 'BF'
+request.travel_ac_sub_type = 'BG'
+```
+
+</details>
 
 ## Response
 

data/VERSION

@@ -1 +1 @@
-0.1.5
+0.1.7

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

@@ -0,0 +1,90 @@
+module GenesisRuby
+  module Api
+    module Constants
+      # WPF localization constants
+      class I18n
+
+        extend Mixins::Constants::Common
+
+        # Arabic
+        AR = 'ar'.freeze
+
+        # Bulgarian
+        BG = 'bg'.freeze
+
+        # German
+        DE = 'de'.freeze
+
+        # English
+        EN = 'en'.freeze
+
+        # Spanish
+        ES = 'es'.freeze
+
+        # French
+        FR = 'fr'.freeze
+
+        # Hindu
+        HI = 'hi'.freeze
+
+        # Japanese
+        JA = 'ja'.freeze
+
+        # Icelandic
+        IS = 'is'.freeze
+
+        # Italian
+        IT = 'it'.freeze
+
+        # Dutch
+        NL = 'nl'.freeze
+
+        # Portuguese
+        PT = 'pt'.freeze
+
+        # Polish
+        PL = 'pl'.freeze
+
+        # Russian
+        RU = 'ru'.freeze
+
+        # Turkish
+        TR = 'tr'.freeze
+
+        # Mandarin Chinese
+        ZH = 'zh'.freeze
+
+        # Indonesian
+        ID = 'id'.freeze
+
+        # Malay
+        MS = 'ms'.freeze
+
+        # Thai
+        TH = 'th'.freeze
+
+        # Czech
+        CS = 'cs'.freeze
+
+        # Croatian
+        HR = 'hr'.freeze
+
+        # Slovenian
+        SL = 'sl'.freeze
+
+        # Finnish
+        FI = 'fi'.freeze
+
+        # Norwegian
+        NO = 'no'.freeze
+
+        # Danish
+        DA = 'da'.freeze
+
+        # Swedish
+        SV = 'sv'.freeze
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,43 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          # Mpi Protocol Versions allowed values
+          class MpiProtocolSubVersions
+
+            extend Mixins::Constants::Common
+
+            # Sub-protocol Version 1
+            PROTOCOL_SUB_VERSION_1 = 1
+
+            # Sub-protocol Version 2
+            PROTOCOL_SUB_VERSION_2 = 2
+
+            # Sub-protocol Version 3
+            PROTOCOL_SUB_VERSION_3 = 3
+
+            # Sub-protocol Version 4
+            PROTOCOL_SUB_VERSION_4 = 4
+
+            # Sub-protocol Version 5
+            PROTOCOL_SUB_VERSION_5 = 5
+
+            # Sub-protocol Version 6
+            PROTOCOL_SUB_VERSION_6 = 6
+
+            # Sub-protocol Version 7
+            PROTOCOL_SUB_VERSION_7 = 7
+
+            # Sub-protocol Version 8
+            PROTOCOL_SUB_VERSION_8 = 8
+
+            # Sub-protocol Version 9
+            PROTOCOL_SUB_VERSION_9 = 9
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/travel_data/ancillary_charges_types.rb

@@ -0,0 +1,43 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module TravelData
+            # Ancillary Charges Types
+            # Identify the Service Category Code for the primary type of service that has been provided
+            class AncillaryChargesTypes
+
+              extend Mixins::Constants::Common
+
+              BF = 'BF'.freeze
+              BG = 'BG'.freeze
+              CF = 'CF'.freeze
+              CG = 'CG'.freeze
+              CO = 'CO'.freeze
+              FF = 'FF'.freeze
+              GF = 'GF'.freeze
+              GT = 'GT'.freeze
+              IE = 'IE'.freeze
+              LG = 'LG'.freeze
+              MD = 'MD'.freeze
+              ML = 'ML'.freeze
+              OT = 'OT'.freeze
+              PA = 'PA'.freeze
+              PT = 'PT'.freeze
+              SA = 'SA'.freeze
+              SB = 'SB'.freeze
+              SF = 'SF'.freeze
+              ST = 'ST'.freeze
+              TS = 'TS'.freeze
+              UN = 'UN'.freeze
+              UP = 'UP'.freeze
+              WI = 'WI'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/wpf/reminder_channels.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Wpf
+            # Channel for sending WPF reminder. Valid values are ’email’ and ’sms’
+            class ReminderChannels
+
+              extend Mixins::Constants::Common
+
+              # Channel email
+              EMAIL = 'email'.freeze
+
+              # Channel sms
+              SMS   = 'sms'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -115,10 +115,6 @@ module GenesisRuby
         # They can also be refunded.
         FASHIONCHEQUE = 'fashioncheque'.freeze
 
-        # GiroPay
-        # Direct PPRO transaction
-        GIROPAY = 'giropay'.freeze
-
         # Google Pay allows shoppers to purchase with credit and debit cards linked to their Google account.
         GOOGLE_PAY = 'google_pay'.freeze
 
@@ -260,7 +256,7 @@ module GenesisRuby
         # PostFinance is an online banking provider in Switzerland
         POST_FINANCE = 'post_finance'.freeze
 
-        # Supports payments via EPS, SafetyPay, TrustPay, ELV, Przelewy24, and GiroPay
+        # Supports payments via EPS, SafetyPay, TrustPay, ELV, Przelewy24
         PPRO = 'ppro'.freeze
 
         # PSE (Pagos Seguros en Linea) is the preferred alternative payment solution in Colombia.

data/lib/genesis_ruby/api/mixins/requests/financial/cards/mpi_attributes.rb

@@ -1,4 +1,5 @@
 require 'genesis_ruby/api/constants/transactions/parameters/mpi_protocol_versions'
+require 'genesis_ruby/api/constants/transactions/parameters/mpi_protocol_sub_versions'
 
 module GenesisRuby
   module Api
@@ -9,9 +10,8 @@ module GenesisRuby
             # Mixin Mpi Attributes
             module MpiAttributes
 
-              attr_reader :mpi_threeds_challenge_indicator, :mpi_protocol_version
-              attr_accessor :mpi_cavv, :mpi_eci, :mpi_xid, :mpi_directory_server_id,
-                            :mpi_asc_transaction_id
+              attr_reader :mpi_threeds_challenge_indicator, :mpi_protocol_version, :mpi_protocol_sub_version
+              attr_accessor :mpi_cavv, :mpi_eci, :mpi_xid, :mpi_directory_server_id, :mpi_asc_transaction_id
 
               # The used 3DS protocol version. Default is 1 if not supplied.
               def mpi_protocol_version=(value)
@@ -31,6 +31,15 @@ module GenesisRuby
                 allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
               end
 
+              # The used 3DSv2 authentication protocol.
+              def mpi_protocol_sub_version=(value)
+                allowed_options attribute:   __method__,
+                                allowed:     GenesisRuby::Api::Constants::Transactions::Parameters::
+                                    MpiProtocolSubVersions.all,
+                                value:       value.to_i,
+                                allow_empty: true
+              end
+
               protected
 
               # Mpi Attributes Structure
@@ -41,7 +50,8 @@ module GenesisRuby
                   protocol_version:            mpi_protocol_version,
                   directory_server_id:         mpi_directory_server_id,
                   acs_transaction_id:          mpi_asc_transaction_id,
-                  threeds_challenge_indicator: mpi_threeds_challenge_indicator
+                  threeds_challenge_indicator: mpi_threeds_challenge_indicator,
+                  protocol_sub_version:        mpi_protocol_sub_version
                 }
               end
 

data/lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/managed_recurring_attributes.rb

@@ -1,3 +1,5 @@
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/modes'
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/intervals'
 require 'genesis_ruby/api/mixins/requests/financial/cards/recurring/managed_recurring_indian_card_attributes'
 
 module GenesisRuby

data/lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/managed_recurring_indian_card_attributes.rb

@@ -1,3 +1,7 @@
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/payment_types'
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/amount_types'
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/frequencies'
+
 module GenesisRuby
   module Api
     module Mixins