braintree 2.98.0 → 4.23.0

data/lib/braintree/merchant_account_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class MerchantAccountGateway # :nodoc:
+  class MerchantAccountGateway
     include BaseModule
 
     def initialize(gateway)
@@ -51,7 +51,7 @@ module Braintree
       _create_for_currency(params)
     end
 
-    def _do_create(path, params=nil) # :nodoc:
+    def _do_create(path, params=nil)
       response = @config.http.post("#{@config.base_merchant_path}#{path}", params)
       if response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])
@@ -60,7 +60,7 @@ module Braintree
       end
     end
 
-    def _do_update(path, params=nil) # :nodoc:
+    def _do_update(path, params=nil)
       response = @config.http.put("#{@config.base_merchant_path}#{path}", params)
       if response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])
@@ -74,7 +74,7 @@ module Braintree
 
       if response.has_key?(:response) && response[:response][:merchant_account]
         Braintree::SuccessfulResult.new(
-          :merchant_account => MerchantAccount._new(@gateway, response[:response][:merchant_account])
+          :merchant_account => MerchantAccount._new(@gateway, response[:response][:merchant_account]),
         )
       elsif response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])
@@ -83,6 +83,7 @@ module Braintree
       end
     end
 
+    # NEXT_MAJOR_VERSION this is part of Marketplace and shouldn't be removed unless we're removing all Marketplace code
     def self._detect_signature(attributes)
       if attributes.has_key?(:applicant_details)
         warn "[DEPRECATED] Passing :applicant_details to create is deprecated. Please use :individual, :business, and :funding."
@@ -92,7 +93,8 @@ module Braintree
       end
     end
 
