braintree 2.98.0 → 4.23.0

data/lib/braintree/connected_merchant_paypal_status_changed.rb

@@ -14,8 +14,8 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
-        self.new *args
+      def _new(*args)
+        self.new(*args)
       end
     end
   end

data/lib/braintree/connected_merchant_status_transitioned.rb

@@ -14,8 +14,8 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
-        self.new *args
+      def _new(*args)
+        self.new(*args)
       end
     end
   end

data/lib/braintree/credit_card.rb

@@ -1,6 +1,6 @@
 module Braintree
   class CreditCard
-    include BaseModule # :nodoc:
+    include BaseModule
     include Braintree::Util::TokenEquality
 
     module CardType
@@ -23,6 +23,17 @@ module Braintree
       All = constants.map { |c| const_get(c) }
     end
 
+    module DebitNetwork
+      Accel = "ACCEL"
+      Maestro = "MAESTRO"
+      Nyce = "NYCE"
+      Pulse = "PULSE"
+      Star = "STAR"
+      Star_Access = "STAR_ACCESS"
+
+      All = constants.map { |c| const_get(c) }
+    end
+
     module CustomerLocation
       International = "international"
       US = "us"
@@ -70,23 +81,17 @@ module Braintree
       Configuration.gateway.credit_card.create!(*args)
     end
 
-    # Deprecated. Use Braintree::TransparentRedirect.url
-    def self.create_credit_card_url
-      warn "[DEPRECATED] CreditCard.create_credit_card_url is deprecated. Please use TransparentRedirect.url"
-      Configuration.gateway.credit_card.create_credit_card_url
-    end
-
-    # Deprecated. Use Braintree::TransparentRedirect.confirm
-    def self.create_from_transparent_redirect(query_string)
-      warn "[DEPRECATED] CreditCard.create_from_transparent_redirect is deprecated. Please use TransparentRedirect.confirm"
-      Configuration.gateway.credit_card.create_from_transparent_redirect(query_string)
-    end
-
+    # NEXT_MAJOR_VERSION remove this method
+    # CreditCard.credit has been deprecated in favor of Transaction.credit
     def self.credit(token, transaction_attributes)
+      warn "[DEPRECATED] CreditCard.credit is deprecated. Use Transaction.credit instead"
       Transaction.credit(transaction_attributes.merge(:payment_method_token => token))
     end
 
+    # NEXT_MAJOR_VERSION remove this method
+    # CreditCard.credit has been deprecated in favor of Transaction.credit
     def self.credit!(token, transaction_attributes)
+      warn "[DEPRECATED] CreditCard.credit is deprecated. Use Transaction.credit instead"
       return_object_or_raise(:transaction) { credit(token, transaction_attributes) }
     end
 
@@ -110,16 +115,17 @@ module Braintree
       Configuration.gateway.credit_card.from_nonce(*args)
     end
 
-    # Deprecated. Use Braintree::PaymentMethod.grant
-    def self.grant(*args)
-      Configuration.gateway.credit_card.grant(*args)
-    end
-
+    # NEXT_MAJOR_VERSION remove this method
+    # CreditCard.sale has been deprecated in favor of Transaction.sale
     def self.sale(token, transaction_attributes)
+      warn "[DEPRECATED] CreditCard.sale is deprecated. Use Transaction.sale instead"
       Configuration.gateway.transaction.sale(transaction_attributes.merge(:payment_method_token => token))
     end
 
+    # NEXT_MAJOR_VERSION remove this method
+    # CreditCard.sale has been deprecated in favor of Transaction.sale
     def self.sale!(token, transaction_attributes)
+      warn "[DEPRECATED] CreditCard.sale is deprecated. Use Transaction.sale instead"
       return_object_or_raise(:transaction) { sale(token, transaction_attributes) }
     end
 
@@ -131,19 +137,7 @@ module Braintree
       Configuration.gateway.credit_card.update!(*args)
     end
 
