braintree 2.104.0 → 4.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5e73505966566953ef5df2f2e366b104d0ba4bae9fe485759a4cd2048100d75
-  data.tar.gz: 5909d63f9c589f1c0ac70bd55c8b4eda61cd52fcaf53d46c1030ef7b18ffe1ec
+  metadata.gz: a83d6966dbe837625c68efa0fdee683820705fba7c4c1f65118892d61ea2261b
+  data.tar.gz: f947bda53f860763dc3c57080ded11b1823e9c48e71efb05a89bb0490e7dad79
 SHA512:
-  metadata.gz: e2012367a1bc709459b1a65828ea01aa851d0e491e9071dee4ce8797603b75cf3f412f6ededf628e713d55bdc095762f50fc500e77519d8ec485679aa0033a92
-  data.tar.gz: f7724b06f9b4447fe2051f50fa0c0f62e96d43342cf09e048fc8522ee0bb29e38d0fe35ab938fe1b16202e3a77be67d20b038d920eb4acc4e82db2416d555537
+  metadata.gz: f9a82a773ef66320358e028dbb9a403f6bcc97d7c32d727bff0b00a2936ab54ae8bbfba201024a7e8d5956ef17be0247b61f0e8e3cc23aecb819a5e77d833a9a
+  data.tar.gz: 21a069ff7615e48429c6882ed354334f37fd7e0600e6696b97b000178a03531955d6156dcd77b3927bc2d35a144ecafa07d65d2b6d9566d5202630bfac62cb37

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009-2017 Braintree, a division of PayPal, Inc.
+Copyright (c) 2009-2020 Braintree, a division of PayPal, Inc.
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/braintree.gemspec

@@ -1,21 +1,24 @@
 $:.push File.expand_path("../lib", __FILE__)
-require 'braintree/version'
+require "braintree/version"
 
 Gem::Specification.new do |s|
   s.name = "braintree"
-  s.summary = "Braintree Gateway Ruby Client Library"
-  s.description = "Ruby library for integrating with the Braintree Gateway"
+  s.summary = "Braintree Ruby Server SDK"
+  s.description = "Resources and tools for developers to integrate Braintree's global payments platform."
   s.version = Braintree::Version::String
   s.license = "MIT"
   s.author = "Braintree"
   s.email = "code@getbraintree.com"
   s.homepage = "https://www.braintreepayments.com/"
   s.files = Dir.glob ["README.rdoc", "LICENSE", "lib/**/*.{rb,crt}", "spec/**/*", "*.gemspec"]
-  s.add_dependency "builder", ">= 2.0.0"
+  s.add_dependency "builder", ">= 3.2.4"
+  s.add_dependency "rexml", ">= 3.1.9" # Use rexml version associated with minimum supported Ruby version
+  s.required_ruby_version = ">=2.6.0"
   s.metadata = {
     "bug_tracker_uri" => "https://github.com/braintree/braintree_ruby/issues",
     "changelog_uri" => "https://github.com/braintree/braintree_ruby/blob/master/CHANGELOG.md",
     "source_code_uri" => "https://github.com/braintree/braintree_ruby",
+    "documentation_uri" => "https://developer.paypal.com/braintree/docs"
   }
 end
 

data/lib/braintree/account_updater_daily_report.rb

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

data/lib/braintree/address.rb

@@ -14,6 +14,7 @@ module Braintree
     attr_reader :id
     attr_reader :last_name
     attr_reader :locality
+    attr_reader :phone_number
     attr_reader :postal_code
     attr_reader :region
     attr_reader :street_address
@@ -53,34 +54,12 @@ module Braintree
       id == other.id && customer_id == other.customer_id
     end
 
-    # Deprecated. Use Braintree::Address.delete
-    def delete
-      warn "[DEPRECATED] delete as an instance method is deprecated. Please use Address.delete"
-      @gateway.address.delete(customer_id, self.id)
-    end
-
-    # Deprecated. Use Braintree::Address.update
-    def update(attributes)
-      warn "[DEPRECATED] update as an instance method is deprecated. Please use Address.update"
-      result = @gateway.address.update(customer_id, id, attributes)
-      if result.success?
-        copy_instance_variables_from_object result.address
-      end
-      result
-    end
-
-    # Deprecated. Use Braintree::Address.update!
-    def update!(attributes)
-      warn "[DEPRECATED] update! as an instance method is deprecated. Please use Address.update!"
-      return_object_or_raise(:address) { update(attributes) }
-    end
-
     class << self
       protected :new
     end
 
     def self._new(*args) # :nodoc:
