braintree 4.4.0 → 4.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7279d06aef254f1954bf7b8801e4717aa258f7413f05f1c076fbb6f1e2258c5
-  data.tar.gz: 9b136fbc93fa3f251972a44b0728244f746ef1868507cb40385780cd2137ff22
+  metadata.gz: fb259ba1474b20f411b4046f978a7397599c88217b9f1b1a41a969036ca350fa
+  data.tar.gz: 4d5dbdf190c5088dca938bf4ecae614db1d1e94f9eb921284523b604686667c9
 SHA512:
-  metadata.gz: d611127df5091cb248b434285a2cd2c5080749515d60beba2a00af28809106dca11a4b5607f8774ac111d8115e5bbc85965817ba8fb45e309bbb2ecb8b8e4382
-  data.tar.gz: c7f547f0a2b62aa36b94e2f410e3375d1b4a2d3d7e76c570f3c9d387c15299a8ed858237db461de7f1889b5552e4c85dd1cedd42ce741c2360eeb38b71ef87c3
+  metadata.gz: 8b09ef27dc9c38dd0fc3fb03ec487f7d52112629043af3fb4c760274b267767f08e2b1052bbb2d4f67d0ebade4fe7dae0dfde850a3eca1e0114a15219f988204
+  data.tar.gz: 6f5223eb5b90f99f9381245a580f766383102146daa4e095cf1e7f413f592ba9fac78f8cdd67b59a149d4c0a0a9c02d80f3a2650fa2187e2eab54443a24bd045

data/braintree.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |s|
     "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://developers.braintreepayments.com/"
+    "documentation_uri" => "https://developer.paypal.com/braintree/docs"
   }
 end
 

data/lib/braintree/enriched_customer_data.rb

@@ -0,0 +1,21 @@
+module Braintree
+  class EnrichedCustomerData
+    include BaseModule
+
+    attr_reader :fields_updated
+    attr_reader :profile_data
+
+    def initialize(attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+      @profile_data = VenmoProfileData._new(attributes[:profile_data])
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new(*args)
+    end
+  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) # :nodoc:
+      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) # :nodoc:
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/plan.rb

@@ -33,6 +33,26 @@ module Braintree
 
     class << self
       protected :new
+
+      def create(*args)
+        Configuration.gateway.plan.create(*args)
+      end
+
+      def create!(*args)
+        Configuration.gateway.plan.create!(*args)
+      end
+
+      def find(*args)
+        Configuration.gateway.plan.find(*args)
+      end
+
+      def update(*args)
+        Configuration.gateway.plan.update(*args)
+      end
+
+      def update!(*args)
+        Configuration.gateway.plan.update!(*args)
+      end
     end
 
     def self._new(*args)

data/lib/braintree/plan_gateway.rb

@@ -1,5 +1,7 @@
 module Braintree
   class PlanGateway # :nodoc:
+    include BaseModule
+
     def initialize(gateway)
       @gateway = gateway
       @config = gateway.config
@@ -13,5 +15,103 @@ module Braintree
         Plan._new(@gateway, attributes)
       end
     end
