braintree 3.4.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85d22ee560b343f4bbd3f71272f4e9d5cfaa83672ddc36fceb9fc383b25772e3
-  data.tar.gz: 8d29ee6fcd9b7f6ccbab6680029b66c70e53867448b369af806feb454cfdb18c
+  metadata.gz: a48854f74d17f7c0f06f437ab9cf144f6787cdb634cb4585b96cbf0e8b3eb316
+  data.tar.gz: e278599e9a4fe1ec55ed4c25a0c2941c256815adff6240f24d7326dda3c7979b
 SHA512:
-  metadata.gz: d35fdc8ebf0d555649b08e401b4b16f6ac58ee52ca3fdb6a0ce899b10a4c7b2db94873fdb940649941c105cf9ca44686a415a9760619be4e7f5d7d9b33883e81
-  data.tar.gz: 687c698cd56953bc23694112256bfe422b53e0a0f0697e5c6626567933ecaab332a1fc6732f4085747ef68178a1d76d6f76a372ec070feb365c8557db8301f51
+  metadata.gz: dbe42e3ee49bffddde129c228d9dc9ea9a8e7615140d184211378d58add503f13a666f2aaf8c393fafbb330db77685a5953b10344c712da5719c630f1ab64e5a
+  data.tar.gz: ae8af00364f7853fb0e6eb82f585ebc30015f0b6ac7014f41eccdfe732348f3b3f715b474afc516b17b913550f9ae339b587a53296cc823bb30c5954ecbda146

data/braintree.gemspec

@@ -12,8 +12,7 @@ Gem::Specification.new do |s|
   s.homepage = "https://www.braintreepayments.com/"
   s.files = Dir.glob ["README.rdoc", "LICENSE", "lib/**/*.{rb,crt}", "spec/**/*", "*.gemspec"]
   s.add_dependency "builder", ">= 3.2.4"
-  s.add_dependency "libxml-ruby", ">= 3.2.0"
-  s.required_ruby_version = ">=2.5.0"
+  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",

data/lib/braintree.rb

@@ -59,6 +59,7 @@ require "braintree/discount_gateway"
 require "braintree/dispute"
 require "braintree/dispute_gateway"
 require "braintree/dispute/evidence"
+require "braintree/dispute/paypal_message"
 require "braintree/dispute/status_history"
 require "braintree/dispute/transaction"
 require "braintree/dispute/transaction_details"
@@ -87,6 +88,8 @@ require "braintree/payment_instrument_type"
 require "braintree/payment_method"
 require "braintree/payment_method_gateway"
 require "braintree/payment_method_nonce"
+require "braintree/payment_method_nonce_details"
+require "braintree/payment_method_nonce_details_payer_info"
 require "braintree/payment_method_nonce_gateway"
 require "braintree/payment_method_parser"
 require "braintree/paypal_account"
@@ -160,4 +163,5 @@ require "braintree/webhook_testing_gateway"
 require "braintree/xml"
 require "braintree/xml/generator"
 require "braintree/xml/libxml"
+require "braintree/xml/rexml"
 require "braintree/xml/parser"

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

data/lib/braintree/customer.rb

@@ -19,6 +19,7 @@ module Braintree
     attr_reader :paypal_accounts
     attr_reader :phone
     attr_reader :samsung_pay_cards
+    attr_reader :tax_identifiers
     attr_reader :updated_at
     attr_reader :us_bank_accounts
     attr_reader :venmo_accounts
@@ -90,6 +91,7 @@ module Braintree
       @visa_checkout_cards = (@visa_checkout_cards|| []).map { |pm| VisaCheckoutCard._new gateway, pm }
       @samsung_pay_cards = (@samsung_pay_cards|| []).map { |pm| SamsungPayCard._new gateway, pm }
       @addresses = (@addresses || []).map { |addr| Address._new gateway, addr }
+      @tax_identifiers = (@tax_identifiers || []).map { |addr| TaxIdentifier._new gateway, addr }
       @custom_fields = attributes[:custom_fields].is_a?(Hash) ? attributes[:custom_fields] : {}
     end
 
@@ -124,7 +126,7 @@ module Braintree
 
     def inspect # :nodoc:
       first = [:id]
-      last = [:addresses, :credit_cards, :paypal_accounts]
+      last = [:addresses, :credit_cards, :paypal_accounts, :tax_identifiers]
       order = first + (self.class._attributes - first - last) + last
       nice_attributes = order.map do |attr|
         "#{attr}: #{send(attr).inspect}"
@@ -148,7 +150,7 @@ module Braintree
     def self._attributes # :nodoc:
       [
         :addresses, :company, :credit_cards, :email, :fax, :first_name, :id, :last_name, :phone, :website,
-        :created_at, :updated_at
+        :created_at, :updated_at, :tax_identifiers
       ]
     end
 

data/lib/braintree/customer_gateway.rb

@@ -80,6 +80,7 @@ module Braintree
         {:risk_data => [:customer_browser, :customer_ip]},
         {:credit_card => credit_card_signature},
         {:paypal_account => paypal_account_signature},
+        {:tax_identifiers => [:country_code, :identifier]},
         {:options => options},
         {:custom_fields => :_any_key_}
       ]
@@ -141,6 +142,7 @@ module Braintree
         :company, :email, :fax, :first_name, :id, :last_name, :phone, :website,
         :device_data, :payment_method_nonce, :default_payment_method_token,
         {:credit_card => credit_card_signature},
+        {:tax_identifiers => [:country_code, :identifier]},
         {:options => options},
         {:custom_fields => :_any_key_}
       ]

data/lib/braintree/dispute.rb

@@ -7,6 +7,7 @@ module Braintree
     attr_reader :amount_disputed
     attr_reader :amount_won
     attr_reader :case_number
+    attr_reader :chargeback_protection_level
     attr_reader :created_at
     attr_reader :currency_iso_code
     attr_reader :date_opened
@@ -17,6 +18,7 @@ module Braintree
     attr_reader :kind
     attr_reader :merchant_account_id
     attr_reader :original_dispute_id
+    attr_reader :paypal_messages
     attr_reader :processor_comments
     attr_reader :reason
     attr_reader :reason_code
@@ -65,6 +67,14 @@ module Braintree
       All = constants.map { |c| const_get(c) }
     end
 
+    module ChargebackProtectionLevel
+      Effortless = "effortless"
+      Standard = "standard"
+      NotProtected = "not_protected"
+
+      All = constants.map { |c| const_get(c) }
+    end
+
     class << self
       protected :new
       def _new(*args) # :nodoc:
@@ -114,6 +124,10 @@ module Braintree
         Braintree::Dispute::Evidence.new(record)
       end unless evidence.nil?
 
+      @paypal_messages = paypal_messages.map do |record|
+        Braintree::Dispute::PayPalMessage.new(record)
+      end unless paypal_messages.nil?
+
       @transaction_details = TransactionDetails.new(transaction)
       @transaction = Transaction.new(transaction)
 

data/lib/braintree/dispute/paypal_message.rb

@@ -0,0 +1,15 @@
+module Braintree
+  class Dispute
+    class PayPalMessage # :nodoc:
+      include BaseModule
+
+      attr_reader :message,
+        :sender,
+        :sent_at
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+      end
+    end
+  end
+end

data/lib/braintree/dispute_search.rb

@@ -8,6 +8,7 @@ module Braintree
       :transaction_id,
     )
 
+    multiple_value_field :chargeback_protection_level, :allows => Dispute::ChargebackProtectionLevel::All
     multiple_value_field :kind, :allows => Dispute::Kind::All
     multiple_value_field :merchant_account_id
     multiple_value_field :reason, :allows => Dispute::Reason::All

data/lib/braintree/error_codes.rb

@@ -517,8 +517,6 @@ module Braintree
       end
 
       module ExternalVault
-        # NEXT_MAJOR_VERSION remove this validation error as it is no longer returned by the gateway
-        CardTypeIsInvalid = "915178"
         PreviousNetworkTransactionIdIsInvalid = "915179"
         StatusIsInvalid = "915175"
         StatusWithPreviousNetworkTransactionIdIsInvalid = "915177"
@@ -786,8 +784,6 @@ module Braintree
     end
 
     module RiskData
-      # NEXT_MAJOR_VERSION Remove CustomerBrowserIsTooLong (this validation is no longer applied)
-      CustomerBrowserIsTooLong = "94701"
       CustomerDeviceIdIsTooLong = "94702"
       CustomerLocationZipInvalidCharacters = "94703"
       CustomerLocationZipIsInvalid = "94704"

data/lib/braintree/payment_method_gateway.rb

@@ -186,8 +186,6 @@ module Braintree
         options << :fail_on_duplicate_payment_method
         signature << :customer_id
         signature << :paypal_refresh_token
-        # NEXT_MAJOR_VERSION remove this from the signature
-        signature << :paypal_vault_without_upgrade
       when :update
         billing_address_params << {:options => [:update_existing]}
       else

data/lib/braintree/payment_method_nonce.rb

@@ -25,7 +25,7 @@ module Braintree
       @gateway = gateway
       @nonce = attributes.fetch(:nonce)
       @type = attributes.fetch(:type)
-      @details = attributes.fetch(:details)
+      @details = PaymentMethodNonceDetails.new(attributes[:details]) if attributes[:details]
       @authentication_insight = attributes.fetch(:authentication_insight, nil)
       @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]

data/lib/braintree/payment_method_nonce_details.rb

@@ -0,0 +1,37 @@
+module Braintree
+  class PaymentMethodNonceDetails # :nodoc:
+    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
+
+    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]
+    end
+
+    def inspect
+      attr_order = [
+        :bin,
+        :card_type,
+        :expiration_month,
+        :expiration_year,
+        :is_network_tokenized,
+        :last_two,
+        :payer_info,
+      ]
+
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<PaymentMethodNonceDetails #{formatted_attrs.join(", ")}>"
+    end
+  end
+end

data/lib/braintree/payment_method_nonce_details_payer_info.rb

@@ -0,0 +1,32 @@
+module Braintree
+  class PaymentMethodNonceDetailsPayerInfo # :nodoc:
+    include BaseModule
+
+    attr_reader :billing_agreement_id
+    attr_reader :country_code
+    attr_reader :email
+    attr_reader :first_name
+    attr_reader :last_name
+    attr_reader :payer_id
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+    end
+
+    def inspect
+      attr_order = [
+        :billing_agreement_id,
+        :country_code,
+        :email,
+        :first_name,
+        :last_name,
+        :payer_id,
+      ]
+
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<PaymentMethodNonceDetailsPayerInfo #{formatted_attrs.join(", ")}>"
+    end
+  end
+end

data/lib/braintree/version.rb

@@ -1,7 +1,7 @@
 module Braintree
   module Version
-    Major = 3
-    Minor = 4
+    Major = 4
+    Minor = 0
     Tiny = 0
 
     String = "#{Major}.#{Minor}.#{Tiny}"

data/lib/braintree/xml/libxml.rb

@@ -1,4 +1,3 @@
-require "libxml"
 # Portions of this code were copied and modified from Ruby on Rails, released
 # under the MIT license, copyright (c) 2005-2009 David Heinemeier Hansson
 module Braintree

data/lib/braintree/xml/parser.rb

@@ -11,12 +11,22 @@ module Braintree
         "boolean"  => Proc.new { |boolean| %w(1 true).include?(boolean.strip) },
       }
 
-      def self.hash_from_xml(xml)
-        standardized_hash_structure = ::Braintree::Xml::Libxml.parse(xml)
+      def self.hash_from_xml(xml, parser = _determine_parser)
+        standardized_hash_structure = parser.parse(xml)
         transformed_xml = _transform_xml(standardized_hash_structure)
         Util.symbolize_keys(transformed_xml)
       end
 
+      def self._determine_parser
+        # If LibXML is not available, we fall back to REXML
+        # This allows us to be compatible with JRuby, which LibXML does not support
+        if defined?(::LibXML::XML) && ::LibXML::XML.respond_to?(:default_keep_blanks=)
+          ::Braintree::Xml::Libxml
+        else
+          ::Braintree::Xml::Rexml
+        end
+      end
+
       # Transform into standard Ruby types and convert all keys to snake_case instead of dash-case
       def self._transform_xml(value)
         case value.class.to_s