-      self.new *args
+      self.new(*args)
     end
   end
 end

data/lib/braintree/apple_pay.rb

@@ -11,7 +11,7 @@ module Braintree
     end
 
     def self._new(*args) # :nodoc:
-      self.new *args
+      self.new(*args)
     end
 
     def self.register_domain(domain)

data/lib/braintree/apple_pay_card.rb

@@ -12,15 +12,25 @@ module Braintree
 
     attr_reader :bin
     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 :debit
     attr_reader :default
+    attr_reader :durbin_regulated
     attr_reader :expiration_month
     attr_reader :expiration_year
     attr_reader :expired
+    attr_reader :healthcare
     attr_reader :image_url
+    attr_reader :issuing_bank
     attr_reader :last_4
     attr_reader :payment_instrument_name
+    attr_reader :payroll
+    attr_reader :prepaid
+    attr_reader :product_id
     attr_reader :source_description
     attr_reader :subscriptions
     attr_reader :token
@@ -45,7 +55,7 @@ module Braintree
     end
 
     def self._new(*args) # :nodoc:
-      self.new *args
+      self.new(*args)
     end
   end
 end

data/lib/braintree/apple_pay_options.rb

@@ -13,7 +13,7 @@ module Braintree
     end
 
     def self._new(*args) # :nodoc:
-      self.new *args
+      self.new(*args)
     end
   end
 end

data/lib/braintree/authorization_adjustment.rb

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

data/lib/braintree/base_module.rb

@@ -20,6 +20,12 @@ module Braintree
         hash.each do |key, value|
           if key == :global_id
             instance_variable_set "@graphql_id", value
+          elsif key == :android_pay_cards
+            instance_variable_set "@google_pay_cards", value
+          elsif key == :android_pay_card
+            instance_variable_set "@google_pay_card", value
+          elsif key == :android_pay_details
+            instance_variable_set "@google_pay_details", value
           end
 
           instance_variable_set "@#{key}", value

data/lib/braintree/bin_data.rb

@@ -17,10 +17,17 @@ module Braintree
     end
 
     def inspect
-      formatted_attrs = self.class._attributes.map do |attr|
+      formatted_attributes = self.class._attributes.map do |attr|
         "#{attr}: #{send(attr).inspect}"
       end
-      "#<BinData #{formatted_attrs.join(", ")}>"
+      "#<#{self.class} #{formatted_attributes.join(", ")}>"
+    end
+
+    def self._attributes # :nodoc:
+      [
+        :commercial, :country_of_issuance, :debit, :durbin_regulated, :healthcare,
+        :issuing_bank, :payroll, :prepaid, :product_id
+      ]
     end
   end
 end

data/lib/braintree/client_token.rb

@@ -1,4 +1,4 @@
-require 'json'
+require "json"
 
 module Braintree
   module ClientToken

data/lib/braintree/configuration.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Configuration
-    API_VERSION = "5" # :nodoc:
+    API_VERSION = "6" # :nodoc:
     DEFAULT_ENDPOINT = "api" # :nodoc:
     GRAPHQL_API_VERSION = "2018-09-10" # :nodoc:
 
@@ -40,12 +40,12 @@ module Braintree
     ]
 
     class << self
-      attr_writer *WRITABLE_ATTRIBUTES
-      attr_reader *NON_REQUIRED_READABLE_ATTRIBUTES
+      attr_writer(*WRITABLE_ATTRIBUTES)
+      attr_reader(*NON_REQUIRED_READABLE_ATTRIBUTES)
     end
-    attr_reader *READABLE_ATTRIBUTES
-    attr_reader *NON_REQUIRED_READABLE_ATTRIBUTES
-    attr_writer *WRITABLE_ATTRIBUTES
+    attr_reader(*READABLE_ATTRIBUTES)
+    attr_reader(*NON_REQUIRED_READABLE_ATTRIBUTES)
+    attr_writer(*WRITABLE_ATTRIBUTES)
 
     def self.expectant_reader(*attributes) # :nodoc:
       attributes.each do |attribute|
@@ -56,7 +56,7 @@ module Braintree
         end
       end
     end
-    expectant_reader *READABLE_ATTRIBUTES
+    expectant_reader(*READABLE_ATTRIBUTES)
 
     # Sets the Braintree environment to use. Valid values are <tt>:sandbox</tt> and <tt>:production</tt>
     def self.environment=(env)