-    # Deprecated. Use Braintree::TransparentRedirect.confirm
-    def self.update_from_transparent_redirect(query_string)
-      warn "[DEPRECATED] CreditCard.update_via_transparent_redirect_request is deprecated. Please use TransparentRedirect.confirm"
-      Configuration.gateway.credit_card.update_from_transparent_redirect(query_string)
-    end
-
-    # Deprecated. Use Braintree::TransparentRedirect.url
-    def self.update_credit_card_url
-      warn "[DEPRECATED] CreditCard.update_credit_card_url is deprecated. Please use TransparentRedirect.url"
-      Configuration.gateway.credit_card.update_credit_card_url
-    end
-
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       @billing_address = attributes[:billing_address] ? Address._new(@gateway, attributes[:billing_address]) : nil
@@ -152,29 +146,10 @@ module Braintree
     end
 
     def _most_recent_verification(attributes)
-      verification = (attributes[:verifications] || []).sort_by{ |verification| verification[:created_at] }.reverse.first
-      CreditCardVerification._new(verification) if verification
-    end
-
-    # Deprecated. Use Braintree::CreditCard.credit
-    def credit(transaction_attributes)
-      warn "[DEPRECATED] credit as an instance method is deprecated. Please use CreditCard.credit"
-      @gateway.transaction.credit(transaction_attributes.merge(:payment_method_token => token))
+      sorted_verifications = (attributes[:verifications] || []).sort_by { |verification| verification[:created_at] }.reverse.first
+      CreditCardVerification._new(sorted_verifications) if sorted_verifications
     end
 
-    # Deprecated. Use Braintree::CreditCard.credit!
-    def credit!(transaction_attributes)
-      warn "[DEPRECATED] credit! as an instance method is deprecated. Please use CreditCard.credit!"
-      return_object_or_raise(:transaction) { credit(transaction_attributes) }
-    end
-
-    # Deprecated. Use Braintree::CreditCard.delete
-    def delete
-      warn "[DEPRECATED] delete as an instance method is deprecated. Please use CreditCard.delete"
-      @gateway.credit_card.delete(token)
-    end
-
-    # Returns true if this credit card is the customer's default payment method.
     def default?
       @default
     end
@@ -184,12 +159,11 @@ module Braintree
       "#{expiration_month}/#{expiration_year}"
     end
 
-    # Returns true if the credit card is expired.
     def expired?
       @expired
     end
 
-    def inspect # :nodoc:
+    def inspect
       first = [:token]
       order = first + (self.class._attributes - first)
       nice_attributes = order.map do |attr|
@@ -202,57 +176,37 @@ module Braintree
       "#{bin}******#{last_4}"
     end
 
-    # Deprecated. Use Braintree::CreditCard.sale
-    def sale(transaction_attributes)
-      warn "[DEPRECATED] sale as an instance method is deprecated. Please use CreditCard.sale"
-      @gateway.transaction.sale(transaction_attributes.merge(:payment_method_token => token))
-    end
-
-    # Deprecated. Use Braintree::CreditCard.sale!
-    def sale!(transaction_attributes)
-      warn "[DEPRECATED] sale! as an instance method is deprecated. Please use CreditCard.sale!"
-      return_object_or_raise(:transaction) { sale(transaction_attributes) }
-    end
-
-    # Deprecated. Use Braintree::CreditCard.update
-    def update(attributes)
-      warn "[DEPRECATED] update as an instance method is deprecated. Please use CreditCard.update"
-      result = @gateway.credit_card.update(token, attributes)
-      if result.success?
-        copy_instance_variables_from_object result.credit_card
-      end
-      result
-    end
-
-    # Deprecated. Use Braintree::CreditCard.update!
-    def update!(attributes)
-      warn "[DEPRECATED] update! as an instance method is deprecated. Please use CreditCard.update!"
-      return_object_or_raise(:credit_card) { update(attributes) }
-    end
-
     def nonce
       @nonce ||= PaymentMethodNonce.create(token)
     end
 
+    # NEXT_MAJOR_VERSION can this be removed? Venmo SDK integration is no more
     # Returns true if the card is associated with Venmo SDK
+    # NEXT_MAJOR_VERSION Remove this method
+    # The old venmo SDK class has been deprecated
     def venmo_sdk?
+      warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
       @venmo_sdk
     end
 
+    def is_network_tokenized?
+      @is_network_tokenized
+    end
+
     class << self
       protected :new
     end
 
-    def self._attributes # :nodoc:
+    def self._attributes
       [
         :billing_address, :bin, :card_type, :cardholder_name, :created_at, :customer_id, :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
+        :healthcare, :country_of_issuance, :issuing_bank, :image_url, :is_network_tokenized?
       ]
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
   end
 end

data/lib/braintree/credit_card_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class CreditCardGateway # :nodoc:
+  class CreditCardGateway
     include BaseModule
 
     def initialize(gateway)
@@ -12,6 +12,10 @@ module Braintree
       if attributes.has_key?(:expiration_date) && (attributes.has_key?(:expiration_month) || attributes.has_key?(:expiration_year))
         raise ArgumentError.new("create with both expiration_month and expiration_year or only expiration_date")
       end
+      # 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(CreditCardGateway._create_signature, attributes)
       _do_create("/payment_methods", :credit_card => attributes)
     end
@@ -20,22 +24,17 @@ module Braintree
       return_object_or_raise(:credit_card) { create(*args) }
     end
 
-    # Deprecated
-    def create_credit_card_url
-      "#{@config.base_merchant_url}/payment_methods/all/create_via_transparent_redirect_request"
-    end
-
-    # Deprecated
-    def create_from_transparent_redirect(query_string)
-      params = @gateway.transparent_redirect.parse_and_validate_query_string query_string
-      _do_create("/payment_methods/all/confirm_transparent_redirect_request", :id => params[:id])
-    end
-
+    # NEXT_MAJOR_VERSION remove this method
+    # CreditCard.credit has been deprecated in favor of Transaction.credit
     def credit(token, transaction_attributes)
+      warn "[DEPRECATED] CreditCard.credit is deprecated. Use Transaction.credit instead"
       @gateway.transaction.credit(transaction_attributes.merge(:payment_method_token => token))
     end
 
+     # NEXT_MAJOR_VERSION remove this method
+     # CreditCard.credit has been deprecated in favor of Transaction.credit
     def credit!(*args)
+      warn "[DEPRECATED] CreditCard.credit is deprecated. Use Transaction.credit instead"
       return_object_or_raise(:transaction) { credit(*args) }
     end
 
@@ -49,8 +48,8 @@ module Braintree
     end
 
     def expiring_between(start_date, end_date, options = {})
-      formatted_start_date = start_date.strftime('%m%Y')
-      formatted_end_date = end_date.strftime('%m%Y')
+      formatted_start_date = start_date.strftime("%m%Y")
+      formatted_end_date = end_date.strftime("%m%Y")
       response = @config.http.post("#{@config.base_merchant_path}/payment_methods/all/expiring_ids?start=#{formatted_start_date}&end=#{formatted_end_date}")
       ResourceCollection.new(response) { |ids| _fetch_expiring_between(formatted_start_date, formatted_end_date, ids) }
     end
@@ -71,12 +70,11 @@ module Braintree
       raise NotFoundError, "nonce #{nonce.inspect} locked, consumed, or not found"
     end
 
-    # Deprecated in favor of PaymentMethodGateway.grant
-    def grant(token, allow_vaulting)
-      @gateway.payment_method.grant(token, allow_vaulting)
-    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(CreditCardGateway._update_signature, attributes)
       _do_update(:put, "/payment_methods/credit_card/#{token}", :credit_card => attributes)
     end
@@ -85,38 +83,54 @@ module Braintree
       return_object_or_raise(:credit_card) { update(*args) }
     end
 
