braintree 4.28.0 → 4.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1eb371a013154345b87d1581d335e2e164844b06cfbc720574cc68819d8839f
-  data.tar.gz: ec7325707abf2ad90b2d17ca390ece11adead95ba1f2e8cd4fb42e78470a225b
+  metadata.gz: 2e98c0f65f8fc26db02c0f16cbe7b86e28aa7fbf6829ec4acf23c44db5159cff
+  data.tar.gz: e954ce7e083b2e1ea24c7cdd06acdcec52fc90238426bfca8ca7756200514677
 SHA512:
-  metadata.gz: 76fb4902a1ace12c7b7730bd911296143b941de6b8d0a5cc018f1dba3ecb35c1090b00a3d0387e85cf0a54938d578fb2c29b2cf9c06674556d4509572cb24636
-  data.tar.gz: 404445aad78f100dcec0ece96b1d0e7f7f6103afc869333b23d6754bac28ef70f367ef0b1580f7716a4388f2f36129bcc4dcf3c4c547d70f83da5d6e5ad90b75
+  metadata.gz: acc8c82a96904ca3dd89d3719d020756540af5f7bfdc1d56340a4b382ba1b6640732bb7f4eefd0073378fa4ed1c5dbb16a44fce9fcf4ed67146bffc0acd47314
+  data.tar.gz: 755c3a07a8469e6ee09f189b8d0ab60bdbb11c324fea726cd0af2bc86307b7213300c64a6d94ae9eff91d5fdf628295e4f42aec1bd2845ba4e5634c46c9d61ad

data/lib/braintree/dispute.rb

@@ -32,6 +32,7 @@ module Braintree
     attr_reader :reply_by_date
     attr_reader :status
     attr_reader :status_history
+    attr_reader :remaining_file_evidence_storage
     attr_reader :transaction
     attr_reader :transaction_details
     attr_reader :updated_at

data/lib/braintree/graphql/types/customer_recommendations_payload.rb

@@ -7,16 +7,18 @@ module Braintree
     include BaseModule
 
     attr_reader :attrs
+    attr_reader :session_id
     attr_reader :is_in_paypal_network
     attr_reader :recommendations
 
     def initialize(attributes)
-      @attrs = [:is_in_paypal_network, :recommendations]
+      @attrs = [:session_id, :is_in_paypal_network, :recommendations]
 
       if attributes.key?(:response)
         response = attributes[:response]
         # Constructor for response map
         begin
+          @session_id = _get_value(response, "generateCustomerRecommendations.sessionId")
           @is_in_paypal_network = _get_value(response, "generateCustomerRecommendations.isInPayPalNetwork")
           @recommendations = _extract_recommendations(response)
         rescue => e
@@ -24,6 +26,7 @@ module Braintree
           raise
         end
       else
+        @session_id = attributes[:session_id]
         @is_in_paypal_network = attributes[:is_in_paypal_network]
         @recommendations = attributes[:recommendations]
       end

data/lib/braintree/transaction.rb

@@ -82,6 +82,7 @@ module Braintree
       end
     end
 
+    attr_reader :account_funding_transaction
     attr_reader :ach_return_code
     attr_reader :ach_return_responses
     attr_reader :acquirer_reference_number
@@ -171,6 +172,7 @@ module Braintree
     attr_reader :tax_exempt
     attr_reader :three_d_secure_info
     attr_reader :type
+    attr_reader :upcoming_retry_date
     attr_reader :updated_at
     attr_reader :us_bank_account_details
     attr_reader :venmo_account_details

data/lib/braintree/transaction_gateway.rb

@@ -280,6 +280,11 @@ module Braintree
             :ds_transaction_id,
           ]
         },
+        {
+          :transfer => [
+            :type,
+          ]
+        },
       ]
     end
 

data/lib/braintree/version.rb

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

data/lib/braintree/webhook_notification.rb