data/lib/braintree/xml/rexml.rb

@@ -0,0 +1,70 @@
+# Portions of this code were copied and modified from Ruby on Rails, released
+# under the MIT license, copyright (c) 2005-2009 David Heinemeier Hansson
+module Braintree
+  module Xml # :nodoc:
+    module Rexml # :nodoc:
+
+      CONTENT_KEY = "__content__".freeze
+
+      def self.parse(string)
+        require "rexml/document" unless defined?(REXML::Document)
+        doc = REXML::Document.new(string)
+        _merge_element!({}, doc.root)
+      end
+
+      def self._merge_element!(hash, element)
+        _merge!(hash, element.name, _collapse(element))
+      end
+
+      def self._collapse(element)
+        hash = _get_attributes(element)
+
+        if element.has_elements?
+          element.each_element { |child| _merge_element!(hash, child) }
+          _merge_texts!(hash, element) unless _empty_content?(element)
+          hash
+        else
+          _merge_texts!(hash, element)
+        end
+      end
+
+      def self._merge_texts!(hash, element)
+        unless element.has_text?
+          hash
+        else
+          # must use value to prevent double-escaping
+          _merge!(
+            hash,
+            CONTENT_KEY,
+            element.texts.map { |t| t.value }.join,
+          )
+        end
+      end
+
+      def self._merge!(hash, key, value)
+        if hash.has_key?(key)
+          if hash[key].instance_of?(Array)
+            hash[key] << value
+          else
+            hash[key] = [hash[key], value]
+          end
+        elsif value.instance_of?(Array)
+          hash[key] = [value]
+        else
+          hash[key] = value
+        end
+        hash
+      end
+
+      def self._get_attributes(element)
+        attributes = {}
+        element.attributes.each { |n,v| attributes[n] = v }
+        attributes
+      end
+
+      def self._empty_content?(element)
+        element.texts.join.strip == ""
+      end
+    end
+  end
+end

data/spec/integration/braintree/address_spec.rb

@@ -14,6 +14,7 @@ describe Braintree::Address do
         :extended_address => "Suite 200",
         :locality => "Chicago",
         :region => "Illinois",
+        :phone_number => "5551231234",
         :postal_code => "60622",
         :country_name => "United States of America",
       )
@@ -26,6 +27,7 @@ describe Braintree::Address do
       result.address.extended_address.should == "Suite 200"
       result.address.locality.should == "Chicago"
       result.address.region.should == "Illinois"
+      result.address.phone_number.should == "5551231234"
       result.address.postal_code.should == "60622"
       result.address.country_name.should == "United States of America"
       result.address.country_code_alpha2.should == "US"
@@ -131,6 +133,7 @@ describe Braintree::Address do
         :extended_address => "Suite 201",
         :locality => "Bartlett",
         :region => "IL",
+        :phone_number => "5551231234",
         :postal_code => "60623",
         :country_name => "United States of America",
       )
@@ -139,6 +142,7 @@ describe Braintree::Address do
       address.extended_address.should == "Suite 201"
       address.locality.should == "Bartlett"
       address.region.should == "IL"
+      address.phone_number.should == "5551231234"
       address.postal_code.should == "60623"
       address.country_name.should == "United States of America"
     end

data/spec/integration/braintree/customer_spec.rb

@@ -40,6 +40,7 @@ describe Braintree::Customer do
         :phone => "312.555.1234",
         :fax => "614.555.5678",
         :website => "www.microsoft.com",
+        :tax_identifiers => [{:country_code => "US", :identifier => "987654321"}],
       )
       result.success?.should == true
       result.customer.id.should =~ /^\d{6,}$/
@@ -114,6 +115,17 @@ describe Braintree::Customer do
       result.should be_success
     end
 
+    it "supports creation with tax_identifiers" do
+      result = Braintree::Customer.create(
+        :tax_identifiers => [
+          {:country_code => "US", :identifier => "987654321"},
+          {:country_code => "CL", :identifier => "123456789"}
+        ],
+      )
+
+      result.should be_success
+    end
+
     it "can create without any attributes" do
       result = Braintree::Customer.create
       result.success?.should == true
