offsite_payments 2.7.20 → 2.7.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52bf59c63646b7d0fd207a51bb3e977e14234edd0d7b4d494967ebde13ead384
-  data.tar.gz: 97d45379f6df925b274285ebec7f7b8380396dd3c46162734191b7a6ac03d83b
+  metadata.gz: 11d3af9b6ea7b963a53bba9b38c1c0495aa8a676a5d15a081fff92461ea7848c
+  data.tar.gz: d68bbaabd36c6e31f4ccdd9c77245dfb8adc1596dd9e8b71ba2042f1de010760
 SHA512:
-  metadata.gz: 85fc3bf1c22cdf71b0a4497b44eecb9406f5ff1538eb4d50ea9a26212a13002f8b8a59fc71e5ac2d7d037dda6a39ef7dbae4ec10d2faed2431d736c95565240e
-  data.tar.gz: ba78f07a16f201b9607a98088c4c9173d855ef59ce34e7086334380ff5349d9a6772aea721f2be5bf1b99529061ad10347c9f97ff78e2a80145e0a78378cd051
+  metadata.gz: 57c6f0dda0656e8a528eec91ff862d7580c2603559011d0ee2ddc7fbb437244ef2c3ee111fcf2b7a35ca34c68235a85debc77f33477b5bdb7b07beaa3b759db6
+  data.tar.gz: 50b50027b8cd16ed325e3e12692f775d615d32f6caa187882e89dfedb10cbdc63c4170278e8ae20ddd5e5ea056c1feaa85292efe4290bb4066204d25825b68d5

data/README.md