@@ -57,6 +57,7 @@ module Braintree
       SubscriptionWentPastDue = "subscription_went_past_due"
 
       TransactionDisbursed = "transaction_disbursed"
+      TransactionRetried = "transaction_retried"
       TransactionReviewed = "transaction_reviewed"
       TransactionSettlementDeclined = "transaction_settlement_declined"
       TransactionSettled = "transaction_settled"

data/lib/braintree/webhook_testing_gateway.rb

@@ -60,6 +60,8 @@ module Braintree
         _oauth_access_revoked_sample_xml(id)
       when Braintree::WebhookNotification::Kind::TransactionDisbursed
         _transaction_disbursed_sample_xml(id)
+      when Braintree::WebhookNotification::Kind::TransactionRetried
+        _transaction_retried_sample_xml(id)
       when Braintree::WebhookNotification::Kind::TransactionReviewed
         _transaction_reviewed_sample_xml(id)
       when Braintree::WebhookNotification::Kind::TransactionSettled
@@ -269,6 +271,20 @@ module Braintree
       XML
     end
 
+    def _transaction_retried_sample_xml(id)
+
+      <<-XML
+        <transaction>
+          <id>#{id}</id>
+          <amount>100</amount>
+          <status>submitted_for_settlement</status>
+          <type>sale</type>
+          <currency-iso-code>USD</currency-iso-code>
+          <retried-transaction-id>original_txn_id</retried-transaction-id>
+        </transaction>
+      XML
+    end
+
     def _transaction_reviewed_sample_xml(id)
 
       <<-XML

data/spec/integration/braintree/customer_session_spec.rb

@@ -102,6 +102,7 @@ describe Braintree::CustomerSessionGateway do
 
       expect(result.success?).to eq(true)
       payload = result.customer_recommendations
+      expect(payload.session_id).to eq("94f0b2db-5323-4d86-add3-paypal000000")
       expect(payload.is_in_paypal_network).to eq(true)
 
       recommendation = payload.recommendations.payment_recommendations[0]

data/spec/integration/braintree/dispute_spec.rb

@@ -32,8 +32,8 @@ describe Braintree::Dispute do
 
       expect(result.success?).to eq(true)
 
-      refreshed_dispute = Braintree::Dispute.find(dispute.id)
-      expect(refreshed_dispute.status).to eq(Braintree::Dispute::Status::Accepted)
+      updated_dispute = Braintree::Dispute.find(dispute.id)
+      expect(updated_dispute.status).to eq(Braintree::Dispute::Status::Accepted)
 
       dispute_from_transaction = Braintree::Transaction.find(dispute.transaction.id).disputes[0]
       expect(dispute_from_transaction.status).to eq(Braintree::Dispute::Status::Accepted)
@@ -99,6 +99,17 @@ describe Braintree::Dispute do
       expect(result.evidence.category).to eq("GENERAL")
       expect(result.evidence.url).to include("bt_logo.png")
     end
+
+    it "reflects the updated remaining_file_evidence_storage" do
+      initial_storage = dispute.remaining_file_evidence_storage
+      expect(initial_storage).not_to be_nil
+
+      Braintree::Dispute.add_file_evidence(dispute.id, document_upload.id)
+
+      refreshed_dispute = Braintree::Dispute.find(dispute.id)
+      updated_storage = refreshed_dispute.remaining_file_evidence_storage
+      expect(updated_storage).to be < initial_storage
+    end
   end
 
   describe "self.add_text_evidence" do

data/spec/integration/braintree/transaction_search_spec.rb

@@ -183,10 +183,8 @@ describe Braintree::Transaction, "search" do
       collection = Braintree::Transaction.search do |search|
         search.reason_code.in reason_code
       end