-    def self._deprecated_create_signature # :nodoc:
+    # NEXT_MAJOR_VERSION this is part of Marketplace and shouldn't be removed unless we're removing all Marketplace code
+    def self._deprecated_create_signature
       [
         {:applicant_details => [
           :first_name, :last_name, :email, :date_of_birth, :ssn, :routing_number,
@@ -103,7 +105,7 @@ module Braintree
       ]
     end
 
-    def self._signature # :nodoc:
+    def self._signature
       [
         {:individual => [
           :first_name, :last_name, :email, :date_of_birth, :ssn, :phone,
@@ -117,11 +119,11 @@ module Braintree
       ]
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       _signature + [:tos_accepted, :master_merchant_account_id, :id]
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       _signature
     end
   end

data/lib/braintree/merchant_gateway.rb

@@ -26,7 +26,7 @@ module Braintree
       if response.has_key?(:response) && response[:response][:merchant]
         Braintree::SuccessfulResult.new(
           :merchant => Merchant._new(@gateway, response[:response][:merchant]),
-          :credentials => OAuthCredentials._new(response[:response][:credentials])
+          :credentials => OAuthCredentials._new(response[:response][:credentials]),
         )
       elsif response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])

data/lib/braintree/meta_checkout_card.rb

@@ -0,0 +1,89 @@
+module Braintree
+    class MetaCheckoutCard
+      include BaseModule # :nodoc:
+      include Braintree::Util::TokenEquality
+
+      attr_reader :bin
+      attr_reader :container_id
+      attr_reader :card_type
+      attr_reader :cardholder_name
+      attr_reader :commercial
+      attr_reader :country_of_issuance
+      attr_reader :created_at
+      attr_reader :customer_id
+      attr_reader :customer_location
+      attr_reader :debit
+      attr_reader :durbin_regulated
+      attr_reader :expiration_month
+      attr_reader :expiration_year
+      attr_reader :healthcare
+      attr_reader :image_url
+      attr_reader :issuing_bank
+      attr_reader :last_4
+      attr_reader :payroll
+      attr_reader :prepaid
+      attr_reader :product_id
+      attr_reader :subscriptions
+      attr_reader :token
+      attr_reader :unique_number_identifier
+      attr_reader :updated_at
+      attr_reader :verification
+
+
+      def initialize(gateway, attributes) # :nodoc:
+        @gateway = gateway
+        set_instance_variables_from_hash(attributes)
+        @subscriptions = (@subscriptions || []).map { |subscription_hash| Subscription._new(@gateway, subscription_hash) }
+        @verification = _most_recent_verification(attributes)
+      end
+
+      def _most_recent_verification(attributes)
+        verification = (attributes[:verifications] || []).sort_by { |v| v[:created_at] }.reverse.first
+        CreditCardVerification._new(verification) if verification
+      end
+
+      def default?
+        @default
+      end
+
+      # Expiration date formatted as MM/YYYY
+      def expiration_date
+        "#{expiration_month}/#{expiration_year}"
+      end
+
+      def expired?
+        @expired
+      end
+
+      def inspect # :nodoc:
+        first = [:token]
+        order = first + (self.class._attributes - first)
+        nice_attributes = order.map do |attr|
+          "#{attr}: #{send(attr).inspect}"
+        end
+        "#<#{self.class} #{nice_attributes.join(', ')}>"
+      end
+
+      def masked_number
+        "#{bin}******#{last_4}"
+      end
+
+      class << self
+        protected :new
+      end
+
+      def self._attributes # :nodoc:
+        [
+          :bin, :card_type, :cardholder_name, :created_at,
+          :customer_id, :customer_location, :expiration_month, :expiration_year,
+          :last_4, :token, :updated_at, :prepaid, :payroll, :product_id,
+          :commercial, :debit, :durbin_regulated, :healthcare,
+          :country_of_issuance, :issuing_bank, :image_url, :container_id
+        ]
+      end
+
+      def self._new(*args) # :nodoc:
+        self.new(*args)
+      end
+    end
+  end

data/lib/braintree/meta_checkout_token.rb

@@ -0,0 +1,88 @@
+module Braintree
+    class MetaCheckoutToken
+      include BaseModule # :nodoc:
+      include Braintree::Util::TokenEquality
+
+      attr_reader :bin
+      attr_reader :container_id
+      attr_reader :card_type
+      attr_reader :cardholder_name
+      attr_reader :commercial
+      attr_reader :country_of_issuance
+      attr_reader :created_at
+      attr_reader :cryptogram
+      attr_reader :customer_id
+      attr_reader :customer_location
+      attr_reader :debit
+      attr_reader :durbin_regulated
+      attr_reader :ecommerce_indicator
+      attr_reader :expiration_month
+      attr_reader :expiration_year
+      attr_reader :healthcare
+      attr_reader :image_url
+      attr_reader :issuing_bank
+      attr_reader :last_4
+      attr_reader :payroll
+      attr_reader :prepaid
+      attr_reader :product_id
+      attr_reader :token
+      attr_reader :unique_number_identifier
+      attr_reader :updated_at
+      attr_reader :verification
+
+      def initialize(gateway, attributes) # :nodoc:
+        @gateway = gateway
+        set_instance_variables_from_hash(attributes)
+        @verification = _most_recent_verification(attributes)
+      end
+
+      def _most_recent_verification(attributes)
+        verification = (attributes[:verifications] || []).sort_by { |v| v[:created_at] }.reverse.first
+        CreditCardVerification._new(verification) if verification
+      end
+
+      def default?
+        @default
+      end
+
+      # Expiration date formatted as MM/YYYY
+      def expiration_date
+        "#{expiration_month}/#{expiration_year}"
+      end
+
+      def expired?
+        @expired
+      end
+
+      def inspect # :nodoc:
+        first = [:token]
+        order = first + (self.class._attributes - first)
+        nice_attributes = order.map do |attr|
+          "#{attr}: #{send(attr).inspect}"
+        end
+        "#<#{self.class} #{nice_attributes.join(', ')}>"
+      end
+
+      def masked_number
+        "#{bin}******#{last_4}"
+      end
+
+      class << self
+        protected :new
+      end
+
+      def self._attributes # :nodoc:
+        [
+          :bin, :card_type, :cardholder_name, :created_at,
+          :customer_id, :customer_location, :expiration_month, :expiration_year,
+          :last_4, :token, :updated_at, :prepaid, :payroll, :product_id,
+          :commercial, :debit, :durbin_regulated, :healthcare, :ecommerce_indicator,
+          :country_of_issuance, :issuing_bank, :image_url, :container_id, :cryptogram
+        ]
+      end
+
+      def self._new(*args) # :nodoc:
+        self.new(*args)
+      end
+    end
+  end

data/lib/braintree/modification.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class Modification # :nodoc:
+  class Modification
     include BaseModule
 
     attr_reader :amount
@@ -17,12 +17,12 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
-        self.new *args
+      def _new(*args)
+        self.new(*args)
       end
     end
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
       @amount = Util.to_big_decimal(amount)
     end

data/lib/braintree/oauth_credentials.rb

@@ -1,13 +1,13 @@
 module Braintree
   class OAuthCredentials
-    include BaseModule # :nodoc:
+    include BaseModule
 
     attr_reader :access_token
     attr_reader :expires_at
     attr_reader :refresh_token
     attr_reader :token_type
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
     end
 
@@ -15,8 +15,8 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
   end
 end

data/lib/braintree/oauth_gateway.rb

@@ -22,7 +22,7 @@ module Braintree
       })
       if response[:credentials]
         Braintree::SuccessfulResult.new(
-          :credentials => OAuthCredentials._new(response[:credentials])
+          :credentials => OAuthCredentials._new(response[:credentials]),
         )
       elsif response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])
