genesis_ruby 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88fa7a15b9a49833d8de193195478d25730cd08832a9f1c77a9e8029bead7fe7
-  data.tar.gz: 17a9e30b42dc026cd920e7be4d5983b0631baad23655bf2703b28b92c7f61d04
+  metadata.gz: b8cc160e0cdb5cb22dd4726e2471a9d85ba199c4ee2bdd2e8cbd57b057657ce8
+  data.tar.gz: 824dc704419375ffd6276a45d757f1b45e40f6e5d542462d73b18c207392df9e
 SHA512:
-  metadata.gz: 1c7ea66d38e6ce58bf8a9560ade34eff61013a580e2af31f96164482891738874a70c3d481fcf4ab19158b5105003df849e6f145c1dbf1e1d46ddb405fd48134
-  data.tar.gz: 836820c824e0eb854e9b7c22eb95cfdfcdf990f4f8c0362a77ff6935e28c7fbbaeb81dd046a11e66661018797d77c8ade7e01d19a1ac0d2e664a16c955789b29
+  metadata.gz: 4cd6c2db4ec7da458a87d82ad550af947585fea23158117d5458f324aa966db882601fba8490357a349ae551c528825bf6d1e52381e3e3d06c24746a25af3ef3
+  data.tar.gz: 253fe2aaaec0df2023a6a2d37c74b04dd12eba99da1d376ff01f5566084449dbdbd3d4fe33560eb6d68e7ba98119baf33caa235879ffad9af743c2dc392ebd66

data/CHANGELOG.md

@@ -1,3 +1,30 @@
+0.1.2
+-----
+**Features**:
+
+* Added 3D Secure Method Continue API request support
+* Updated Gateway response handling upon error cases like 3D Secure Method Continue with invalid identifier a Network error will be raised
+* Added `GenesisRuby::Api::Notification` handler that provides an easy way of handling Gateway instant payment notifications
+
+0.1.1
+-----
+**Features**:
+
+* Added request support for the following transaction reference actions:
+  * Capture
+  * Void
+  * Refund
+* Added support for the following Reconcile API requests:
+  * Transaction
+  * By Date Range
+  * Web Payment Form Reconcile
+* Added Documentation URI to the project metadata description
+
+**Fixes**:
+
+* Fixed response parser handling with attributes inside the root element
+* Fixed Changelog URI in the project metadata description
+
 0.1.0
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.1.0)
+    genesis_ruby (0.1.2)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 
@@ -11,14 +11,14 @@ GEM
     addressable (2.8.5)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
-    base64 (0.1.1)
+    base64 (0.2.0)
     concurrent-ruby (1.2.2)
     crack (0.4.5)
       rexml
     diff-lcs (1.5.0)
     faker (2.23.0)
       i18n (>= 1.8.11, < 2)
-    faraday (2.7.11)
+    faraday (2.7.12)
       base64
       faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
@@ -37,26 +37,26 @@ GEM
     json (2.6.3)
     language_server-protocol (3.17.0.3)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.4)
+    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.4)
+    nokogiri (1.15.5)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    octokit (6.1.1)
+    octokit (7.2.0)
       faraday (>= 1, < 3)
       sawyer (~> 0.9)
     parallel (1.23.0)
-    parser (3.2.2.3)
+    parser (3.2.2.4)
       ast (~> 2.4.1)
       racc
-    pronto (0.11.1)
+    pronto (0.11.2)
       gitlab (>= 4.4.0, < 5.0)
       httparty (>= 0.13.7, < 1.0)
-      octokit (>= 4.7.0, < 7.0)
+      octokit (>= 4.7.0, < 8.0)
       rainbow (>= 2.2, < 4.0)
       rexml (>= 3.2.5, < 4.0)
       rugged (>= 0.23.0, < 2.0)
@@ -64,14 +64,14 @@ GEM
     pronto-rubocop (0.11.5)
       pronto (~> 0.11.0)
       rubocop (>= 0.63.1, < 2.0)
-    public_suffix (5.0.3)
-    racc (1.7.1)
+    public_suffix (5.0.4)
+    racc (1.7.3)
     rack (2.2.8)
     rack-protection (3.1.0)
       rack (~> 2.2, >= 2.2.4)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.8.1)
+    rake (13.1.0)
+    regexp_parser (2.8.2)
     rexml (3.2.6)
     rspec (3.12.0)
       rspec-core (~> 3.12.0)
@@ -86,29 +86,28 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.1)
-    rubocop (1.56.3)
-      base64 (~> 0.1.1)
+    rubocop (1.57.2)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.2.2.3)
+      parser (>= 3.2.2.4)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
       rubocop-ast (>= 1.28.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.29.0)
+    rubocop-ast (1.30.0)
       parser (>= 3.2.1.0)
-    rubocop-capybara (2.18.0)
+    rubocop-capybara (2.19.0)
       rubocop (~> 1.41)
-    rubocop-factory_bot (2.23.1)
+    rubocop-factory_bot (2.24.0)
       rubocop (~> 1.33)
     rubocop-faker (1.1.0)
       faker (>= 2.12.0)
       rubocop (>= 0.82.0)
-    rubocop-rspec (2.24.0)
-      rubocop (~> 1.33)
+    rubocop-rspec (2.25.0)
+      rubocop (~> 1.40)
       rubocop-capybara (~> 2.17)
       rubocop-factory_bot (~> 2.22)
     ruby-progressbar (1.13.0)