-
-      expect(collection.maximum_size).to eq(1)
-      expect(collection.first.id).to eq(transaction_id)
-      expect(collection.first.ach_return_responses.first[:reason_code]).to eq("R01")
+      item = collection.find { |t| t.id == transaction_id }
+      expect(item.ach_return_responses.first[:reason_code]).to eq("R01")
     end
 
     it "searches on reason_codes" do
@@ -196,7 +194,7 @@ describe Braintree::Transaction, "search" do
         search.reason_code.is reason_code
       end
 
-      expect(collection.maximum_size).to eq(2)
+      expect(collection.maximum_size).to eq(4)
     end
 
     context "multiple value fields" do
@@ -590,17 +588,18 @@ describe Braintree::Transaction, "search" do
         expect(collection.first.id).to eq(transaction_id)
       end
 
-      it "searches on reason_codes for 2 items" do
+      it "searches on reason_codes for 3 items" do
         reason_code = ["R01", "R02"]
 
         collection = Braintree::Transaction.search do |search|
           search.reason_code.in reason_code
         end
 
-        expect(collection.maximum_size).to eq(2)
+        expect(collection.maximum_size).to eq(3)
       end
 
-      it "searches on a reason_code" do
+      xit "searches on a reason_code" do
+        # duplicate test
         reason_code = ["R01"]
         transaction_id = "ach_txn_ret1"
 
@@ -855,7 +854,7 @@ describe Braintree::Transaction, "search" do
             search.ach_return_responses_created_at.between(DateTime.now - 1.0, DateTime.now + 1.0)
           end
 
-          expect(date_search.maximum_size).to eq(2)
+          expect(date_search.maximum_size).to eq(4)
         end
 
         it "it does not find records not within date range of the custom field" do
@@ -1513,6 +1512,7 @@ describe Braintree::Transaction, "search" do
 
       collection = Braintree::Transaction.search do |search|
         search.payment_instrument_type.in ["MetaCheckout"]
+        search.ids.in [meta_checkout_card_transaction.id, meta_checkout_token_transaction.id]
       end
 
       collection.maximum_size.should == 2

data/spec/integration/braintree/transaction_spec.rb

@@ -3368,13 +3368,13 @@ describe Braintree::Transaction do
           config = Braintree::Configuration.instantiate
           config.http.put("#{config.base_merchant_path}/transactions/#{transaction.id}/settle")
           result = Braintree::Transaction.refund(transaction.id, :amount => "2046.00")
-          expect(result.success?).to eq(false)
+          expect(result.success?).to eq(true)
           expect(result.transaction.id).to match(/^\w{6,}$/)
           expect(result.transaction.type).to eq("credit")
-          expect(result.transaction.status).to eq(Braintree::Transaction::Status::ProcessorDeclined)
-          expect(result.transaction.processor_response_code).to eq("2046")
-          expect(result.transaction.processor_response_text).to eq("Declined")
-          expect(result.transaction.processor_response_type).to eq(Braintree::ProcessorResponseTypes::SoftDeclined)
+          expect(result.transaction.status).to eq(Braintree::Transaction::Status::SubmittedForSettlement)
+          expect(result.transaction.processor_response_code).to eq("1005")
+          expect(result.transaction.processor_response_text).to eq("Auth Declined but Settlement Captured")
+          expect(result.transaction.processor_response_type).to eq(Braintree::ProcessorResponseTypes::Approved)
           expect(result.transaction.additional_processor_response).to eq("2046 : Declined")
         end
 
@@ -3388,15 +3388,15 @@ describe Braintree::Transaction do
           )
           config = Braintree::Configuration.instantiate
           config.http.put("#{config.base_merchant_path}/transactions/#{transaction.id}/settle")
-          result = Braintree::Transaction.refund(transaction.id, :amount => "2009.00")
+          result = Braintree::Transaction.refund(transaction.id, :amount => "2004.00")
           expect(result.success?).to eq(false)
           expect(result.transaction.id).to match(/^\w{6,}$/)
           expect(result.transaction.type).to eq("credit")
           expect(result.transaction.status).to eq(Braintree::Transaction::Status::ProcessorDeclined)