-    # Deprecated
-    def update_from_transparent_redirect(query_string)
-      warn "[DEPRECATED] CreditCard.update_via_transparent_redirect_request is deprecated. Please use TransparentRedirect.confirm"
-      params = @gateway.transparent_redirect.parse_and_validate_query_string query_string
-      _do_update(:post, "/payment_methods/all/confirm_transparent_redirect_request", :id => params[:id])
-    end
-
-    # Deprecated
-    def update_credit_card_url
-      warn "[DEPRECATED] CreditCard.update_credit_card_url is deprecated. Please use TransparentRedirect.url"
-      "#{@config.base_merchant_url}/payment_methods/all/update_via_transparent_redirect_request"
-    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._signature(type) # :nodoc:
+    def self._signature(type)
       billing_address_params = AddressGateway._shared_signature
-      options = [:make_default, :verification_merchant_account_id, :verify_card, :verification_amount, :venmo_sdk_session, :fail_on_duplicate_payment_method, :verification_account_type]
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_session
+      # The old venmo SDK class has been deprecated
+      options = [
+        :fail_on_duplicate_payment_method,
+        :fail_on_duplicate_payment_method_for_customer,
+        :make_default,
+        :skip_advanced_fraud_checking,
+        :venmo_sdk_session, # Deprecated
+        :verification_account_type,
+        :verification_amount,
+        :verification_currency_iso_code,
+        :verification_merchant_account_id,
+        :verify_card
+      ]
+      # 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,
+        {:external_vault => [:network_transaction_id]},
         {: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
         signature << :customer_id
@@ -129,7 +143,7 @@ module Braintree
       return signature
     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[:credit_card]
         SuccessfulResult.new(:credit_card => CreditCard._new(@gateway, response[:credit_card]))
@@ -140,7 +154,7 @@ module Braintree
       end
     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[:credit_card]
         SuccessfulResult.new(:credit_card => CreditCard._new(@gateway, response[:credit_card]))
@@ -151,16 +165,16 @@ module Braintree
       end
     end
 
-    def _fetch_expired(ids) # :nodoc:
+    def _fetch_expired(ids)
       response = @config.http.post("#{@config.base_merchant_path}/payment_methods/all/expired", :search => {:ids => ids})
       attributes = response[:payment_methods]
       Util.extract_attribute_as_array(attributes, :credit_card).map { |attrs| CreditCard._new(@gateway, attrs) }
     end
 
-    def _fetch_expiring_between(formatted_start_date, formatted_end_date, ids) # :nodoc:
+    def _fetch_expiring_between(formatted_start_date, formatted_end_date, ids)
       response = @config.http.post(
         "#{@config.base_merchant_path}/payment_methods/all/expiring?start=#{formatted_start_date}&end=#{formatted_end_date}",
-        :search => {:ids => ids}
+        :search => {:ids => ids},
       )
       attributes = response[:payment_methods]
       Util.extract_attribute_as_array(attributes, :credit_card).map { |attrs| CreditCard._new(@gateway, attrs) }

data/lib/braintree/credit_card_verification.rb

@@ -3,16 +3,31 @@ module Braintree
     include BaseModule
     include Braintree::Util::IdEquality
 
+    module GatewayRejectionReason
+      ApplicationIncomplete = "application_incomplete"
+      AVS          = "avs"
+      AVSAndCVV    = "avs_and_cvv"
+      CVV          = "cvv"
+      Duplicate    = "duplicate"
+      Fraud        = "fraud"
+      RiskThreshold = "risk_threshold"
+      ThreeDSecure = "three_d_secure"
+      TokenIssuance = "token_issuance"
+      Unrecognized = "unrecognized"
+    end
+
     module Status
-      Failed = 'failed'
-      GatewayRejected = 'gateway_rejected'
-      ProcessorDeclined = 'processor_declined'
-      Verified = 'verified'
+      Failed = "failed"
+      GatewayRejected = "gateway_rejected"
+      ProcessorDeclined = "processor_declined"
+      Verified = "verified"
 
       All = [Failed, GatewayRejected, ProcessorDeclined, Verified]
     end
 
     attr_reader :amount
+    attr_reader :ani_first_name_response_code
+    attr_reader :ani_last_name_response_code
     attr_reader :avs_error_response_code
     attr_reader :avs_postal_code_response_code
     attr_reader :avs_street_address_response_code
@@ -22,18 +37,20 @@ module Braintree
     attr_reader :currency_iso_code
     attr_reader :cvv_response_code
     attr_reader :gateway_rejection_reason
+    attr_reader :graphql_id
     attr_reader :id
     attr_reader :merchant_account_id
     attr_reader :network_response_code
     attr_reader :network_response_text
+    attr_reader :network_transaction_id
     attr_reader :processor_response_code
     attr_reader :processor_response_text
     attr_reader :processor_response_type
     attr_reader :risk_data
-    attr_reader :three_d_secure_info
     attr_reader :status
+    attr_reader :three_d_secure_info
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
 
       @amount = Util.to_big_decimal(amount)
@@ -42,25 +59,27 @@ module Braintree
       @three_d_secure_info = ThreeDSecureInfo.new(attributes[:three_d_secure_info]) if attributes[:three_d_secure_info]
     end
 
-    def inspect # :nodoc:
+    def inspect
       attr_order = [
-        :status,
-        :processor_response_code,
-        :processor_response_text,
         :amount,
-        :currency_iso_code,
-        :cvv_response_code,
+        :ani_first_name_response_code,
+        :ani_last_name_response_code,
         :avs_error_response_code,
         :avs_postal_code_response_code,
         :avs_street_address_response_code,
-        :network_response_code,
-        :network_response_text,
-        :merchant_account_id,
+        :billing,
+        :created_at,
+        :credit_card,
+        :currency_iso_code,
+        :cvv_response_code,
         :gateway_rejection_reason,
         :id,
-        :credit_card,
-        :billing,
-        :created_at
+        :merchant_account_id,
+        :network_response_code,
+        :network_response_text,
+        :processor_response_code,
+        :processor_response_text,
+        :status
       ]
       formatted_attrs = attr_order.map do |attr|
         if attr == :amount
@@ -76,8 +95,8 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
 
     def self.find(*args)

data/lib/braintree/credit_card_verification_gateway.rb

@@ -46,11 +46,41 @@ module Braintree
 
     def self._create_signature
       [
-         {:options => [:amount, :merchant_account_id, :account_type]},
-         {:credit_card => [
-           :cardholder_name, :cvv, :expiration_date, :expiration_month, :expiration_year,
-           :number, {:billing_address => AddressGateway._shared_signature}
-         ]}
+        {:credit_card => [
+          {:billing_address => AddressGateway._shared_signature},
+          :cardholder_name,
+          :cvv,
+          :expiration_date,
+          :expiration_month,
+          :expiration_year,
+          :number,
+        ]},
+        {:external_vault => [
+          :previous_network_transaction_id,
+          :status,
+        ]},
+        :intended_transaction_source,
+        {:options => [
+          :account_type,
+          :amount,
+          :merchant_account_id,
+        ]},
+        :payment_method_nonce,
+        {:risk_data => [
+          :customer_browser,
+          :customer_ip,
+        ]},
+        :three_d_secure_authentication_id,
+        {:three_d_secure_pass_thru => [
+          :authentication_response,
+          :cavv,
+          :cavv_algorithm,
+          :directory_response,
+          :ds_transaction_id,
+          :eci_flag,
+          :three_d_secure_version,
+          :xid,
+        ]},
       ]
     end
   end

data/lib/braintree/credit_card_verification_search.rb

@@ -1,12 +1,12 @@
 module Braintree
-  class CreditCardVerificationSearch < AdvancedSearch # :nodoc:
+  class CreditCardVerificationSearch < AdvancedSearch
      text_fields(
        :billing_address_details_postal_code,
        :credit_card_cardholder_name,
        :customer_email,
        :customer_id,
        :id,
-       :payment_method_token
+       :payment_method_token,
      )
 
     equality_fields :credit_card_expiration_date