@@ -124,10 +123,10 @@ GEM
       tilt (~> 2.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
-    thor (1.2.2)
+    thor (1.3.0)
     tilt (2.3.0)
-    unicode-display_width (2.4.2)
-    uri (0.12.2)
+    unicode-display_width (2.5.0)
+    uri (0.13.0)
     webmock (3.19.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
@@ -140,7 +139,7 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  bundler
+  bundler (~> 2.1)
   faker (~> 2.22)
   faraday-retry (~> 2.0)
   genesis_ruby!

data/README.md

@@ -12,6 +12,8 @@ Client Library for processing payments through Genesis Payment Processing Gatewa
 ## Requirements
 
 * Ruby version 2.7 or newer
+* [net-http](https://rubygems.org/gems/net-http) 0.3.2 or newer
+* [nokogiri](https://rubygems.org/gems/nokogiri) 1.14 or newer
 
 ## Installation
 
@@ -103,6 +105,8 @@ rescue GenesisRuby::Error => error
 end
 ```
 
+A full list of the Transaction Types and Custom Attributes can be found [here](https://emerchantpay.github.io/gateway-api-docs/?shell#wpf-transaction-types).
+
 ### Transactions
 
 ```ruby
@@ -142,7 +146,280 @@ rescue GenesisRuby::Error => error
 end
 ```
 
-A full list of the Transaction Types and Custom Attributes can be found [here](https://emerchantpay.github.io/gateway-api-docs/?shell#wpf-transaction-types).
+### Example 3DSv2 Request
+
+Sample request including all the conditionally required/optional params for initiating a 3DS transaction with the 3DSv2-Method authentication protocol.
+
+Also, an example is provided for the 3DS-Method-continue API call that will have to be submitted after the 3DS-Method is initiated.
+<details>
+
+```ruby
+require 'genesis_ruby'
+
+begin
+  genesis_3ds_v2 = GenesisRuby::Genesis.for(config: configuration, request: GenesisRuby::Api::Requests::Financial::Cards::Sale3d) do |request|
+    # Common Attributes
+    request.transaction_id     = '12345-67890'
+    request.remote_ip          = '127.0.0.1'
+    request.amount             = '0.99'
+    request.currency           = 'EUR'
+    request.usage              = 'Example usage'
+    request.customer_email     = 'travis@example.com'
+    request.customer_phone     = '+1987987987987'
+
+    # Credit Card Attributes
+    request.card_holder      = 'Travis Pastrana'
+
+    # Test Cases
+    request.card_number = '4012000000060085' # Test Case: Synchronous 3DSv2 Request with Frictionless flow
+    # request.card_number = '4066330000000004' # Test Case: Asynchronous 3DSv2 Request with 3DS-Method and Frictionless flow
+    # request.card_number = '4918190000000002' # Test Case: Asynchronous 3DSv2 Request with Challenge flow
+    # request.card_number = '4938730000000001' # Test Case: Asynchronous 3DSv2 Request with 3DS-Method Challenge flow
+    # request.card_number = '4901170000000003' # Test Case: Asynchronous 3DSv2 Request with Fallback flow
+    # request.card_number = '4901164281364345' # Test Case: Asynchronous 3DSv2 Request with 3DS-Method Fallback flow
+
+    request.expiration_month = '12'
+    request.expiration_year  = '2040'
+    request.cvv              = '123'
+
+    # Async Attributes
+    request.notification_url   = 'https://example.com/notification'
+    request.return_success_url = 'https://example.com/success'
+    request.return_failure_url = 'https://example.com/failure'
+
+    # Billing Attributes
+    request.billing_first_name = 'Travis'
+    request.billing_last_name  = 'Pastrana'
+    request.billing_address1   = 'Kreisfreie Stadt Berlin'
+    request.billing_zip_code   = '10115'
+    request.billing_city       = 'Berlin'
+    request.billing_country    = 'DE'
+
+    # Threeds V2 Attributes
+
+    ## Method Attributes
+    request.threeds_v2_method_callback_url = 'https://www.example.com/threeds/threeds_method/callback'
+
+    ## Control Attributes
+    request.threeds_v2_control_device_type           =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Control::DeviceTypes::BROWSER
+    request.threeds_v2_control_challenge_window_size =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Control::ChallengeWindowSizes::FULLSCREEN
+    request.threeds_v2_control_challenge_indicator   =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Control::ChallengeIndicators::MANDATE
+
+    ## Browser Attributes
+    ## When Control Device Type is Browser
+    request.threeds_v2_browser_accept_header    = '*/*'
+    request.threeds_v2_browser_java_enabled     = true
+    request.threeds_v2_browser_language         = 'en-GB'
+    request.threeds_v2_browser_color_depth      = 48
+    request.threeds_v2_browser_screen_height    = 900
+    request.threeds_v2_browser_screen_width     = 1440
+    request.threeds_v2_browser_time_zone_offset = '+0'
+    request.threeds_v2_browser_user_agent       = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.97 Safari/537.36'
+
+    ## SDK
+    ## When Control Device Type is SDK
+    request.threeds_v2_sdk_interface                 =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Sdk::Interfaces::BOTH
+    request.threeds_v2_sdk_ui_types                  =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Sdk::UiTypes::TEXT
+    request.threeds_v2_sdk_ui_types                  =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Sdk::UiTypes::SINGLE_SELECT
+    request.threeds_v2_sdk_ui_types                  =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Sdk::UiTypes::MULTI_SELECT
+    request.threeds_v2_sdk_application_id            = 'fc1650c0-5778-0138-8205-2cbc32a32d65'
+    request.threeds_v2_sdk_encrypted_data            = 'encrypted-data-here'
+    request.threeds_v2_sdk_ephemeral_public_key_pair = 'public-key-pair'
+    request.threeds_v2_sdk_max_timeout               = 10
+    request.threeds_v2_sdk_reference_number          = 'sdk-reference-number-her'
+
+
+    ## Purchase Attributes
+    request.threeds_v2_purchase_category =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Purchase::Categories::GOODS
+
+    ## Recurring
+    request.threeds_v2_recurring_expiration_date = '12-12-2024'
+    request.threeds_v2_recurring_frequency       = 30
+
+    ## Merchant Risk Attributes
+    request.threeds_v2_merchant_risk_shipping_indicator           =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::MerchantRisk::ShippingIndicators::SAME_AS_BILLING
+    request.threeds_v2_merchant_risk_delivery_timeframe           =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::MerchantRisk::DeliveryTimeframes::ANOTHER_DAY
+    request.threeds_v2_merchant_risk_reorder_items_indicator      =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::MerchantRisk::ReorderItemIndicators::FIRST_TIME
+    request.threeds_v2_merchant_risk_pre_order_purchase_indicator =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::MerchantRisk::PreOrderPurchaseIndicators::MERCHANDISE_AVAILABLE
+    request.threeds_v2_merchant_risk_pre_order_date               = '31-12-2030'
+    request.threeds_v2_merchant_risk_gift_card                    = true
+    request.threeds_v2_merchant_risk_gift_card_count              = 99
+
+    ## Card Holder Account Attributes
+    request.threeds_v2_card_holder_account_creation_date                       = '31-12-2022'
+    request.threeds_v2_card_holder_account_update_indicator                    =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::CardHolderAccount::UpdateIndicators::MORE_THAN_60DAYS
+    request.threeds_v2_card_holder_account_last_change_date                    = '31-12-2022'
+    request.threeds_v2_card_holder_account_password_change_indicator           =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::CardHolderAccount::PasswordChangeIndicators::NO_CHANGE
+    request.threeds_v2_card_holder_account_password_change_date                = '31-12-2022'
+    request.threeds_v2_card_holder_account_shipping_address_usage_indicator    =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::CardHolderAccount::ShippingAddressUsageIndicators::MORE_THAN_60DAYS
+    request.threeds_v2_card_holder_account_shipping_address_date_first_used    = '31-12-2022'
+    request.threeds_v2_card_holder_account_transactions_activity_last24_hours  = 2
+    request.threeds_v2_card_holder_account_transactions_activity_previous_year = 10
+    request.threeds_v2_card_holder_account_provision_attempts_last24_hours     = 1
+    request.threeds_v2_card_holder_account_purchases_count_last6_months        = 5
+    request.threeds_v2_card_holder_account_suspicious_activity_indicator       =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::CardHolderAccount::SuspiciousActivityIndicators::NO_SUSPICIOUS_OBSERVED
+    request.threeds_v2_card_holder_account_registration_indicator              =
+            GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::CardHolderAccount::RegistrationIndicators::MORE_THAN_60DAYS
+    request.threeds_v2_card_holder_account_registration_date                   = '31-12-2022'
+
+  end.execute
+
+  response_3ds_v2 = genesis_3ds_v2.response
+
+  if response_3ds_v2.approved?
+    # Transaction approved no customer action required
+    # Test Case: Synchronous 3DSv2 Request with Frictionless flow
+    puts response_3ds_v2.response_object
+  end
+
+  if response_3ds_v2.declined? || response_3ds_v2.error?
+    # Transaction declined no customer action required
+    # Synchronous 3DSv2 Request with Frictionless flow
+    puts response_3ds_v2.response_object
+  end
+
+  if response_3ds_v2.pending_async?
+    # Additional Actions Required
+    response_object_3ds_v2 = response_3ds_v2.response_object
+
+    if response_object_3ds_v2[:redirect_url]
+      # An interaction between consumer and issuer is required
+      # 3DSv2 Challenge required
+      # 3DSv1 payer authentication required - fallback from 3DSv2 to 3DSv1
+      # Test Case: Asynchronous 3DSv2 Request with Challenge flow
+      # Test Case: Asynchronous 3DSv2 Request with Fallback flow
+      puts response_object_3ds_v2[:redirect_url_type]
+      puts response_object_3ds_v2[:redirect_url]
+    end
+
+    if response_object_3ds_v2[:threeds_method_url]
+      # 3DS-Method submission is required
+      # Generate 3DSv2-Method Signature token used for Threeds Method Continue Request. It's not required when the 3DS-Method continue request is built by the initial request's response object.
+      puts GenesisRuby::Utils::Threeds::V2.generate_signature(
+              unique_id: response_object_3ds_v2[:unique_id],
+              amount: response_object_3ds_v2[:amount],
+              timestamp: response_object_3ds_v2[:timestamp].strftime(GenesisRuby::Api::Constants::DateTimeFormats::YYYY_MM_DD_H_I_S_ZULU),
+              merchant_password: configuration.password
+      )
+
+      # Execute 3DS-Method Continue Request after initiating the 3DS-Method submission
+      # The new request is loaded from the response object of the initial request
+      genesis_3ds_v2_continue = GenesisRuby::Api::Requests::Financial::Cards::Threeds::V2::MethodContinue.build_from_response_object(
+              configuration,
+              genesis_3ds_v2.response.response_object
+      )
+
+      genesis_3ds_v2_continue.execute
+
+      response_3ds_v2_continue = genesis_3ds_v2_continue.response
+
+      if response_3ds_v2_continue.approved?
+        # Transaction APPROVED no customer action required
+        # Test Case: Asynchronous 3DSv2 Request with 3DS-Method and Frictionless flow
+        puts response_3ds_v2_continue.response_object
+      end
+
+      if response_3ds_v2_continue.declined? || response_3ds_v2_continue.error?
+        # Transaction declined no customer action required
+        puts response_3ds_v2_continue.response_object
+      end
+
+      if response_3ds_v2_continue.pending_async?
+        # Customer action required
+        continue_response_object = response_3ds_v2_continue.response_object
+
+        if continue_response_object[:redirect_url]
+          # Test Case: Asynchronous 3DSv2 Request with 3DS-Method Challenge flow
+          # Test Case: Asynchronous 3DSv2 Request with 3DS-Method Fallback flow
+          puts continue_response_object[:redirect_url_type]
+          puts continue_response_object[:redirect_url]
+        end
+      end
+    end
+  end
+
+rescue GenesisRuby::Error => error
+  puts error.message
+end
+```
+
+</details>
+
+### Standalone ThreedsV2 Method Continue Request.
+
+<details>
+
+```ruby
+require 'genesis_ruby'
+
+begin
+  genesis = GenesisRuby::Genesis.for(config: configuration, request: GenesisRuby::Api::Requests::Financial::Cards::Threeds::V2::MethodContinue) do |request|
+    # Amount in minor currency unit
+    # If the AMOUNT is not in a minor currency unit then SET the CURRENCY. The AMOUNT will be converted into minor currency unit internally using the CURRENCY property.
+    # Ex. amount = 10.00
+    #     currency = 'EUR'
+    #   The AMOUNT in that case for signature generation will be 1000
+    # Amount is included in the response from the initial request in major currency unit genesis.response.response_object[:amount]
+    request.amount = 10.00
+
+    # If CURRENCY is set, AMOUNT value will be converted into MINOR currency unit
+    # If you SET the AMOUNT in MINOR currency unit DO NOT set CURRENCY
+    # Currency is included in the response from the initial request in major currency unit genesis.response.response_object[:currency]
+    request.currency = 'EUR'
+
+    # Set only one of the unique_id or url
+    # request.url = 'https://staging.gate.emerchantpay.net/threeds/threeds_method/d6a6aa96292e4856d4a352ce634a4335'
+    request.transaction_unique_id = 'd6a6aa96292e4856d4a352ce634a4335'
+
+    # String representation of the timestamp
+    # request.transaction_timestamp = genesis.response
+    #   .response_object[:timestamp].strftime(GenesisRuby::Api::Constants::DateTimeFormats::YYYY_MM_DD_H_I_S_ZULU)
+    request.transaction_timestamp = '2020-12-31T23:59:59Z'
+  end.execute
+
+  response = genesis.response
+
+  if response.approved?
+    # Asynchronous 3DSv2 Request with 3DS-Method and Frictionless flow
+    # Transaction approved no customer action required
+    puts response.response_object
+  end
+
+  if response.pending_async?
+    # Customer action required
+    response_object = response.response_object
+
+    if response_object[:redirect_url]
+      # Asynchronous 3DSv2 Request with 3DS-Method Challenge flow
+      # Asynchronous 3DSv2 Request with 3DS-Method Fallback flow
+      puts response_object[:redirect_url_type]
+      puts response_object[:redirect_url]
+    end
+  end
+
+rescue GenesisRuby::Error => error
+  puts error.message
+end
+```
+
+</details>
+
 
 ### Recurring
 
@@ -246,6 +523,117 @@ If an error occurs during the Transaction Execution the status is one of the fol
 ```
 </details>
 
+### Reference actions
+The Reference transaction requests allow actions over an existing payment. The payment can be modified with:
+* Capture - settles a transaction that has been authorized before
+* Void - undo other transactions
+* Refund -  allow to return already billed amounts to customers
+
+<kbd>!</kbd> Void transaction request doesn't require amount and currency parameters
+
+After a successful response of a payment, reference actions can be executed by using the `unique_id`.
+
+```ruby
+require 'genesis_ruby'
+
+begin
+  genesis = GenesisRuby::Genesis.for(config: configuration, request: GenesisRuby::Api::Requests::Financial::Refund) do |request|
+    request.transaction_id = '12345-67890'
+    request.amount         = '0.99' # not available for GenesisRuby::Api::Requests::Financial::Void
+    request.currency       = 'EUR' # not available for GenesisRuby::Api::Requests::Financial::Void
+    request.usage          = 'Example usage'
+    request.reference_id   = 'unique_id received upon successful payment transaction'
+  end.execute
+
+  puts genesis.response.response_object
+
+rescue GenesisRuby::Error => error
+  puts error.message
+end
+```
+
+### Gateway Notification
+
+With the asynchronous payment flows like Web Payment Form the Gateway sends the transaction events upon status change on the defined `notification_url`.
+The library contains a Notification module that helps handle the received gateway notification and can provide easy reconciliation execution.
+
+#### Initialization
+The notification module requires notification data or any object that responds to `to_h` with a Hash return value.
+For example, with Ruby on Rails you can permit the params and to_h method can be executed without errors:
+
+```ruby
+permitted_params = params.permit(:transaction_id, :terminal_token, :unique_id, :transaction_type, :status, :signature, :amount)
+```
+A full list of the available params that can be received upon notification can be found [here](https://emerchantpay.github.io/gateway-api-docs/?shell#asynchronous-transactions).
+
+```ruby
+begin
+  notification = GenesisRuby::Api::Notification.new configuration, permitted_params
+
+  # Helper methods
+  notification.api_notification?
+  notification.wpf_notification?
+  notification.unique_id
+
+  # Executes Gateway Transaction Reconciliation
+  # This provides the latest information on the transaction from the Gateway
+  notification.reconcile
+
+  # Provides information if the given reconcile response contains transaction information
+  notification.transaction_reconciliation?
+
+  # Get the Reconcile Response Object in Hash data structure
+  notification.reconciliation.response_object
+
+  # Generate response document expected from the Gateway
+  notification.generate_response
+rescue GenesisRuby::ParameterError => error
+  puts error.message
+end
+```
+
+#### Reconcile
+Minimum required data for execution of `reconcile`:
+
+```ruby
+{
+  unique_id: 'unique_id received from the gateway in the notification params',
+  signature: 'the signature received in the notification'
+}
+```
+
+If the signature can't be verified Genesis::Ruby::ParameterError will be raised.
+
+#### Helpers
+`notification.reconcile` returns GenesisRuby::Api::Response. The response object can be accessed via `notification.reconciliation`.
+The reconciliation object has every helper that [Response](#response-helpers) contains like checking the status with `error?`, `approved?`, etc.
+
+For checking if the `reconciliation.response_object` is a successful transaction response you can use `notification.transaction_reconciliation?`
+
+#### Errors
+Upon wrong data like configuration terminal token, `reconciliation.response_object` can be similar:
+
+```ruby
+{
+   status: 'error',
+   code: '220',
+   message: 'Reconcile request failed, please contact support!',
+   technical_message: 'Invalid Terminal'
+}
+```
+
+#### Respond to the Gateway
+When receiving the notification, you are required to render an xml page containing the transaction’s unique id so that the gateway knows that you have accepted the notification.
+If the XML is not delivered, the notification is sent periodically until the XML is received.
+
+`GenesisRuby::Api::Notification` provides helper method for generation of the expected xml content. The Gateway expects a response with:
+* Status 200
+* Content Type `text/xml`
+
+```ruby
+notification.generate_response
+```
+
 ### Response Helpers
 
 #### Sates
@@ -284,7 +672,7 @@ configuration.sanitize_response = false
 You can use the following request classes to initialize the Genesis client:
 
 ```ruby
-# Transactions
+# Financial
 ## Cards
 GenesisRuby::Api::Requests::Financial::Cards::Authorize
 GenesisRuby::Api::Requests::Financial::Cards::Authorize3d
@@ -294,6 +682,17 @@ GenesisRuby::Api::Requests::Financial::Cards::Sale3d
 # Web Payment Form
 ## Create
 GenesisRuby::Api::Requests::Wpf::Create
+GenesisRuby::Api::Requests::Wpf::Reconcile
+
+# References
+GenesisRuby::Api::Requests::Financial::Capture
+GenesisRuby::Api::Requests::Financial::Void
+GenesisRuby::Api::Requests::Financial::Refund
+
+# Non Financial
+## Reconcile
+GenesisRuby::Api::Requests::NonFinancial::Reconcile::Transaction
+GenesisRuby::Api::Requests::NonFinancial::Reconcile::DateRange
 ```
 
 ### Manual initialization

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.2

data/genesis_ruby.gemspec

@@ -13,10 +13,13 @@ Gem::Specification.new do |spec|
   spec.license                     = 'MIT'
   spec.required_ruby_version       = '>= 2.7.0'
 
-  spec.metadata['homepage_uri']    = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://github.com/GenesisGateway/genesis_ruby'
-  spec.metadata['changelog_uri']   = 'https://github.com/GenesisGateway/genesis_ruby/CHANGELOG.md'
+  spec.metadata['homepage_uri']      = spec.homepage
+  spec.metadata['source_code_uri']   = 'https://github.com/GenesisGateway/genesis_ruby'
+  spec.metadata['changelog_uri']     = 'https://github.com/GenesisGateway/genesis_ruby/blob/main/CHANGELOG.md'
+  spec.metadata['documentation_uri'] = 'https://github.com/GenesisGateway/genesis_ruby/blob/main/README.md'
 
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(bin|test|spec|features|sig)/|\.(?:git|pronto|rspec|rubocop)})
   end
@@ -28,7 +31,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'net-http', '~> 0.3.2'
   spec.add_runtime_dependency 'nokogiri', '~> 1.14'
 
-  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'bundler', '~> 2.1'
   spec.add_development_dependency 'faker', '~> 2.22'
   spec.add_development_dependency 'faraday-retry', '~> 2.0'
   spec.add_development_dependency 'pronto', '~> 0.11'

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

@@ -16,7 +16,7 @@ module GenesisRuby
         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
+        YYYY_MM_DD_H_I_S_ZULU = '%Y-%m-%dT%H:%M:%SZ'.freeze
 
         # Modified Zulu timestamp
         YYYY_MM_DD_H_I_S      = '%Y-%m-%d %H:%M:%S'.freeze