@@ -47,10 +47,10 @@ module Braintree
       user_params = _sub_query(params, :user)
       business_params = _sub_query(params, :business)
       payment_methods = _sub_array_query(params, :payment_methods)
-      query = params.to_a.
-        concat(user_params).
-        concat(business_params).
-        concat(payment_methods)
+      query = params.to_a
+        .concat(user_params)
+        .concat(business_params)
+        .concat(payment_methods)
 
       query_string = query.map { |k, v| "#{CGI.escape(k.to_s)}=#{CGI.escape(v.to_s)}" }.join("&")
       "#{@config.base_url}/oauth/connect?#{query_string}"

data/lib/braintree/paginated_collection.rb

@@ -1,8 +1,8 @@
 module Braintree
-  class PaginatedCollection # :nodoc:
+  class PaginatedCollection
     include Enumerable
 
-    def initialize(&block) # :nodoc:
+    def initialize(&block)
       @next_page_block = block
     end
 

data/lib/braintree/paginated_result.rb

@@ -6,7 +6,7 @@ module Braintree
     attr_reader :page_size
     attr_reader :total_items
 
-    def initialize(total_items, page_size, current_page) # :nodoc:
+    def initialize(total_items, page_size, current_page)
       @total_items = total_items
       @current_page = current_page
       @page_size = page_size

data/lib/braintree/payment_instrument_type.rb

@@ -1,17 +1,18 @@
 module Braintree
   module PaymentInstrumentType
-    PayPalAccount = 'paypal_account'
-    EuropeBankAccount = 'europe_bank_account'
-    CreditCard = 'credit_card'
-    CoinbaseAccount = 'coinbase_account'
-    ApplePayCard = 'apple_pay_card'
-    AndroidPayCard = 'android_pay_card'
-    VenmoAccount = 'venmo_account'
-    UsBankAccount = 'us_bank_account'
-    VisaCheckoutCard = 'visa_checkout_card'
-    MasterpassCard = 'masterpass_card'
-    SamsungPayCard = 'samsung_pay_card'
-    LocalPayment = 'local_payment'
-    PayPalHere = 'paypal_here'
+    ApplePayCard = "apple_pay_card"
+    CreditCard = "credit_card"
+    GooglePayCard = "android_pay_card"
+    LocalPayment = "local_payment"
+    MetaCheckoutCard = "meta_checkout_card"
+    MetaCheckoutToken = "meta_checkout_token"
+    PayPalAccount = "paypal_account"
+    PayPalHere = "paypal_here"
+    # NEXT_MAJOR_VERSION remove SamsungPayCard
+    SamsungPayCard = "samsung_pay_card"
+    SepaDirectDebitAccount = "sepa_debit_account"
+    UsBankAccount = "us_bank_account"
+    VenmoAccount = "venmo_account"
+    VisaCheckoutCard = "visa_checkout_card"
   end
 end

data/lib/braintree/payment_method_customer_data_updated_metadata.rb

@@ -0,0 +1,24 @@
+module Braintree
+  class PaymentMethodCustomerDataUpdatedMetadata
+    include BaseModule
+
+    attr_reader :token
+    attr_reader :payment_method
+    attr_reader :datetime_updated
+    attr_reader :enriched_customer_data
+
+    def initialize(gateway, attributes)
+      set_instance_variables_from_hash(attributes)
+      @payment_method = PaymentMethodParser.parse_payment_method(gateway, attributes[:payment_method])
+      @enriched_customer_data = EnrichedCustomerData._new(enriched_customer_data) if enriched_customer_data
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args)
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/payment_method_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class PaymentMethodGateway # :nodoc:
+  class PaymentMethodGateway
     include BaseModule
 
     def initialize(gateway)