@@ -86,7 +86,7 @@ module Braintree
         :proxy_port => proxy_port,
         :proxy_user => proxy_user,
         :proxy_pass => proxy_pass,
-        :ssl_version => ssl_version
+        :ssl_version => ssl_version,
       )
     end
 
@@ -205,7 +205,7 @@ module Braintree
     def port # :nodoc:
       case @environment
       when :development, :integration
-        ENV['GATEWAY_PORT'] || 3000
+        ENV["GATEWAY_PORT"] || 3000
       when :production, :qa, :sandbox
         443
       end
@@ -214,7 +214,7 @@ module Braintree
     def graphql_port # :nodoc:
       case @environment
       when :development, :integration
-        ENV['GRAPHQL_PORT'] || 8080
+        ENV["GRAPHQL_PORT"] || 8080
       when :production, :qa, :sandbox
         443
       end
@@ -235,7 +235,7 @@ module Braintree
     def server # :nodoc:
       case @environment
       when :development, :integration
-        ENV['GATEWAY_HOST'] || "localhost"
+        ENV["GATEWAY_HOST"] || "localhost"
       when :production
         "#{endpoint}.braintreegateway.com"
       when :qa
@@ -248,7 +248,7 @@ module Braintree
     def graphql_server # :nodoc:
       case @environment
       when :development, :integration
-        ENV['GRAPHQL_HOST'] || "graphql.bt.local"
+        ENV["GRAPHQL_HOST"] || "graphql.bt.local"
       when :production
         "payments.braintree-api.com"
       when :qa

data/lib/braintree/connected_merchant_paypal_status_changed.rb

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

data/lib/braintree/connected_merchant_status_transitioned.rb

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

data/lib/braintree/credit_card.rb

@@ -70,18 +70,6 @@ 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
-
     def self.credit(token, transaction_attributes)
       Transaction.credit(transaction_attributes.merge(:payment_method_token => token))
     end
@@ -110,11 +98,6 @@ 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
-
     def self.sale(token, transaction_attributes)
       Configuration.gateway.transaction.sale(transaction_attributes.merge(:payment_method_token => token))
     end
@@ -131,18 +114,6 @@ 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:
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
@@ -152,28 +123,10 @@ module Braintree
     end
 
     def _most_recent_verification(attributes)
-      verification = (attributes[:verifications] || []).sort_by{ |verification| verification[:created_at] }.reverse.first
+      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))
-    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
@@ -202,34 +155,6 @@ 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
@@ -256,7 +181,7 @@ module Braintree
     end
 
     def self._new(*args) # :nodoc:
-      self.new *args
+      self.new(*args)
     end
   end
 end

data/lib/braintree/credit_card_gateway.rb

@@ -20,17 +20,6 @@ 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
-
     def credit(token, transaction_attributes)
       @gateway.transaction.credit(transaction_attributes.merge(:payment_method_token => token))
     end
@@ -49,8 +38,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,11 +60,6 @@ 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)
       Util.verify_keys(CreditCardGateway._update_signature, attributes)
       _do_update(:put, "/payment_methods/credit_card/#{token}", :credit_card => attributes)
@@ -85,19 +69,6 @@ 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:
       _signature(:create)
     end
@@ -108,11 +79,21 @@ module Braintree
 
     def self._signature(type) # :nodoc:
       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]
+      options = [
+        :fail_on_duplicate_payment_method,
+        :make_default,
+        :skip_advanced_fraud_checking,
+        :venmo_sdk_session,
+        :verification_account_type,
+        :verification_amount,
+        :verification_currency_iso_code,
+        :verification_merchant_account_id,
+        :verify_card
+      ]
       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, :device_data,
+        :payment_method_nonce,
         {:external_vault => [:network_transaction_id]},
         {:options => options},
         {:billing_address => billing_address_params}
@@ -174,7 +155,7 @@ module Braintree
     def _fetch_expiring_between(formatted_start_date, formatted_end_date, ids) # :nodoc:
       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,11 +3,24 @@ 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
@@ -79,7 +92,7 @@ module Braintree
     end
 
     def self._new(*args) # :nodoc:
-      self.new *args
+      self.new(*args)
     end
 
     def self.find(*args)

data/lib/braintree/credit_card_verification_search.rb

@@ -6,7 +6,7 @@ module Braintree
        :customer_email,
        :customer_id,
        :id,
-       :payment_method_token
+       :payment_method_token,
      )
 
     equality_fields :credit_card_expiration_date