+
+    def create(attributes)
+      Util.verify_keys(PlanGateway._create_signature, attributes)
+      _do_create "/plans", :plan => attributes
+    end
+
+    def create!(*args)
+      return_object_or_raise(:plan) { create(*args) }
+    end
+
+    def find(id)
+      raise ArgumentError if id.nil? || id.to_s.strip == ""
+      response = @config.http.get("#{@config.base_merchant_path}/plans/#{id}")
+      Plan._new(@gateway, response[:plan])
+    rescue NotFoundError
+      raise NotFoundError, "plan with id #{id.inspect} not found"
+    end
+
+    def update(plan_id, attributes)
+      Util.verify_keys(PlanGateway._update_signature, attributes)
+      response = @config.http.put("#{@config.base_merchant_path}/plans/#{plan_id}", :plan => attributes)
+      if response[:plan]
+        SuccessfulResult.new(:plan => Plan._new(@gateway, response[:plan]))
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise UnexpectedError, "expected :plan or :api_error_response"
+      end
+    end
+
+    def update!(*args)
+      return_object_or_raise(:plan) { update(*args) }
+    end
+
+    def self._create_signature
+      [
+        :billing_day_of_month,
+        :billing_frequency,
+        :currency_iso_code,
+        :description,
+        :id,
+        :merchant_id,
+        :name,
+        :number_of_billing_cycles,
+        :price,
+        :trial_duration,
+        :trial_duration_unit,
+        :trial_period
+      ] + _add_on_discount_signature
+    end
+
+    def self._update_signature
+      [
+        :billing_day_of_month,
+        :billing_frequency,
+        :currency_iso_code,
+        :description,
+        :id,
+        :merchant_id,
+        :name,
+        :number_of_billing_cycles,
+        :price,
+        :trial_duration,
+        :trial_duration_unit,
+        :trial_period
+      ] + _add_on_discount_signature
+    end
+
+    def self._add_on_discount_signature
+      [
+        {
+          :add_ons => [
+            {:add => [:amount, :inherited_from_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:update => [:amount, :existing_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:remove => [:_any_key_]}
+          ]
+        },
+        {
+          :discounts => [
+            {:add => [:amount, :inherited_from_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:update => [:amount, :existing_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:remove => [:_any_key_]}
+          ]
+        }
+      ]
+    end
+
+    def _do_create(path, params) # :nodoc:
+      response = @config.http.post("#{@config.base_merchant_path}#{path}", params)
+      if response[:plan]
+        SuccessfulResult.new(:plan => Plan._new(@gateway, response[:plan]))
+      elsif response[:errors]
+        ErrorResult.new(@gateway, response[:errors])
+      else
+        raise UnexpectedError, "expected :plan or :errors"
+      end
+    end
   end
 end
+

data/lib/braintree/successful_result.rb

@@ -16,6 +16,7 @@ module Braintree
     attr_reader :payment_method
     attr_reader :payment_method_nonce
     attr_reader :paypal_account
+    attr_reader :plan
     attr_reader :settlement_batch_summary
     attr_reader :subscription
     attr_reader :supported_networks

data/lib/braintree/transaction.rb

@@ -91,6 +91,7 @@ module Braintree
     end
 
     attr_reader :acquirer_reference_number
+    attr_reader :ach_return_code
     attr_reader :add_ons
     attr_reader :additional_processor_response          # The raw response from the processor.
     attr_reader :amount
@@ -146,6 +147,7 @@ module Braintree
     attr_reader :refund_ids
     attr_reader :refunded_transaction_id
     attr_reader :refunded_installments
+    attr_reader :retried
     attr_reader :retrieval_reference_number
     attr_reader :risk_data
     attr_reader :samsung_pay_card_details

data/lib/braintree/transaction_review.rb

@@ -0,0 +1,18 @@
+module Braintree
+  class TransactionReview
+    include BaseModule
+
+    attr_reader :transaction_id, :decision, :reviewer_email, :reviewer_note, :reviewer_time
+
+    def initialize(attributes)
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+      def _new(*args) # :nodoc:
+        self.new(*args)
+      end
+    end
+  end
+end

data/lib/braintree/venmo_profile_data.rb

@@ -0,0 +1,23 @@
+module Braintree
+  class VenmoProfileData
+    include BaseModule
+
+    attr_reader :username
+    attr_reader :first_name
+    attr_reader :last_name
+    attr_reader :phone_number
+    attr_reader :email
+
+    def initialize(attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/version.rb

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

data/lib/braintree/webhook_notification.rb

@@ -38,6 +38,8 @@ module Braintree
       PartnerMerchantDisconnected = "partner_merchant_disconnected"
       PartnerMerchantDeclined = "partner_merchant_declined"
 
+      PaymentMethodCustomerDataUpdated = "payment_method_customer_data_updated"
+
       PaymentMethodRevokedByCustomer = "payment_method_revoked_by_customer"
 
       RecipientUpdatedGrantedPaymentMethod = "recipient_updated_granted_payment_method"
@@ -54,6 +56,7 @@ module Braintree
       SubMerchantAccountDeclined = "sub_merchant_account_declined"
 
       TransactionDisbursed = "transaction_disbursed"
+      TransactionReviewed = "transaction_reviewed"
       TransactionSettlementDeclined = "transaction_settlement_declined"
       TransactionSettled = "transaction_settled"
     end
@@ -72,10 +75,12 @@ module Braintree
     attr_reader :local_payment_reversed
     attr_reader :oauth_access_revocation
     attr_reader :partner_merchant
+    attr_reader :payment_method_customer_data_updated_metadata
     attr_reader :source_merchant_id
     attr_reader :subscription
     attr_reader :timestamp
     attr_reader :transaction
+    attr_reader :transaction_review
 
     def self.parse(*args)
       Configuration.gateway.webhook_notification.parse(*args)
@@ -94,6 +99,7 @@ module Braintree
       @oauth_access_revocation = OpenStruct.new(@subject[:oauth_application_revocation]) if @subject.has_key?(:oauth_application_revocation)
       @subscription = Subscription._new(gateway, @subject[:subscription]) if @subject.has_key?(:subscription)
       @transaction = Transaction._new(gateway, @subject[:transaction]) if @subject.has_key?(:transaction)
+      @transaction_review = OpenStruct.new(@subject[:transaction_review]) if @subject.has_key?(:transaction_review)
       @disbursement = Disbursement._new(gateway, @subject[:disbursement]) if @subject.has_key?(:disbursement)
       @dispute = Dispute._new(@subject[:dispute]) if @subject.has_key?(:dispute)
       @account_updater_daily_report = AccountUpdaterDailyReport._new(@subject[:account_updater_daily_report]) if @subject.has_key?(:account_updater_daily_report)
@@ -105,6 +111,8 @@ module Braintree
       @local_payment_expired = LocalPaymentExpired._new(@subject[:local_payment_expired]) if @subject.has_key?(:local_payment_expired) && Kind::LocalPaymentExpired == @kind
       @local_payment_funded = LocalPaymentFunded._new(@subject[:local_payment_funded]) if @subject.has_key?(:local_payment_funded) && Kind::LocalPaymentFunded == @kind
       @local_payment_reversed = LocalPaymentReversed._new(@subject[:local_payment_reversed]) if @subject.has_key?(:local_payment_reversed) && Kind::LocalPaymentReversed == @kind
+      @payment_method_customer_data_updated_metadata = PaymentMethodCustomerDataUpdatedMetadata._new(gateway, @subject[:payment_method_customer_data_updated_metadata]) if @subject.has_key?(:payment_method_customer_data_updated_metadata) && Kind::PaymentMethodCustomerDataUpdated == @kind
+
     end
 
     def merchant_account

data/lib/braintree/webhook_testing_gateway.rb

@@ -60,6 +60,8 @@ module Braintree
         _merchant_account_declined_sample_xml(id)
       when Braintree::WebhookNotification::Kind::TransactionDisbursed
         _transaction_disbursed_sample_xml(id)
+      when Braintree::WebhookNotification::Kind::TransactionReviewed
+        _transaction_reviewed_sample_xml(id)
       when Braintree::WebhookNotification::Kind::TransactionSettled
         _transaction_settled_sample_xml(id)
       when Braintree::WebhookNotification::Kind::TransactionSettlementDeclined
@@ -94,6 +96,8 @@ module Braintree
         _local_payment_funded_sample_xml(id)
       when Braintree::WebhookNotification::Kind::LocalPaymentReversed
         _local_payment_reversed_sample_xml
+      when Braintree::WebhookNotification::Kind::PaymentMethodCustomerDataUpdated
+        _payment_method_customer_data_updated_sample_xml(id)
       else
         _subscription_sample_xml(id)
       end
@@ -248,6 +252,19 @@ module Braintree
       XML
     end
 
+    def _transaction_reviewed_sample_xml(id)
+
+      <<-XML
+        <transaction-review>
+          <transaction-id>my_id</transaction-id>
+          <decision>decision</decision>
+          <reviewer-email>hey@girl.com</reviewer-email>
+          <reviewer-note>i reviewed this</reviewer-note>
+          <reviewed-time type="datetime">2017-06-16T20:44:41Z</reviewed-time>
+        </transaction-review>
+      XML
+    end
+
     def _transaction_settled_sample_xml(id)
       <<-XML
         <transaction>
@@ -884,21 +901,7 @@ module Braintree
     end
 
     def _granted_payment_method_revoked_xml(id)
-      <<-XML
-        <venmo-account>
-          <created-at type='dateTime'>2018-10-11T21:28:37Z</created-at>
-          <updated-at type='dateTime'>2018-10-11T21:28:37Z</updated-at>
-          <default type='boolean'>true</default>
-          <image-url>https://assets.braintreegateway.com/payment_method_logo/venmo.png?environment=test</image-url>
-          <token>#{id}</token>
-          <source-description>Venmo Account: venmojoe</source-description>
-          <username>venmojoe</username>
-          <venmo-user-id>456</venmo-user-id>
-          <subscriptions type='array'/>
-          <customer-id>venmo_customer_id</customer-id>
-          <global-id>cGF5bWVudG1ldGhvZF92ZW5tb2FjY291bnQ</global-id>
-        </venmo-account>
-      XML
+      _venmo_account_xml(id)
     end
 
     def _payment_method_revoked_by_customer_sample_xml(id)
@@ -971,5 +974,47 @@ module Braintree
         </local-payment-reversed>
       XML
     end
+
+    def _payment_method_customer_data_updated_sample_xml(id)
+      <<-XML
+        <payment-method-customer-data-updated-metadata>
+          <token>TOKEN-12345</token>
+          <payment-method>
+            #{_venmo_account_xml(id)}
+          </payment-method>
+          <datetime-updated type='dateTime'>2022-01-01T21:28:37Z</datetime-updated>
+          <enriched-customer-data>
+            <fields-updated type='array'>
+              <item>username</item>
+            </fields-updated>
+            <profile-data>
+              <username>venmo_username</username>
+              <first-name>John</first-name>
+              <last-name>Doe</last-name>
+              <phone-number>1231231234</phone-number>
+              <email>john.doe@paypal.com</email>
+            </profile-data>
+          </enriched-customer-data>
+        </payment-method-customer-data-updated-metadata>
+      XML
+    end
+
+    def _venmo_account_xml(id)
+      <<-XML
+        <venmo-account>
+          <created-at type='dateTime'>2018-10-11T21:28:37Z</created-at>
+          <updated-at type='dateTime'>2018-10-11T21:28:37Z</updated-at>
+          <default type='boolean'>true</default>
+          <image-url>https://assets.braintreegateway.com/payment_method_logo/venmo.png?environment=test</image-url>
+          <token>#{id}</token>
+          <source-description>Venmo Account: venmojoe</source-description>
+          <username>venmojoe</username>
+          <venmo-user-id>456</venmo-user-id>
+          <subscriptions type='array'/>
+          <customer-id>venmo_customer_id</customer-id>
+          <global-id>cGF5bWVudG1ldGhvZF92ZW5tb2FjY291bnQ</global-id>
+        </venmo-account>
+        XML
+    end
   end
 end

data/lib/braintree.rb

@@ -65,6 +65,7 @@ require "braintree/dispute/transaction"
 require "braintree/dispute/transaction_details"
 require "braintree/document_upload"
 require "braintree/document_upload_gateway"
+require "braintree/enriched_customer_data"
 require "braintree/error_codes"
 require "braintree/error_result"
 require "braintree/errors"
@@ -88,6 +89,7 @@ require "braintree/oauth_gateway"
 require "braintree/oauth_credentials"
 require "braintree/payment_instrument_type"
 require "braintree/payment_method"
+require "braintree/payment_method_customer_data_updated_metadata"
 require "braintree/payment_method_gateway"
 require "braintree/payment_method_nonce"
 require "braintree/payment_method_nonce_details"
@@ -155,6 +157,7 @@ require "braintree/dispute_search"
 require "braintree/validation_error"
 require "braintree/validation_error_collection"
 require "braintree/venmo_account"
+require "braintree/venmo_profile_data"
 require "braintree/version"
 require "braintree/visa_checkout_card"
 require "braintree/samsung_pay_card"

data/spec/integration/braintree/payment_method_nonce_spec.rb

@@ -1,5 +1,6 @@
 require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
 require File.expand_path(File.dirname(__FILE__) + "/client_api/spec_helper")
+require "date"
 
 describe Braintree::PaymentMethodNonce do
   let(:config) { Braintree::Configuration.instantiate }
@@ -84,7 +85,7 @@ describe Braintree::PaymentMethodNonce do
       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.expiration_year.should == Date.today.next_year.year.to_s
       nonce.details.is_network_tokenized?.should be_nil
       nonce.details.last_two.should == "81"
       nonce.details.payer_info.should be_nil

data/spec/integration/braintree/payment_method_spec.rb

@@ -200,7 +200,7 @@ describe Braintree::PaymentMethod do
       venmo_account.default.should == true
       venmo_account.token.should == token
       venmo_account.username.should == "venmojoe"
-      venmo_account.venmo_user_id.should == "Venmo-Joe-1"
+      venmo_account.venmo_user_id.should == "1234567891234567891"
       venmo_account.image_url.should include(".png")
       venmo_account.source_description.should == "Venmo Account: venmojoe"
       venmo_account.customer_id.should == customer.id
@@ -1163,7 +1163,7 @@ describe Braintree::PaymentMethod do
         venmo_account.default.should == true
         venmo_account.image_url.should =~ /venmo/
         venmo_account.username.should == "venmojoe"
-        venmo_account.venmo_user_id.should == "Venmo-Joe-1"
+        venmo_account.venmo_user_id.should == "1234567891234567891"
         venmo_account.source_description.should == "Venmo Account: venmojoe"
         venmo_account.customer_id.should == customer.id
       end

data/spec/integration/braintree/plan_spec.rb

@@ -1,4 +1,5 @@
 require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+require File.expand_path(File.dirname(__FILE__) + "/client_api/spec_helper")
 
 describe Braintree::Plan do
 
@@ -48,6 +49,87 @@ describe Braintree::Plan do
     end
   end
 
+  describe "self.create" do
+    let(:attributes) do
+      {
+        :billing_day_of_month => 12,
+        :billing_frequency => 1,
+        :currency_iso_code => "USD",
+        :description => "description on create",
+        :name => "my new plan name",
+        :number_of_billing_cycles => 1,
+        :price => "9.99",
+        :trial_period => false
+      }
+
+      it "is successful with given params" do
+        result = Braintree::Plan.create(attributes)
+        expect(result.success?).to be_truthy
+        expect(result.plan.billing_day_of_month).to eq 12
+        expect(result.plan.description).to eq "description on create"
+        expect(result.plan.name).to eq "my new plan name"
+        expect(result.plan.price).to eq "9.99"
+        expect(result.plan.billing_frequency).to eq 1
+      end
+    end
+  end
+
+  describe "self.find" do
+    it "finds a plan" do
+      plan = Braintree::Plan.create(
+        :billing_day_of_month => 12,
+        :billing_frequency => 1,
+        :currency_iso_code => "USD",
+        :description => "description on create",
+        :name => "my new plan name",
+        :number_of_billing_cycles => 1,
+        :price => "9.99",
+        :trial_period => false,
+      ).plan
+
+      found_plan = Braintree::Plan.find(plan.id)
+      expect(found_plan.name).to eq plan.name
+    end
+
+    it "raises Braintree::NotFoundError if it cannot find" do
+      expect {
+        Braintree::Plan.find("noSuchPlan")
+      }.to raise_error(Braintree::NotFoundError, 'plan with id "noSuchPlan" not found')
+    end
+  end
+
+  describe "self.update!" do
+    before(:each) do
+      @plan = Braintree::Plan.create(
+        :billing_day_of_month => 12,
+        :billing_frequency => 1,
+        :currency_iso_code => "USD",
+        :description => "description on create",
+        :name => "my new plan name",
+        :number_of_billing_cycles => 1,
+        :price => "9.99",
+        :trial_period => false,
+      ).plan
+    end
+
+    it "returns the updated plan if valid" do
+      new_id = rand(36**9).to_s(36)
+      plan = Braintree::Plan.update!(@plan.id,
+                                     :name => "updated name",
+                                     :price => 99.88,
+                                    )
+
+      expect(plan.name).to eq "updated name"
+      expect(plan.price).to eq BigDecimal("99.88")
+    end
+
+    it "raises a ValidationsFailed if invalid" do
+      expect do
+        Braintree::Plan.update!(@plan.id, :number_of_billing_cycles => "number of billing cycles")
+      end.to raise_error(Braintree::ValidationsFailed)
+    end
+  end
+
   def create_plan_for_tests(attributes)
     config = Braintree::Configuration.gateway.config
     config.http.post("#{config.base_merchant_path}/plans/create_plan_for_tests", :plan => attributes)

data/spec/integration/braintree/transaction_search_spec.rb

@@ -419,6 +419,17 @@ describe Braintree::Transaction, "search" do
         collection.maximum_size.should == 0
       end
 
+      it "searches for settlement_confirmed transaction" do
+        transaction_id = "settlement_confirmed_txn"
+
+        collection = Braintree::Transaction.search do |search|
+          search.id.is transaction_id
+        end
+
+        collection.maximum_size.should == 1
+        collection.first.id.should == transaction_id
+      end
+
       it "finds expired authorizations by status" do
         collection = Braintree::Transaction.search do |search|
           search.status.in Braintree::Transaction::Status::AuthorizationExpired

data/spec/integration/braintree/transaction_spec.rb

@@ -1947,7 +1947,7 @@ describe Braintree::Transaction do
         venmo_account_details.should be_a(Braintree::Transaction::VenmoAccountDetails)
         venmo_account_details.token.should respond_to(:to_str)
         venmo_account_details.username.should == "venmojoe"
-        venmo_account_details.venmo_user_id.should == "Venmo-Joe-1"
+        venmo_account_details.venmo_user_id.should == "1234567891234567891"
         venmo_account_details.image_url.should include(".png")
         venmo_account_details.source_description.should == "Venmo Account: venmojoe"
       end
@@ -6941,6 +6941,39 @@ describe Braintree::Transaction do
     end
   end
 
+  describe "retried flag presence in response" do
+    it "creates a retried transaction" do
+      result = Braintree::Transaction.sale(
+        :amount => Braintree::Test::TransactionAmounts::Decline,
+        :payment_method_token => "network_tokenized_credit_card",
+      )
+      transaction = result.transaction
+      transaction.retried.should == true
+    end
+
+    it "creates a non-retried transaction" do
+      result = Braintree::Transaction.sale(
+        :amount => Braintree::Test::TransactionAmounts::Authorize,
+        :payment_method_token => "network_tokenized_credit_card",
+      )
+      transaction = result.transaction
+      transaction.retried.should == nil
+    end
+
+    it "creates a transaction that is ineligible for retries" do
+      result = Braintree::Transaction.sale(
+        :merchant_account_id => SpecHelper::NonDefaultMerchantAccountId,
+        :credit_card => {
+          :number => Braintree::Test::CreditCardNumbers::Visa,
+          :expiration_date => "05/2009"
+        },
+        :amount => Braintree::Test::TransactionAmounts::Authorize,
+      )
+      transaction = result.transaction
+      transaction.retried.should == nil
+    end
+  end
+
   describe "installments" do
     it "creates a transaction with an installment count" do
       result = Braintree::Transaction.create(

data/spec/unit/braintree/enriched_customer_data_spec.rb

@@ -0,0 +1,32 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+describe Braintree::EnrichedCustomerData do
+  describe "self.new" do
+    it "is protected" do
+      expect do
+        Braintree::EnrichedCustomerData.new
+      end.to raise_error(NoMethodError, /protected method .new/)
+    end
+  end
+
+  describe "self._new" do
+    it "initializes the object with the appropriate attributes set" do
+
+      params = {
+        fields_updated: ["username"],
+        profile_data: {
+          username: "a-username",
+          first_name: "a-first-name",
+          last_name: "a-last-name",
+          phone_number: "a-phone-number",
+          email: "a-email",
+        },
+      }
+
+      payment_method_customer_data_updated = Braintree::EnrichedCustomerData._new(params)
+
+      payment_method_customer_data_updated.profile_data.should be_a(Braintree::VenmoProfileData)
+      payment_method_customer_data_updated.fields_updated.should eq(["username"])
+    end
+  end
+end

data/spec/unit/braintree/payment_method_customer_data_updated_metadata_spec.rb

@@ -0,0 +1,45 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+describe Braintree::PaymentMethodCustomerDataUpdatedMetadata do
+  describe "self.new" do
+    it "is protected" do
+      expect do
+        Braintree::PaymentMethodCustomerDataUpdatedMetadata.new
+      end.to raise_error(NoMethodError, /protected method .new/)
+    end
+  end
+
+  describe "self._new" do
+    it "initializes the object with the appropriate attributes set" do
+
+      params = {
+        token: "a-token",
+        payment_method: {
+          venmo_account: {
+            venmo_user_id: "venmo-user-id",
+          },
+        },
+        datetime_updated: "2022-01-01T21:28:37Z",
+        enriched_customer_data: {
+          fields_updated: ["username"],
+          profile_data: {
+            username: "a-username",
+            first_name: "a-first-name",
+            last_name: "a-last-name",
+            phone_number: "a-phone-number",
+            email: "a-email",
+          },
+        },
+      }
+
+      payment_method_customer_data_updated = Braintree::PaymentMethodCustomerDataUpdatedMetadata._new(:gateway, params)
+
+      payment_method_customer_data_updated.token.should eq("a-token")
+      payment_method_customer_data_updated.datetime_updated.should eq("2022-01-01T21:28:37Z")
+      payment_method_customer_data_updated.payment_method.should be_a(Braintree::VenmoAccount)
+      payment_method_customer_data_updated.enriched_customer_data.profile_data.first_name.should eq("a-first-name")
+      payment_method_customer_data_updated.enriched_customer_data.profile_data.last_name.should eq("a-last-name")
+      payment_method_customer_data_updated.enriched_customer_data.fields_updated.should eq(["username"])
+    end
+  end
+end

data/spec/unit/braintree/transaction_spec.rb

@@ -238,6 +238,14 @@ describe Braintree::Transaction do
       transaction.network_transaction_id.should == "123456789012345"
     end
 
+    it "accepts ach_return_code" do
+      transaction = Braintree::Transaction._new(
+        :gateway,
+        :ach_return_code => "R01",
+      )
+      expect(transaction.ach_return_code).to eq("R01")
+    end
+
     it "accepts network_response code and network_response_text" do
       transaction = Braintree::Transaction._new(
         :gateway,

data/spec/unit/braintree/venmo_profile_data_spec.rb

@@ -0,0 +1,32 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+describe Braintree::VenmoProfileData do
+  describe "self.new" do
+    it "is protected" do
+      expect do
+        Braintree::VenmoProfileData.new
+      end.to raise_error(NoMethodError, /protected method .new/)
+    end
+  end
+
+  describe "self._new" do
+    it "initializes the object with the appropriate attributes set" do
+
+      params = {
+        username: "a-username",
+        first_name: "a-first-name",
+        last_name: "a-last-name",
+        phone_number: "12312312343",
+        email: "a-email",
+      }
+
+      payment_method_customer_data_updated = Braintree::VenmoProfileData._new(params)
+
+      payment_method_customer_data_updated.username.should eq("a-username")
+      payment_method_customer_data_updated.first_name.should eq("a-first-name")
+      payment_method_customer_data_updated.last_name.should eq("a-last-name")
+      payment_method_customer_data_updated.phone_number.should eq("12312312343")
+      payment_method_customer_data_updated.email.should eq("a-email")
+    end
+  end
+end

data/spec/unit/braintree/webhook_notification_spec.rb

@@ -317,6 +317,24 @@ describe Braintree::WebhookNotification do
       end
     end
 
+    context "transaction review" do
+      it " builds a sample notification for a transaction reviewed webhook" do
+        sample_notification = Braintree::WebhookTesting.sample_notification(
+          Braintree::WebhookNotification::Kind::TransactionReviewed,
+          "my_id",
+        )
+
+        notification = Braintree::WebhookNotification.parse(sample_notification[:bt_signature], sample_notification[:bt_payload])
+
+        expect(notification.kind).to eq(Braintree::WebhookNotification::Kind::TransactionReviewed)
+        expect(notification.transaction_review.transaction_id).to eq("my_id")
+        expect(notification.transaction_review.decision).to eq("decision")
+        expect(notification.transaction_review.reviewer_email).to eq("hey@girl.com")
+        expect(notification.transaction_review.reviewer_note).to eq("i reviewed this")
+        expect(notification.transaction_review.reviewed_time).to_not be_nil
+      end
+    end
+
     context "us bank account transactions" do
       it "builds a sample notification for a settlement webhook" do
         sample_notification = Braintree::WebhookTesting.sample_notification(
@@ -717,6 +735,32 @@ describe Braintree::WebhookNotification do
     end
   end
 
+  context "payment_method_customer_data_updated" do
+    it "builds a sample notification for a payment_method_customer_data_updated webhook" do
+      sample_notification = Braintree::WebhookTesting.sample_notification(
+        Braintree::WebhookNotification::Kind::PaymentMethodCustomerDataUpdated,
+        "my_id",
+      )
+      notification = Braintree::WebhookNotification.parse(sample_notification[:bt_signature], sample_notification[:bt_payload])
+      notification.kind.should == Braintree::WebhookNotification::Kind::PaymentMethodCustomerDataUpdated
+
+      payment_method_customer_data_updated = notification.payment_method_customer_data_updated_metadata
+
+      payment_method_customer_data_updated.token.should eq("TOKEN-12345")
+      payment_method_customer_data_updated.datetime_updated.should eq("2022-01-01T21:28:37Z")
+
+      enriched_customer_data = payment_method_customer_data_updated.enriched_customer_data
+      enriched_customer_data.fields_updated.should eq(["username"])
+
+      profile_data = enriched_customer_data.profile_data
+      profile_data.first_name.should eq("John")
+      profile_data.last_name.should eq("Doe")
+      profile_data.username.should eq("venmo_username")
+      profile_data.phone_number.should eq("1231231234")
+      profile_data.email.should eq("john.doe@paypal.com")
+    end
+  end
+
   describe "parse" do
     it "raises InvalidSignature error when the signature is nil" do
       expect do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: braintree
 version: !ruby/object:Gem::Version
-  version: 4.4.0
+  version: 4.7.0
 platform: ruby
 authors:
 - Braintree
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-05 00:00:00.000000000 Z
+date: 2022-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder
@@ -92,6 +92,7 @@ files:
 - lib/braintree/dispute_search.rb
 - lib/braintree/document_upload.rb
 - lib/braintree/document_upload_gateway.rb
+- lib/braintree/enriched_customer_data.rb
 - lib/braintree/error_codes.rb
 - lib/braintree/error_result.rb
 - lib/braintree/errors.rb
@@ -122,6 +123,7 @@ files:
 - lib/braintree/paginated_result.rb
 - lib/braintree/payment_instrument_type.rb
 - lib/braintree/payment_method.rb
+- lib/braintree/payment_method_customer_data_updated_metadata.rb
 - lib/braintree/payment_method_gateway.rb
 - lib/braintree/payment_method_nonce.rb
 - lib/braintree/payment_method_nonce_details.rb
@@ -176,6 +178,7 @@ files:
 - lib/braintree/transaction_gateway.rb
 - lib/braintree/transaction_line_item.rb
 - lib/braintree/transaction_line_item_gateway.rb
+- lib/braintree/transaction_review.rb
 - lib/braintree/transaction_search.rb
 - lib/braintree/unknown_payment_method.rb
 - lib/braintree/us_bank_account.rb
@@ -187,6 +190,7 @@ files:
 - lib/braintree/validation_error.rb
 - lib/braintree/validation_error_collection.rb
 - lib/braintree/venmo_account.rb
+- lib/braintree/venmo_profile_data.rb
 - lib/braintree/version.rb
 - lib/braintree/visa_checkout_card.rb
 - lib/braintree/webhook_notification.rb
@@ -268,6 +272,7 @@ files:
 - spec/unit/braintree/dispute_search_spec.rb
 - spec/unit/braintree/dispute_spec.rb
 - spec/unit/braintree/document_upload_spec.rb
+- spec/unit/braintree/enriched_customer_data_spec.rb
 - spec/unit/braintree/error_result_spec.rb
 - spec/unit/braintree/errors_spec.rb
 - spec/unit/braintree/http_spec.rb
@@ -276,6 +281,7 @@ files:
 - spec/unit/braintree/local_payment_funded_spec.rb
 - spec/unit/braintree/merchant_account_spec.rb
 - spec/unit/braintree/modification_spec.rb
+- spec/unit/braintree/payment_method_customer_data_updated_metadata_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_nonce_spec.rb
@@ -303,6 +309,7 @@ files:
 - spec/unit/braintree/util_spec.rb
 - spec/unit/braintree/validation_error_collection_spec.rb
 - spec/unit/braintree/validation_error_spec.rb
+- spec/unit/braintree/venmo_profile_data_spec.rb
 - spec/unit/braintree/webhook_notification_spec.rb
 - spec/unit/braintree/xml/libxml_spec.rb
 - spec/unit/braintree/xml/parser_spec.rb
@@ -317,7 +324,7 @@ 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://developers.braintreepayments.com/
+  documentation_uri: https://developer.paypal.com/braintree/docs
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -333,7 +340,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.25
+rubygems_version: 3.3.10
 signing_key: 
 specification_version: 4
 summary: Braintree Ruby Server SDK