@@ -9,6 +9,10 @@ module Braintree
     end
 
     def create(attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(PaymentMethodGateway._create_signature, attributes)
       _do_create("/payment_methods", :payment_method => attributes)
     end
@@ -17,9 +21,8 @@ module Braintree
       return_object_or_raise(:payment_method) { create(*args) }
     end
 
-    def _do_create(path, params=nil) # :nodoc:
+    def _do_create(path, params=nil)
       response = @config.http.post("#{@config.base_merchant_path}#{path}", params)
-
       if response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])
       elsif response
@@ -43,18 +46,16 @@ module Braintree
         CreditCard._new(@gateway, response[:credit_card])
       elsif response.has_key?(:paypal_account)
         PayPalAccount._new(@gateway, response[:paypal_account])
-      elsif response[:coinbase_account]
-        SuccessfulResult.new(:payment_method => CoinbaseAccount._new(@gateway, response[:coinbase_account]))
       elsif response.has_key?(:us_bank_account)
         UsBankAccount._new(@gateway, response[:us_bank_account])
-      elsif response.has_key?(:europe_bank_account)
-        EuropeBankAccount._new(@gateway, response[:europe_bank_account])
       elsif response.has_key?(:apple_pay_card)
         ApplePayCard._new(@gateway, response[:apple_pay_card])
       elsif response.has_key?(:android_pay_card)
-        AndroidPayCard._new(@gateway, response[:android_pay_card])
+        GooglePayCard._new(@gateway, response[:android_pay_card])
       elsif response.has_key?(:venmo_account)
         VenmoAccount._new(@gateway, response[:venmo_account])
+      elsif response.has_key?(:sepa_debit_account)
+        SepaDirectDebitAccount._new(@gateway, response[:sepa_debit_account])
       else
         UnknownPaymentMethod._new(@gateway, response)
       end
@@ -63,6 +64,10 @@ module Braintree
     end
 
     def update(token, attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(PaymentMethodGateway._update_signature, attributes)
       _do_update(:put, "/payment_methods/any/#{token}", :payment_method => attributes)
     end
@@ -71,7 +76,7 @@ module Braintree
       return_object_or_raise(:payment_method) { update(*args) }
     end
 
-    def _do_update(http_verb, path, params) # :nodoc:
+    def _do_update(http_verb, path, params)
       response = @config.http.send(http_verb, "#{@config.base_merchant_path}#{path}", params)
       if response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])
@@ -87,7 +92,7 @@ module Braintree
       if  options.class == Hash
         grant_options = options
       elsif [true, false].include?(options)
-        grant_options = { :allow_vaulting => options }
+        grant_options = {:allow_vaulting => options}
       else
         raise ArgumentError
       end
@@ -96,7 +101,7 @@ module Braintree
         "/payment_methods/grant",
         :payment_method => {
           :shared_payment_method_token => token,
-        }.merge(grant_options)
+        }.merge(grant_options),
       )
     rescue NotFoundError
       raise NotFoundError, "payment method with token #{token.inspect} not found"
@@ -120,7 +125,7 @@ module Braintree
         "/payment_methods/revoke",
         :payment_method => {
           :shared_payment_method_token => token
-        }
+        },
       )
     rescue NotFoundError
       raise NotFoundError, "payment method with token #{token.inspect} not found"
@@ -137,25 +142,34 @@ module Braintree
       end
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       _signature(:create)
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       _signature(:update)
     end
 
-    def self._delete_signature # :nodoc:
+    def self._delete_signature
       [:revoke_all_grants]
     end
 