-          expect(result.transaction.processor_response_code).to eq("2009")
-          expect(result.transaction.processor_response_text).to eq("No Such Issuer")
+          expect(result.transaction.processor_response_code).to eq("2004")
+          expect(result.transaction.processor_response_text).to eq("Expired Card")
           expect(result.transaction.processor_response_type).to eq(Braintree::ProcessorResponseTypes::HardDeclined)
-          expect(result.transaction.additional_processor_response).to eq("2009 : No Such Issuer")
+          expect(result.transaction.additional_processor_response).to eq("2004 : Expired Card")
         end
       end
 
@@ -5888,7 +5888,8 @@ describe Braintree::Transaction do
     end
 
     context "Pinless debit transaction" do
-      it "succesfully submits for settlement" do
+      xit "succesfully submits for settlement" do
+        # Flaky test
         result = Braintree::Transaction.sale(
           :amount => Braintree::Test::TransactionAmounts::Authorize,
           :merchant_account_id => SpecHelper::PinlessDebitMerchantAccountId,
@@ -7754,4 +7755,13 @@ describe Braintree::Transaction do
       expect(result.transaction.status).to eq(Braintree::Transaction::Status::SubmittedForSettlement)
     end
   end
+
+  describe "upcoming_retry_date" do
+    it "returns the upcoming retry date for ACH transactions" do
+      transaction = Braintree::Transaction.find("first_attempted_ach_transaction")
+
+      tomorrow = Date.today + 1
+      expect(transaction.upcoming_retry_date).to eq(tomorrow.to_s)
+    end
+  end
 end

data/spec/integration/braintree/transaction_transfer_type_spec.rb

@@ -0,0 +1,46 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+require File.expand_path(File.dirname(__FILE__) + "/client_api/spec_helper")
+
+describe Braintree::Transaction do
+  describe "self.transfer type" do
+    it "should create a transaction with valid transfer types and merchant account id" do
+      transaction_params = {
+        :type => "sale",
+        :amount => "100.00",
+        :merchant_account_id => "aft_first_data_wallet_transfer",
+        :credit_card => {
+          :number => "4111111111111111",
+          :expiration_date => "06/2026",
+          :cvv => "123"
+        },
+        :transfer => {
+          :type => "wallet_transfer",
+        },
+      }
+
+      result = Braintree::Transaction.sale(transaction_params)
+      expect(result.success?).to eq(true)
+      expect(result.transaction.account_funding_transaction).to eq(true)
+      expect(result.transaction.status).to eq(Braintree::Transaction::Status::Authorized)
+    end
+
+    it "should fail on transaction with non brazil merchant" do
+      transaction_params = {
+        :type => "sale",
+        :amount => "100.00",
+        :merchant_account_id => "aft_first_data_wallet_transfer",
+        :credit_card => {
+          :number => "4111111111111111",
+          :expiration_date => "06/2026",
+          :cvv => "123"
+        },
+        :transfer => {
+          :type => "invalid_transfer",
+        },
+      }
+
+      result =  Braintree::Transaction.sale(transaction_params)
+      expect(result.success?).to eq(false)
+    end
+  end
+end

data/spec/unit/braintree/customer_session_gateway_spec.rb

@@ -113,6 +113,7 @@ describe Braintree::CustomerSessionGateway do
       result = customer_session_gateway.get_customer_recommendations(customer_recommendations_input)
       expect(result).to be_a(Braintree::SuccessfulResult)
       expect(result.customer_recommendations.is_in_paypal_network).to eq(true)
+      expect(result.customer_recommendations.session_id).to eq("session_id")
       expect(result.customer_recommendations.recommendations.payment_recommendations[0].payment_option).to eq("PAYPAL")
       expect(result.customer_recommendations.recommendations.payment_recommendations[0].recommended_priority).to eq(1)
     end

data/spec/unit/braintree/dispute_spec.rb

@@ -40,6 +40,7 @@ describe Braintree::Dispute do
           :timestamp => Time.utc(2009, 3, 9, 10, 50, 39),
         }
       ],
+      :remaining_file_evidence_storage => 341029,
       :transaction => {
         :amount => "31.00",
         :id => "open_disputed_transaction",
@@ -436,6 +437,11 @@ describe Braintree::Dispute do
 
       expect(dispute.pre_dispute_program).to eq(Braintree::Dispute::PreDisputeProgram::VisaRdr)
     end
+
+    it "checks that the remaining_file_evidence_storage field is set correctly" do
+      dispute = Braintree::Dispute._new(attributes)
+      dispute.remaining_file_evidence_storage.should == 341029
+    end
   end
 
   describe "==" do

data/spec/unit/braintree/transaction_gateway_spec.rb

@@ -129,6 +129,11 @@ describe Braintree::TransactionGateway do
             :ds_transaction_id,
           ]
         },
+        {
+          :transfer => [
+            :type,
+          ]
+        },
       ])
     end
 

data/spec/unit/braintree/transaction_spec.rb

@@ -267,6 +267,14 @@ describe Braintree::Transaction do
       expect(transaction.retried_transaction_id).to eq("original_retried_tranction_id")
     end
 
+    it "accepts upcoming_retry_date attribute in a transaction" do
+      transaction = Braintree::Transaction._new(
+        :gateway,
+        :upcoming_retry_date => "2024-12-25",
+      )
+      expect(transaction.upcoming_retry_date).to eq("2024-12-25")
+    end
+
     it "handles receiving custom as an empty string" do
       Braintree::Transaction._new(
         :gateway,

data/spec/unit/braintree/webhook_notification_spec.rb

@@ -330,6 +330,23 @@ describe Braintree::WebhookNotification do
       end
     end
 
+    context "transaction retried" do
+      it "builds a sample notification for a transaction retried webhook" do
+        sample_notification = Braintree::WebhookTesting.sample_notification(
+          Braintree::WebhookNotification::Kind::TransactionRetried,
+          "my_id",
+        )
+
+        notification = Braintree::WebhookNotification.parse(sample_notification[:bt_signature], sample_notification[:bt_payload])
+
+        expect(notification.kind).to eq(Braintree::WebhookNotification::Kind::TransactionRetried)
+        expect(notification.transaction.id).to eq("my_id")
+        expect(notification.transaction.amount).to eq(1_00)
+        expect(notification.transaction.status).to eq("submitted_for_settlement")
+        expect(notification.transaction.retried_transaction_id).to eq("original_txn_id")
+      end
+    end
+
     context "transaction review" do
       it " builds a sample notification for a transaction reviewed webhook" do
         sample_notification = Braintree::WebhookTesting.sample_notification(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: braintree
 version: !ruby/object:Gem::Version
-  version: 4.28.0
+  version: 4.30.0
 platform: ruby
 authors:
 - Braintree
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-28 00:00:00.000000000 Z
+date: 2025-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder
@@ -284,6 +284,7 @@ files:
 - spec/integration/braintree/transaction_payment_facilitator_spec.rb
 - spec/integration/braintree/transaction_search_spec.rb
 - spec/integration/braintree/transaction_spec.rb
+- spec/integration/braintree/transaction_transfer_type_spec.rb
 - spec/integration/braintree/transaction_us_bank_account_spec.rb
 - spec/integration/braintree/us_bank_account_spec.rb
 - spec/integration/braintree/us_bank_account_verification_search_spec.rb
@@ -398,7 +399,7 @@ metadata:
   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
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -413,8 +414,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.5
-signing_key: 
+rubygems_version: 3.3.15
+signing_key:
 specification_version: 4
 summary: Braintree Ruby Server SDK
 test_files: []