@@ -1333,6 +1345,21 @@ describe Braintree::Customer do
       result.success?.should == true
     end
 
+    it "can update a tax_identifier" do
+      customer = Braintree::Customer.create!(
+        :tax_identifiers => [
+          {:country_code => "US", :identifier => "987654321"},
+          {:country_code => "CL", :identifier => "123456789"}
+        ],
+      )
+
+      result = Braintree::Customer.update(
+        customer.id,
+        :tax_identifiers => [{:country_code => "US", :identifier => "567891234"}],
+      )
+      result.success?.should == true
+    end
+
     it "validates presence of three_d_secure_version in 3ds pass thru params" do
       result = Braintree::Customer.create(
         :payment_method_nonce => Braintree::Test::Nonce::ThreeDSecureVisaFullAuthentication,

data/spec/integration/braintree/dispute_search_spec.rb

@@ -78,6 +78,31 @@ describe Braintree::Dispute, "search" do
       dispute = collection.disputes.first
     end
 
+    it "correctly returns chargeback protected disputes" do
+      collection = Braintree::Dispute.search do |search|
+        search.case_number.is "CASE-CHARGEBACK-PROTECTED"
+      end
+
+      expect(collection.disputes.count).to eq(1)
+      dispute = collection.disputes.first
+
+      expect(dispute.chargeback_protection_level).to eq(Braintree::Dispute::ChargebackProtectionLevel::Effortless)
+      expect(dispute.reason).to eq(Braintree::Dispute::Reason::Fraud)
+    end
+
+    it "correctly returns disputes by chargeback protection level flag" do
+      collection = Braintree::Dispute.search do |search|
+        search.chargeback_protection_level.in [
+          Braintree::Dispute::ChargebackProtectionLevel::Effortless
+        ]
+      end
+      expect(collection.disputes.count).to eq(1)
+      dispute = collection.disputes.first
+
+      expect(dispute.chargeback_protection_level).to eq(Braintree::Dispute::ChargebackProtectionLevel::Effortless)
+      expect(dispute.reason).to eq(Braintree::Dispute::Reason::Fraud)
+    end
+
     it "correctly returns disputes by effective_date range" do
       effective_date = transaction.disputes.first.status_history.first.effective_date
 

data/spec/integration/braintree/payment_method_nonce_spec.rb

@@ -79,33 +79,24 @@ describe Braintree::PaymentMethodNonce do
       result.should be_success
       nonce.nonce.should == "fake-valid-nonce"
       nonce.type.should == "CreditCard"
-      nonce.details.fetch(:last_two).should == "81"
-      nonce.details.fetch(:card_type).should == "Visa"
+      nonce.details.bin.should == "401288"
+      nonce.details.card_type.should == "Visa"
+      nonce.details.expiration_month.should == "12"
+      nonce.details.expiration_year.should == "2022"
+      nonce.details.is_network_tokenized?.should be_nil
+      nonce.details.last_two.should == "81"
+      nonce.details.payer_info.should be_nil
     end
 
     it "return paypal details if details exist" do
       result = Braintree::PaymentMethodNonce.find("fake-paypal-one-time-nonce")
       nonce = result.payment_method_nonce
-
-      nonce.details.fetch(:cobranded_card_label).should_not be_nil
-      nonce.details.fetch(:shipping_option_id).should_not be_nil
-      nonce.details.fetch(:billing_address).fetch(:recipient_name).should_not be_nil
-      nonce.details.fetch(:shipping_address).fetch(:recipient_name).should_not be_nil
-
-      nonce.details.fetch(:payer_info).fetch(:first_name).should_not be_nil
-      nonce.details.fetch(:payer_info).fetch(:last_name).should_not be_nil
-      nonce.details.fetch(:payer_info).fetch(:email).should_not be_nil
-      nonce.details.fetch(:payer_info).fetch(:payer_id).should_not be_nil
-    end
-
-    it "return venmo details if details exist" do
-      result = Braintree::PaymentMethodNonce.find("fake-venmo-account-nonce")
-
-      nonce = result.payment_method_nonce
-
-      nonce.details.fetch(:last_two).should == "99"
-      nonce.details.fetch(:username).should == "venmojoe"
-      nonce.details.fetch(:venmo_user_id).should == "Venmo-Joe-1"
+      nonce.details.payer_info.billing_agreement_id.should be_nil
+      nonce.details.payer_info.country_code.should be_nil
+      nonce.details.payer_info.email.should_not be_nil
+      nonce.details.payer_info.first_name.should_not be_nil
+      nonce.details.payer_info.last_name.should_not be_nil
+      nonce.details.payer_info.payer_id.should_not be_nil
     end
 
     it "returns null 3ds_info if there isn't any" do
@@ -131,7 +122,7 @@ describe Braintree::PaymentMethodNonce do
       nonce = result.payment_method_nonce
       result.should be_success
       nonce.details.should_not be_nil
-      nonce.details[:bin].should == "401288"
+      nonce.details.bin.should == "401288"
     end
 
     it "returns bin_data with commercial set to Yes" do

data/spec/spec_helper.rb

@@ -3,6 +3,7 @@ unless defined?(SPEC_HELPER_LOADED)
   project_root = File.expand_path(File.dirname(__FILE__) + "/..")
   require "rubygems"
   require "bundler/setup"
+  require "libxml"
   require "rspec"
   require "pry"
 

data/spec/unit/braintree/customer_spec.rb

@@ -31,6 +31,7 @@ describe Braintree::Customer do
       output.should include(%q(addresses: []))
       output.should include(%q(credit_cards: []))
       output.should include(%q(paypal_accounts: []))
+      output.should include(%q(tax_identifiers: []))
       output.should include(%Q(created_at: #{customer.created_at.inspect}))
       output.should include(%Q(updated_at: #{customer.updated_at.inspect}))
     end
@@ -133,6 +134,10 @@ describe Braintree::Customer do
           :billing_agreement_id,
           {:options => [:make_default]},
         ]},
+        {:tax_identifiers => [
+          :country_code,
+          :identifier
+        ]},
         {:options =>
           [:paypal => [
             :payee_email,
@@ -227,6 +232,10 @@ describe Braintree::Customer do
             :ds_transaction_id,
           ]},
         ]},
+        {:tax_identifiers => [
+          :country_code,
+          :identifier
+        ]},
         {:options =>
           [:paypal => [
             :payee_email,

data/spec/unit/braintree/dispute_search_spec.rb

@@ -41,6 +41,7 @@ describe Braintree::DisputeSearch do
   end
 
   [
+    :chargeback_protection_level,
     :kind,
     :reason,
     :status,

data/spec/unit/braintree/dispute_spec.rb

@@ -46,7 +46,14 @@ describe Braintree::Dispute do
         :order_id => nil,
         :purchase_order_number => "po",
         :payment_instrument_subtype => "Visa",
-      }
+      },
+      :paypal_messages => [
+        {
+          :message => "message",
+          :sender => "seller",
+          :sent_at => Time.utc(2009, 3, 9, 10, 50, 39),
+        }
+      ]
     }
   end
 
@@ -348,6 +355,16 @@ describe Braintree::Dispute do
       evidence2.url.should == nil
     end
 
+    it "converts paypal_messages hash into an array of Dispute::PayPalMessage objects" do
+      dispute = Braintree::Dispute._new(attributes)
+
+      dispute.paypal_messages.length.should == 1
+      paypal_message_1 = dispute.paypal_messages.first
+      paypal_message_1.message.should == "message"
+      paypal_message_1.sender.should == "seller"
+      paypal_message_1.sent_at.should == Time.utc(2009, 3, 9, 10, 50, 39)
+    end
+
     it "handles nil evidence" do
       attributes.delete(:evidence)
 
@@ -356,6 +373,14 @@ describe Braintree::Dispute do
       dispute.evidence.should == nil
     end
 
+    it "handles nil paypal_messages" do
+      attributes.delete(:paypal_messages)
+
+      dispute = Braintree::Dispute._new(attributes)
+
+      dispute.paypal_messages.should == nil
+    end
+
     it "sets the older webhook fields for backwards compatibility" do
       dispute = Braintree::Dispute._new(attributes)
 

data/spec/unit/braintree/payment_method_nonce_details_payer_info_spec.rb

@@ -0,0 +1,31 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../spec_helper")
+
+describe Braintree::PaymentMethodNonceDetailsPayerInfo do
+  let(:payment_method_nonce_details_payer_info) {
+    Braintree::PaymentMethodNonceDetailsPayerInfo.new(
+      :billing_agreement_id => "billing-agreement-id",
+      :country_code => "US",
+      :email => "test@example.com",
+      :first_name => "First",
+      :last_name => "Last",
+      :payer_id => "payer-id",
+    )
+  }
+
+  describe "#initialize" do
+    it "sets attributes" do
+      payment_method_nonce_details_payer_info.billing_agreement_id.should == "billing-agreement-id"
+      payment_method_nonce_details_payer_info.country_code.should == "US"
+      payment_method_nonce_details_payer_info.email.should == "test@example.com"
+      payment_method_nonce_details_payer_info.first_name.should == "First"
+      payment_method_nonce_details_payer_info.last_name.should == "Last"
+      payment_method_nonce_details_payer_info.payer_id.should == "payer-id"
+    end
+  end
+
+  describe "inspect" do
+    it "prints the attributes" do
+      payment_method_nonce_details_payer_info.inspect.should == %(#<PaymentMethodNonceDetailsPayerInfo billing_agreement_id: \"billing-agreement-id\", country_code: \"US\", email: \"test@example.com\", first_name: \"First\", last_name: \"Last\", payer_id: \"payer-id\">)
+    end
+  end
+end

data/spec/unit/braintree/payment_method_nonce_details_spec.rb

@@ -0,0 +1,43 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../spec_helper")
+
+describe Braintree::PaymentMethodNonceDetails do
+  let(:payment_method_nonce_details) {
+    Braintree::PaymentMethodNonceDetails.new(
+      :bin => "bin",
+      :card_type => "American Express",
+      :expiration_month => "12",
+      :expiration_year => "2025",
+      :is_network_tokenized => true,
+      :last_two => "11",
+      :payer_info => {
+        :billing_agreement_id => "1234",
+        :country_code => "US",
+      },
+    )
+  }
+
+  describe "#initialize" do
+    it "sets attributes" do
+      payment_method_nonce_details.bin.should == "bin"
+      payment_method_nonce_details.card_type.should == "American Express"
+      payment_method_nonce_details.expiration_month.should == "12"
+      payment_method_nonce_details.expiration_year.should == "2025"
+      payment_method_nonce_details.is_network_tokenized.should == true
+      payment_method_nonce_details.last_two.should == "11"
+      payment_method_nonce_details.payer_info.billing_agreement_id.should == "1234"
+      payment_method_nonce_details.payer_info.country_code.should == "US"
+    end
+  end
+
+  describe "inspect" do
+    it "prints the attributes" do
+      payment_method_nonce_details.inspect.should == %(#<PaymentMethodNonceDetails bin: "bin", card_type: "American Express", expiration_month: "12", expiration_year: "2025", is_network_tokenized: true, last_two: "11", payer_info: #<PaymentMethodNonceDetailsPayerInfo billing_agreement_id: "1234", country_code: "US", email: nil, first_name: nil, last_name: nil, payer_id: nil>>)
+    end
+  end
+
+  describe "is_network_tokenized" do
+    it "is aliased to is_network_tokenized?" do
+      payment_method_nonce_details.is_network_tokenized?.should == true
+    end
+  end
+end

data/spec/unit/braintree/xml/rexml_spec.rb

@@ -0,0 +1,51 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../spec_helper")
+
+describe Braintree::Xml::Rexml do
+  describe "self.parse" do
+    it "typecasts integers" do
+      xml = "<root><foo type=\"integer\">123</foo></root>"
+      Braintree::Xml::Rexml.parse(xml).should == {"root"=>{"foo"=>{"__content__"=>"123", "type"=>"integer"}}}
+    end
+
+    it "works with dashes or underscores" do
+      xml = <<-END
+        <root>
+          <dash-es />
+          <under_scores />
+        </root>
+      END
+      Braintree::Xml::Rexml.parse(xml).should == {"root"=>{"dash-es"=>{}, "under_scores"=>{}}}
+    end
+
+    it "uses nil if nil=true, otherwise uses empty string" do
+      xml = <<-END
+        <root>
+          <a_nil_value nil="true"></a_nil_value>
+          <an_empty_string></an_empty_string>
+        </root>
+      END
+      Braintree::Xml::Rexml.parse(xml).should == {"root"=>{"a_nil_value"=>{"nil"=>"true"}, "an_empty_string"=>{}}}
+    end
+
+    it "typecasts dates and times" do
+      xml = <<-END
+        <root>
+          <created-at type="datetime">2009-10-28T10:19:49Z</created-at>
+        </root>
+      END
+      Braintree::Xml::Rexml.parse(xml).should == {"root"=>{"created-at"=>{"__content__"=>"2009-10-28T10:19:49Z", "type"=>"datetime"}}}
+    end
+
+    it "builds an array if type=array" do
+      xml = <<-END
+        <root>
+          <customers type="array">
+            <customer><name>Adam</name></customer>
+            <customer><name>Ben</name></customer>
+          </customers>
+        </root>
+      END
+      Braintree::Xml::Rexml.parse(xml).should == {"root"=>{"customers"=>{"type"=>"array", "customer"=>[{"name"=>{"__content__"=>"Adam"}}, {"name"=>{"__content__"=>"Ben"}}]}}}
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: braintree
 version: !ruby/object:Gem::Version
-  version: 3.4.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Braintree
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-12 00:00:00.000000000 Z
+date: 2021-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder
@@ -24,20 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.4
-- !ruby/object:Gem::Dependency
-  name: libxml-ruby
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.2.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.2.0
 description: Resources and tools for developers to integrate Braintree's global payments
   platform.
 email: code@getbraintree.com
@@ -84,6 +70,7 @@ files:
 - lib/braintree/discount_gateway.rb
 - lib/braintree/dispute.rb
 - lib/braintree/dispute/evidence.rb
+- lib/braintree/dispute/paypal_message.rb
 - lib/braintree/dispute/status_history.rb
 - lib/braintree/dispute/transaction.rb
 - lib/braintree/dispute/transaction_details.rb
@@ -121,6 +108,8 @@ files:
 - lib/braintree/payment_method.rb
 - lib/braintree/payment_method_gateway.rb
 - lib/braintree/payment_method_nonce.rb
+- lib/braintree/payment_method_nonce_details.rb
+- lib/braintree/payment_method_nonce_details_payer_info.rb
 - lib/braintree/payment_method_nonce_gateway.rb
 - lib/braintree/payment_method_parser.rb
 - lib/braintree/paypal_account.rb
@@ -192,6 +181,7 @@ files:
 - lib/braintree/xml/generator.rb
 - lib/braintree/xml/libxml.rb
 - lib/braintree/xml/parser.rb
+- lib/braintree/xml/rexml.rb
 - lib/ssl/api_braintreegateway_com.ca.crt
 - lib/ssl/securetrust_ca.crt
 - spec/fixtures/files/bt_logo.png
@@ -268,6 +258,8 @@ files:
 - spec/unit/braintree/local_payment_completed_spec.rb
 - spec/unit/braintree/merchant_account_spec.rb
 - spec/unit/braintree/modification_spec.rb
+- spec/unit/braintree/payment_method_nonce_details_payer_info_spec.rb
+- spec/unit/braintree/payment_method_nonce_details_spec.rb
 - spec/unit/braintree/payment_method_spec.rb
 - spec/unit/braintree/paypal_account_spec.rb
 - spec/unit/braintree/resource_collection_spec.rb
@@ -295,6 +287,7 @@ files:
 - spec/unit/braintree/webhook_notification_spec.rb
 - spec/unit/braintree/xml/libxml_spec.rb
 - spec/unit/braintree/xml/parser_spec.rb
+- spec/unit/braintree/xml/rexml_spec.rb
 - spec/unit/braintree/xml_spec.rb
 - spec/unit/braintree_spec.rb
 - spec/unit/spec_helper.rb
@@ -314,14 +307,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.8
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: Braintree Ruby Server SDK