-    def self._signature(type) # :nodoc:
+    def self._signature(type)
       billing_address_params = AddressGateway._shared_signature
       paypal_options_shipping_signature = AddressGateway._shared_signature
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_session
+      # The old venmo SDK class has been deprecated
       options = [
-        :make_default, :verification_merchant_account_id, :verify_card, :venmo_sdk_session,
-        :verification_amount, :us_bank_account_verification_method,
+        :make_default,
+        :skip_advanced_fraud_checking,
+        :us_bank_account_verification_method,
+        :venmo_sdk_session, # Deprecated
         :verification_account_type,
+        :verification_add_ons,
+        :verification_amount,
+        :verification_currency_iso_code,
+        :verification_merchant_account_id,
+        :verify_card,
         :paypal => [
           :payee_email,
           :order_id,
@@ -165,21 +179,37 @@ module Braintree
           {:shipping => paypal_options_shipping_signature}
         ],
       ]
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_payment_method_code
+      # The old venmo SDK class has been deprecated
       signature = [
-        :billing_address_id, :cardholder_name, :cvv, :device_session_id, :expiration_date,
-        :expiration_month, :expiration_year, :number, :token, :venmo_sdk_payment_method_code,
-        :device_data, :fraud_merchant_id, :payment_method_nonce,
+        :billing_address_id, :cardholder_name, :cvv, :expiration_date, :expiration_month,
+        :expiration_year, :number, :token, :venmo_sdk_payment_method_code, # Deprecated
+        :device_data, :payment_method_nonce,
         {:options => options},
         {:billing_address => billing_address_params}
       ]
+      signature << {
+        :three_d_secure_pass_thru => [
+          :eci_flag,
+          :cavv,
+          :xid,
+          :three_d_secure_version,
+          :authentication_response,
+          :directory_response,
+          :cavv_algorithm,
+          :ds_transaction_id,
+        ]
+      }
 
       case type
       when :create
         options << :fail_on_duplicate_payment_method
+        options << :fail_on_duplicate_payment_method_for_customer
         signature << :customer_id
         signature << :paypal_refresh_token
-        signature << :paypal_vault_without_upgrade
       when :update
+        options << :fail_on_duplicate_payment_method
+        options << :fail_on_duplicate_payment_method_for_customer
         billing_address_params << {:options => [:update_existing]}
       else
         raise ArgumentError

data/lib/braintree/payment_method_nonce.rb

@@ -1,6 +1,6 @@
 module Braintree
   class PaymentMethodNonce
-    include BaseModule # :nodoc:
+    include BaseModule
 
     def self.create(*args)
       Configuration.gateway.payment_method_nonce.create(*args)
@@ -15,21 +15,26 @@ module Braintree
     end
 
     attr_reader :bin_data
+    attr_reader :default
     attr_reader :details
     attr_reader :nonce
     attr_reader :three_d_secure_info
     attr_reader :type
+    attr_reader :authentication_insight
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
-      @nonce = attributes.fetch(:nonce)
-      @type = attributes.fetch(:type)
-      @details = attributes.fetch(:details)
+      set_instance_variables_from_hash(attributes)
+      @details = PaymentMethodNonceDetails.new(attributes[:details]) if attributes[:details]
       @three_d_secure_info = ThreeDSecureInfo.new(attributes[:three_d_secure_info]) if attributes[:three_d_secure_info]
       @bin_data = BinData.new(attributes[:bin_data]) if attributes[:bin_data]
     end
 
-    def to_s # :nodoc:
+    def default?
+      @default
+    end
+
+    def to_s
       nonce
     end
 
@@ -37,7 +42,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(gateway, attributes) # :nodoc:
+    def self._new(gateway, attributes)
       new(gateway, attributes)
     end
   end

data/lib/braintree/payment_method_nonce_details.rb

@@ -0,0 +1,40 @@
+module Braintree
+  class PaymentMethodNonceDetails
+    include BaseModule
+
+    attr_reader :bin
+    attr_reader :card_type
+    attr_reader :expiration_month
+    attr_reader :expiration_year
+    attr_reader :is_network_tokenized
+    attr_reader :last_two
+    attr_reader :payer_info
+    attr_reader :sepa_direct_debit_account_nonce_details
+
+    alias_method :is_network_tokenized?, :is_network_tokenized
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+      @payer_info = PaymentMethodNonceDetailsPayerInfo.new(attributes[:payer_info]) if attributes[:payer_info]
+      @sepa_direct_debit_account_nonce_details = ::Braintree::SepaDirectDebitAccountNonceDetails.new(attributes)
+    end
+
+    def inspect
+      attr_order = [
+        :bin,
+        :card_type,
+        :expiration_month,
+        :expiration_year,
+        :is_network_tokenized,
+        :last_two,
+        :payer_info,
+        :sepa_direct_debit_account_nonce_details,
+      ]
+
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<PaymentMethodNonceDetails #{formatted_attrs.join(", ")}>"
+    end
+  end
+end