@@ -67,6 +67,7 @@ one.
 * [Dwolla](https://www.dwolla.com/default.aspx)
 * [ePay](http://www.epay.dk/epay-payment-solutions/)
 * [First Data](https://firstdata.zendesk.com/entries/407522-first-data-global-gateway-e4sm-payment-pages-integration-manual)
+* [Realex](https://www.globalpaymentsinc.com)
 * [HiTRUST](http://www.hitrust.com.hk/)
 * [MOLPay](http://www.molpay.com/v2/) - MY, SG, ID, TH, VN, PH, CN, AU
 * [Moneybookers](http://www.moneybookers.com)
@@ -77,7 +78,6 @@ one.
 * [PayDollar](http://www.paydollar.com)
 * [Paysbuy](https://www.paysbuy.com/) - TH
 * [Platron](https://www.platron.ru/) - RU
-* [Realex](http://www.realexpayments.com)
 * [RBK Money](https://rbkmoney.ru/) - RU
 * [Robokassa](http://robokassa.ru/) - RU
 * [SagePay Form](http://www.sagepay.com/products_services/sage_pay_go/integration/form)

data/lib/offsite_payments/integrations/realex_offsite.rb

@@ -63,6 +63,85 @@ module OffsitePayments #:nodoc:
           'COU' => 4
         }
 
+        CANADIAN_STATES = {
+          'AB' => 'Alberta',
+          'BC' => 'British Columbia',
+          'MB' => 'Manitoba',
+          'NB' => 'New Brunswick',
+          'NL' => 'Newfoundland',
+          'NS' => 'Nova Scotia',
+          'NU' => 'Nunavut',
+          'NT' => 'Northwest Territories',
+          'ON' => 'Ontario',
+          'PE' => 'Prince Edward Island',
+          'QC' => 'Quebec',
+          'SK' => 'Saskatchewan',
+          'YT' => 'Yukon'
+        }
+
+        US_STATES = {
+          'AL' => 'Alabama',
+          'AK' => 'Alaska',
+          'AS' => 'American Samoa',
+          'AZ' => 'Arizona',
+          'AR' => 'Arkansas',
+          'CA' => 'California',
+          'CO' => 'Colorado',
+          'CT' => 'Connecticut',
+          'DE' => 'Delaware',
+          'DC' => 'District Of Columbia',
+          'FM' => 'Federated States Of Micronesia',
+          'FL' => 'Florida',
+          'GA' => 'Georgia',
+          'GU' => 'Guam',
+          'HI' => 'Hawaii',
+          'ID' => 'Idaho',
+          'IL' => 'Illinois',
+          'IN' => 'Indiana',
+          'IA' => 'Iowa',
+          'KS' => 'Kansas',
+          'KY' => 'Kentucky',
+          'LA' => 'Louisiana',
+          'ME' => 'Maine',
+          'MH' => 'Marshall Islands',
+          'MD' => 'Maryland',
+          'MA' => 'Massachusetts',
+          'MI' => 'Michigan',
+          'MN' => 'Minnesota',
+          'MS' => 'Mississippi',
+          'MO' => 'Missouri',
+          'MT' => 'Montana',
+          'NE' => 'Nebraska',
+          'NV' => 'Nevada',
+          'NH' => 'New Hampshire',
+          'NJ' => 'New Jersey',
+          'NM' => 'New Mexico',
+          'NY' => 'New York',
+          'NC' => 'North Carolina',
+          'ND' => 'North Dakota',
+          'MP' => 'Northern Mariana Islands',
+          'OH' => 'Ohio',
+          'OK' => 'Oklahoma',
+          'OR' => 'Oregon',
+          'PW' => 'Palau',
+          'PA' => 'Pennsylvania',
+          'PR' => 'Puerto Rico',
+          'RI' => 'Rhode Island',
+          'SC' => 'South Carolina',
+          'SD' => 'South Dakota',
+          'TN' => 'Tennessee',
+          'TX' => 'Texas',
+          'UT' => 'Utah',
+          'VT' => 'Vermont',
+          'VI' => 'Virgin Islands',
+          'VA' => 'Virginia',
+          'WA' => 'Washington',
+          'WV' => 'West Virginia',
+          'WI' => 'Wisconsin',
+          'WY' => 'Wyoming'
+        }
+
+
         def create_signature(fields, secret)
           data = fields.join('.')
           digest = Digest::SHA1.hexdigest(data)
@@ -96,11 +175,51 @@ module OffsitePayments #:nodoc:
           [extract_digits(params[:zip]), extract_digits(params[:address1])].join('|')
         end
 
+        def extract_address_match_indicator(value)
+          value ? 'TRUE' : 'FALSE'
+        end
+
+        # The home phone number provided by the Cardholder. Should be In format:
+        # of 'CountryCallingCode|Number' for example, '1|123456789'.
+        def format_phone_number(phone_number)
+          return nil if phone_number.nil?
+
+          clean_number = phone_number.gsub(/\D/, '')
+
+          return phone_number if clean_number.length < 10
+
+          country_code = clean_number[0, clean_number.length - 9]
+          number = clean_number[clean_number.length - 9, clean_number.length]
+
+          "#{country_code}|#{number}"
+        end
+
+        def lookup_state_code(country_code, state)
+          case country_code
+          when 'CA'
+            state_code = CANADIAN_STATES.find { |code, state_name| state_name.downcase == state.downcase}
+            state_code ? state_code.first : state
+          when 'US'
+            state_code = US_STATES.find { |code, state_name| state_name.downcase == state.downcase}
+            state_code ? state_code.first : state
+          end
+        end
+
+        # if HPP_ADDRESS_MATCH_INDICATOR is set to TRUE
+        # HPP requires the shipping address to be sent from the billing address
+        def copy_billing_address
+          @fields.select { |k, _| k.start_with? 'HPP_BILLING_' }
+                 .each do |k, v|
+                   add_field("HPP_SHIPPING_#{k.split('HPP_BILLING_')[1]}", v)
+                 end
+        end
       end
 
       class Helper < OffsitePayments::Helper
         include Common
 
+        self.country_format = :numeric
+
         def initialize(order, account, options = {})
           @timestamp   = Time.now.strftime('%Y%m%d%H%M%S')
           @currency    = options[:currency]
@@ -115,11 +234,13 @@ module OffsitePayments #:nodoc:
           add_field 'AUTO_SETTLE_FLAG', '1'
           add_field 'RETURN_TSS', '1'
           add_field 'TIMESTAMP', @timestamp
+          add_field 'HPP_VERSION', '2'
           # Realex does not send back CURRENCY param in response
           # however it does echo any other param so we send it twice.
           add_field 'X-CURRENCY', @currency
           add_field 'X-TEST', @test.to_s
           add_field 'ORDER_ID', "#{order}#{@timestamp.to_i}"
+          add_field 'COMMENT1', application_id
         end
 
         def form_fields
@@ -131,13 +252,59 @@ module OffsitePayments #:nodoc:
         end
 
         def billing_address(params={})
+          country = params[:country]
+          country_code = lookup_country_code(country, :alpha2)
+          super
+
           add_field(mappings[:billing_address][:zip], extract_avs_code(params))
-          add_field(mappings[:billing_address][:country], lookup_country_code(params[:country]))
+          add_field(mappings[:billing_address][:country], lookup_country_code(country))
+
+          if ['US', 'CA'].include?(country_code) && params[:state].length > 2
+            add_field(mappings[:billing_address][:state], lookup_state_code(country_code, params[:state]))
+          end
         end
 
         def shipping_address(params={})
+          country = params[:country]
+          country_code = lookup_country_code(country, :alpha2)
+          super
+
           add_field(mappings[:shipping_address][:zip], extract_avs_code(params))
           add_field(mappings[:shipping_address][:country], lookup_country_code(params[:country]))
+
+          if ['US', 'CA'].include?(country_code) && params[:state].length > 2
+            add_field(mappings[:shipping_address][:state], lookup_state_code(country_code, params[:state]))
+          end
+        end
+
+        def customer(params={})
+          super
+          add_field(mappings[:customer][:phone], format_phone_number(params[:phone]))
+        end
+
+        def addresses_match(address_match = nil)
+          return if address_match.nil?
+
+          add_field(
+            mappings[:addresses_match],
+            extract_address_match_indicator(address_match)
+          )
+
+          copy_billing_address if address_match
+        end
+
+        def comment(comment = nil)
+          add_field(mappings[:comment], comment)
+        end
+
+        # HPP does not want shipping address and HPP_ADDRESS_MATCH_INDICATOR to be sent
+        # if the product does not require shipping
+        def require_shipping(require_shipping = nil)
+          return unless require_shipping == false
+
+          @fields.delete_if do |k, _|
+            k.start_with?('HPP_SHIPPING_') || k == 'HPP_ADDRESS_MATCH_INDICATOR'
+          end
         end
 
         def sign_fields
@@ -161,13 +328,29 @@ module OffsitePayments #:nodoc:
         mapping :notify_url,       'MERCHANT_RESPONSE_URL'
         mapping :return_url,       'MERCHANT_RETURN_URL'
 
-        # Realex Optional fields
-        mapping :customer,         :email => 'CUST_NUM'
 
-        mapping :shipping_address, :zip =>        'SHIPPING_CODE',
-                                   :country =>    'SHIPPING_CO'
-        mapping :billing_address,  :zip =>        'BILLING_CODE',
-                                   :country =>    'BILLING_CO'
+        # Realex Optional fields
+        mapping :customer,        :email => 'HPP_CUSTOMER_EMAIL',
+                                  :phone => 'HPP_CUSTOMER_PHONENUMBER_MOBILE'
+
+        mapping :shipping_address, :zip =>        'HPP_SHIPPING_POSTALCODE',
+                                   :country =>    'HPP_SHIPPING_COUNTRY',
+                                   :address1 =>   'HPP_SHIPPING_STREET1',
+                                   :address2 =>   'HPP_SHIPPING_STREET2',
+                                   :address3 =>   'HPP_SHIPPING_STREET3',
+                                   :city =>       'HPP_SHIPPING_CITY',
+                                   :state =>      'HPP_SHIPPING_STATE'
+
+        mapping :billing_address,  :zip =>        'HPP_BILLING_POSTALCODE',
+                                   :country =>    'HPP_BILLING_COUNTRY',
+                                   :address1 =>   'HPP_BILLING_STREET1',
+                                   :address2 =>   'HPP_BILLING_STREET2',
+                                   :address3 =>   'HPP_BILLING_STREET3',
+                                   :city =>       'HPP_BILLING_CITY',
+                                   :state =>      'HPP_BILLING_STATE'
+
+        mapping :addresses_match,  'HPP_ADDRESS_MATCH_INDICATOR'
+        mapping :comment, 'COMMENT2'
       end
 
       class Notification < OffsitePayments::Notification

data/lib/offsite_payments/version.rb

@@ -1,3 +1,3 @@
 module OffsitePayments
-  VERSION = "2.7.20"
+  VERSION = "2.7.21"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: offsite_payments
 version: !ruby/object:Gem::Version
-  version: 2.7.20
+  version: 2.7.21
 platform: ruby
 authors:
 - Tobias Luetke
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-16 00:00:00.000000000 Z
+date: 2019-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport