braintree 4.37.0 → 4.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6caf45c8c01ed96cbda734799d6af4445fb48aeb96d04dcd261cdb8986a0c3d
-  data.tar.gz: 28cddb63bbe271008adeac7541458a147c2b536acebd61492e7f803fe01a54c7
+  metadata.gz: 8a8a4986148f9b2ded5832261519f85d75e2932d7d7d15bc7d49207d2422431e
+  data.tar.gz: 3431f5d87f5f15ffd7c2d29fe28674d7c49645f0447342360d0f41444def6c16
 SHA512:
-  metadata.gz: 0a649a80b6d11cc600f6e5eb2feea91aec32a1c808e6786a5a05121eb0f0b149e9937dfd8ecdfd18b5bcadc605f2ac7b89e9341383db29d31f2541331dc956b8
-  data.tar.gz: 037444564b51d29d4631cc8f7f39280a72a99db13ebc76d5f02c14d28e839606123c773e2b3ccd32b43ceee262ffd9535381fe20686dd0497720c26564bd818f
+  metadata.gz: d523c2199f88f2eea71960c92659b7e8aabb02aa78c35ab51f0b513b575d408b6df9b881c5d895ed8a30b300c3ab4c43fa48ce3d88a331dcd9c96c9c6aac8ca8
+  data.tar.gz: d6dc3e11eec83fcbd5c045ff92b04e83ff80686ecc19eedf17a50b19b68d0511f2ec1514fa0f13081ba889509ae161f8f1121380a6e51baa1daf66fa6115f509

data/lib/braintree/error_codes.rb

@@ -355,6 +355,7 @@ module Braintree
       BillingPhoneNumberIsInvalid = "915206"
       CannotBeVoided = "91504"
       CannotCloneCredit = "91543"
+      CannotCloneThirdPartyCofNetworkTokenTransaction = "915274"
       CannotCloneTransactionWithPayPalAccount = "91573"
       CannotCloneTransactionWithVaultCreditCard = "91540"
       CannotCloneUnsuccessfulTransaction = "91542"
@@ -483,10 +484,12 @@ module Braintree
       TransactionTransferDetailsAreMandatory = "97510"
       TransactionTransferDetailsAreNotApplicable = "97511"
       TransactionTransferReceiverAccountReferenceNumberIsNotValid = "97509"
+      TransactionTransferReceiverAccountReferenceNumberTypeIsInvalid = "97514"
       TransactionTransferReceiverFirstNameIsNotValid = "97507"
       TransactionTransferReceiverLastNameIsNotValid = "97508"
       TransactionTransferReceiverTaxIdIsNotValid = "97506"
       TransactionTransferSenderAccountReferenceNumberIsNotValid = "97505"
+      TransactionTransferSenderAccountReferenceNumberTypeIsInvalid = "97513"
       TransactionTransferSenderFirstNameIsNotValid = "97503"
       TransactionTransferSenderLastNameIsNotValid = "97504"
       TransactionTransferSenderTaxIdIsNotValid = "97502"

data/lib/braintree/transaction/local_payment_details.rb

@@ -6,6 +6,8 @@ module Braintree
       attr_reader :blik_aliases
       attr_reader :capture_id
       attr_reader :custom_field
+      # NEXT_MAJOR_VERSION Remove this attribute
+      # DEPRECATED debug_id is deprecated and will be removed in a future version
       attr_reader :debug_id
       attr_reader :description
       attr_reader :funding_source

data/lib/braintree/transaction/paypal_details.rb

@@ -7,6 +7,8 @@ module Braintree
       attr_reader :billing_agreement_id
       attr_reader :capture_id
       attr_reader :custom_field
+      # NEXT_MAJOR_VERSION Remove this attribute
+      # DEPRECATED debug_id is deprecated and will be removed in a future version
       attr_reader :debug_id
       attr_reader :description
       attr_reader :image_url

data/lib/braintree/transaction/sepa_direct_debit_account_details.rb

@@ -5,6 +5,8 @@ module Braintree
 
       attr_reader :bank_reference_token
       attr_reader :capture_id
+      # NEXT_MAJOR_VERSION Remove this attribute
+      # DEPRECATED debug_id is deprecated and will be removed in a future version
       attr_reader :debug_id
       attr_reader :global_id
       attr_reader :last_4

data/lib/braintree/transaction_gateway.rb

@@ -291,6 +291,7 @@ module Braintree
             {
               :sender => [
                 :account_reference_number,
+                :account_reference_number_type,
                 :date_of_birth,
                 :first_name,
                 :last_name,
@@ -302,6 +303,7 @@ module Braintree
             {
               :receiver => [
                 :account_reference_number,
+                :account_reference_number_type,
                 :first_name,
                 :last_name,
                 :middle_name,
@@ -344,6 +346,8 @@ module Braintree
         :tax_amount,
         :tax_exempt,
         :discount_amount,
+        {:shipping => AddressGateway._shared_signature},
+        :shipping_address_id,
         :shipping_amount,
         :shipping_tax_amount,
         :ships_from_postal_code,

data/lib/braintree/version.rb

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

data/spec/integration/braintree/transaction_spec.rb

@@ -6206,6 +6206,90 @@ describe Braintree::Transaction do
       end.to raise_error(ArgumentError)
     end
 
+    it "succeeds when a vaulted shipping_address_id is passed" do
+      customer = Braintree::Customer.create!(
+        :credit_card => {
+          :number => Braintree::Test::CreditCardNumbers::Visa,
+          :expiration_date => "06/2009"
+        },
+      )
+      address = Braintree::Address.create!(
+        :customer_id => customer.id,
+        :street_address => "1 Main St",
+        :locality => "Chicago",
+        :region => "IL",
+        :postal_code => "60601",
+      )
+      transaction = Braintree::Transaction.create(
+        :type => "sale",
+        :amount => Braintree::Test::TransactionAmounts::Authorize,
+        :customer_id => customer.id,
+        :payment_method_token => customer.credit_cards.first.token,
+        :options => {
+          :submit_for_settlement => false
+        },
+      ).transaction
+
+      result = Braintree::Transaction.submit_for_settlement(transaction.id, nil, {
+        :shipping_address_id => address.id,
+      })
+
+      expect(result.success?).to be_truthy
+      expect(result.transaction.shipping_details.street_address).to eq("1 Main St")
+      expect(result.transaction.shipping_details.postal_code).to eq("60601")
+    end
+
+    it "raises an ArgumentError if an invalid shipping sub-key is passed" do
+      transaction = Braintree::Transaction.sale!(
+        :amount => Braintree::Test::TransactionAmounts::Authorize,
+        :credit_card => {
+          :number => Braintree::Test::CreditCardNumbers::Visa,
+          :expiration_date => "06/2009"
+        },
+      )
+
+      expect do
+        Braintree::Transaction.submit_for_settlement(transaction.id, nil, {
+          :shipping => {:invalid_field => "bad"}
+        })
+      end.to raise_error(ArgumentError)
+    end
+
+    it "succeeds when shipping address data is passed" do
+      transaction = Braintree::Transaction.sale!(
+        :amount => Braintree::Test::TransactionAmounts::Authorize,
+        :credit_card => {
+          :number => Braintree::Test::CreditCardNumbers::Visa,
+          :expiration_date => "06/2009"
+        },
+        :options => {
+          :submit_for_settlement => false
+        },
+      )
+
+      result = Braintree::Transaction.submit_for_settlement(transaction.id, nil, {
+        :discount_amount => "12.33",
+        :shipping_amount => "5.00",
+        :ships_from_postal_code => "90210",
+        :shipping => {
+          :first_name => "Andrew",
+          :last_name => "Mason",
+          :company => "Braintree",
+          :street_address => "456 W Main St",
+          :extended_address => "Apt 2F",
+          :locality => "Bartlett",
+          :region => "IL",
+          :postal_code => "60103",
+          :country_name => "United States of America",
+        },
+      })
+
+      expect(result.success?).to be_truthy
+      expect(result.transaction.status).to eq(Braintree::Transaction::Status::SubmittedForSettlement)
+      expect(result.transaction.shipping_details.first_name).to eq("Andrew")
+      expect(result.transaction.shipping_details.postal_code).to eq("60103")
+    end
+
     it "returns an error result if settlement is too large" do
       transaction = Braintree::Transaction.sale!(
         :amount => Braintree::Test::TransactionAmounts::Authorize,

data/spec/integration/braintree/transaction_transfer_type_spec.rb

@@ -16,6 +16,8 @@ describe Braintree::Transaction do
         :transfer => {
           :type => "wallet_transfer",
           :receiver => {
+            :account_reference_number => "test123",
+            :account_reference_number_type => "SOCIAL_NETWORK_PROFILE_ID",
             :first_name => "John",
             :last_name => "Smith",
             :middle_name => "D",
@@ -27,7 +29,8 @@ describe Braintree::Transaction do
             }
           },
           :sender => {
-            :account_reference_number => "123456789",
+            :account_reference_number => "test@example.com",
+            :account_reference_number_type => "EMAIL_ADDRESS",
             :date_of_birth => Date.new(2002, 1, 2),
             :first_name => "Lisa",
             :last_name => "Ray",
@@ -48,6 +51,73 @@ describe Braintree::Transaction do
       expect(result.transaction.status).to eq(Braintree::Transaction::Status::Authorized)
     end
 
+    it "should fail on transaction with invalid sender account reference number type" 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",
+          :sender => {
+            :account_reference_number => "test@example.com",
+            :account_reference_number_type => "INVALID_ACCOUNT_REFERENCE_NUMBER_TYPE",
+            :date_of_birth => Date.new(2002, 1, 2),
+            :first_name => "Lisa",
+            :last_name => "Ray",
+            :middle_name => "D",
+            :address => {
+              :country_code_alpha2 => "US",
+              :locality => "LA",
+              :region => "CA",
+              :street_address => "12th Main"
+            }
+          },
+        }
+      }
+
+      result = Braintree::Transaction.sale(transaction_params)
+      expect(result.success?).to eq(false)
+      expect(result.errors.for(:account_funding_transaction).first.code).to eq(Braintree::ErrorCodes::Transaction::TransactionTransferSenderAccountReferenceNumberTypeIsInvalid)
+    end
+
+    it "should fail on transaction with invalid receiver account reference number type" 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",
+          :receiver => {
+            :account_reference_number => "test@example.com",
+            :account_reference_number_type => "INVALID_ACCOUNT_REFERENCE_NUMBER_TYPE",
+            :first_name => "Lisa",
+            :last_name => "Ray",
+            :middle_name => "D",
+            :address => {
+              :country_code_alpha2 => "US",
+              :locality => "LA",
+              :region => "CA",
+              :street_address => "12th Main"
+            }
+          },
+        }
+      }
+
+      result = Braintree::Transaction.sale(transaction_params)
+      expect(result.success?).to eq(false)
+      expect(result.errors.for(:account_funding_transaction).first.code).to eq(Braintree::ErrorCodes::Transaction::TransactionTransferReceiverAccountReferenceNumberTypeIsInvalid)
+    end
+
     it "should fail on transaction with non brazil merchant" do
       transaction_params = {
         :type => "sale",

data/spec/unit/braintree/transaction_gateway_spec.rb

@@ -135,6 +135,7 @@ describe Braintree::TransactionGateway do
             :type,
             {:sender => [
               :account_reference_number,
+              :account_reference_number_type,
               :date_of_birth,
               :first_name,
               :last_name,
@@ -144,6 +145,7 @@ describe Braintree::TransactionGateway do
             ]},
             {:receiver => [
               :account_reference_number,
+              :account_reference_number_type,
               :first_name,
               :last_name,
               :middle_name,
@@ -185,6 +187,8 @@ describe Braintree::TransactionGateway do
         :tax_amount,
         :tax_exempt,
         :discount_amount,
+        {:shipping => Braintree::AddressGateway._shared_signature},
+        :shipping_address_id,
         :shipping_amount,
         :shipping_tax_amount,
         :ships_from_postal_code,

data/spec/unit/braintree/transaction_spec.rb

@@ -43,6 +43,12 @@ describe Braintree::Transaction do
         Braintree::Transaction.submit_for_settlement("invalid-transaction-id")
       end.to raise_error(ArgumentError, "transaction_id is invalid")
     end
+
+    it "raises an ArgumentError if options hash includes an invalid key" do
+      expect do
+        Braintree::Transaction.submit_for_settlement("validtxnid1", nil, :invalid_key => "foo")
+      end.to raise_error(ArgumentError, "invalid keys: invalid_key")
+    end
   end
 
   describe "self.adjust_authorization" do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: braintree
 version: !ruby/object:Gem::Version
-  version: 4.37.0
+  version: 4.39.0
 platform: ruby
 authors:
 - Braintree
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-27 00:00:00.000000000 Z
+date: 2026-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder
@@ -437,7 +437,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.3.15
 signing_key:
 specification_version: 4
 summary: Braintree Ruby Server SDK