braintree 4.31.0 → 4.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a1505b44cec85c55cc5237d0fa3d57165dfa809589893774fdecfc972147940
-  data.tar.gz: e92b0f87a02744e0df5db4173aa6a2e237dd5b7817932232e380a160d7df1450
+  metadata.gz: b982c20d1a239e4a623a802fb0c0d6ce66a5be501e767c22a33a7b06a3c09a59
+  data.tar.gz: 9d515e47f8d7e5908b21f7ed5ccd98b02f2ce712298082fd67cbc3d88d7fd13d
 SHA512:
-  metadata.gz: 2d5c303f50bd453a719fc0586593fcf9307fc8a1be02c5307487178bbf368d7e1467bf08ceda4e0b96c421a46f1d43d1f9c17af35206efcb22b5c3d0f0da9094
-  data.tar.gz: 287dadfccf55558b99069ffd42458b67085a68aabeb2d6575765e8f96c281c97158228bf99254a802d84b50e41fc90dc28b06d4c5984fb06e2563e28c108c286
+  metadata.gz: 1459fb667fdbb3d3f52feb2082394f347dbe0c3347eef68c87cbc31a8c915fcc96ff8623bbd98f8766e2391801423514fa2db4a4c90f511ea9d2c1c3778f9b3d
+  data.tar.gz: 36af58c2cc626136cfaa8bc1f28d2acb8fa47e9e747e0e9eb641acabcbf4e0afadf34556e5467928c4e091a66279b505f952a1fb9e5476e19531f0c81b91a59d

data/lib/braintree/error_codes.rb

@@ -395,6 +395,7 @@ module Braintree
       PaymentMethodNonceUnknown = "91565"
       PaymentMethodTokenCardTypeIsNotAccepted = "91517"
       PaymentMethodTokenIsInvalid = "91518"
+      ProcessingMerchantCategoryCodeIsInvalid = "915265"
       ProcessorAuthorizationCodeCannotBeSet = "91519"
       ProcessorAuthorizationCodeIsInvalid = "81520"
       ProcessorDoesNotSupportAuths = "915104"
@@ -460,6 +461,15 @@ module Braintree
       TransactionMustBeInStateAuthorized = "915218"
       TransactionSourceIsInvalid = "915133"
       TransactionTransferDetailsAreMandatory = "97510"
+      TransactionTransferDetailsAreNotApplicable = "97511"
+      TransactionTransferReceiverAccountReferenceNumberIsNotValid = "97509"
+      TransactionTransferReceiverFirstNameIsNotValid = "97507"
+      TransactionTransferReceiverLastNameIsNotValid = "97508"
+      TransactionTransferReceiverTaxIdIsNotValid = "97506"
+      TransactionTransferSenderAccountReferenceNumberIsNotValid = "97505"
+      TransactionTransferSenderFirstNameIsNotValid = "97503"
+      TransactionTransferSenderLastNameIsNotValid = "97504"
+      TransactionTransferSenderTaxIdIsNotValid = "97502"
       TransactionTransferTypeIsInvalid = "97501"
       TypeIsInvalid = "91523"
       TypeIsRequired = "91524"

data/lib/braintree/transaction/apple_pay_details.rb

@@ -22,6 +22,7 @@ module Braintree
       attr_reader :issuing_bank
       attr_reader :last_4
       attr_reader :merchant_token_identifier
+      attr_reader :payment_account_reference
       attr_reader :payment_instrument_name
       attr_reader :payroll
       attr_reader :prepaid

data/lib/braintree/transaction/credit_card_details.rb

@@ -21,6 +21,7 @@ module Braintree
       attr_reader :image_url
       attr_reader :issuing_bank
       attr_reader :last_4
+      attr_reader :payment_account_reference
       attr_reader :payroll
       attr_reader :prepaid
       attr_reader :prepaid_reloadable
@@ -55,6 +56,7 @@ module Braintree
           :image_url,
           :issuing_bank,
           :last_4,
+          :payment_account_reference,
           :payroll,
           :prepaid,
           :prepaid_reloadable,

data/lib/braintree/transaction/google_pay_details.rb

@@ -20,6 +20,7 @@ module Braintree
       attr_reader :image_url
       attr_reader :issuing_bank
       attr_reader :last_4
+      attr_reader :payment_account_reference
       attr_reader :payroll
       attr_reader :prepaid
       attr_reader :prepaid_reloadable

data/lib/braintree/transaction_gateway.rb

@@ -196,7 +196,7 @@ module Braintree
       [
         :amount, :billing_address_id, :channel, :currency_iso_code, :customer_id, :device_data,
         :discount_amount, :exchange_rate_quote_id, :foreign_retailer,
-        :merchant_account_id, :order_id, :payment_method_nonce, :payment_method_token,
+        :merchant_account_id, :order_id, :payment_method_nonce, :payment_method_token, :processing_merchant_category_code,
         :product_sku, :purchase_order_number, :service_fee_amount, :shared_billing_address_id,
         :shared_customer_id, :shared_payment_method_nonce, :shared_payment_method_token,
         :shared_shipping_address_id, :shipping_address_id, :shipping_amount, :shipping_tax_amount,

data/lib/braintree/version.rb

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

data/spec/integration/braintree/credit_card_verification_spec.rb

@@ -257,6 +257,13 @@ describe Braintree::CreditCardVerification, "search" do
         Braintree::CreditCardVerification.find("invalid-id")
       end.to raise_error(Braintree::NotFoundError, 'verification with id "invalid-id" not found')
     end
+
+    it "finds a verification and returns a payment_account_reference if the verification has one" do
+      verification = Braintree::CreditCardVerification.find("threedsecuredverification")
+
+      expect(verification.credit_card).not_to be_nil
+      expect(verification.credit_card).to have_key(:payment_account_reference)
+    end
   end
 
   describe "self.search" do

data/spec/integration/braintree/payment_method_us_bank_account_spec.rb

@@ -32,7 +32,6 @@ describe Braintree::PaymentMethod do
           expect(us_bank_account.account_holder_name).to eq("John Doe")
           expect(us_bank_account.bank_name).to match(/CHASE/)
           expect(us_bank_account.default).to eq(true)
-          expect(us_bank_account.ach_mandate.text).to eq("cl mandate text")
           expect(us_bank_account.ach_mandate.accepted_at).to be_a Time
 
           expect(us_bank_account.verifications.count).to eq(0)
@@ -100,7 +99,6 @@ describe Braintree::PaymentMethod do
           expect(us_bank_account.account_holder_name).to eq("Dan Schulman")
           expect(us_bank_account.bank_name).to match(/Wells Fargo/)
           expect(us_bank_account.default).to eq(true)
-          expect(us_bank_account.ach_mandate.text).to eq("example mandate text")
           expect(us_bank_account.ach_mandate.accepted_at).to be_a Time
 
           expect(us_bank_account.verifications.count).to eq(1)
@@ -135,7 +133,6 @@ describe Braintree::PaymentMethod do
           expect(us_bank_account.account_holder_name).to eq("John Doe")
           expect(us_bank_account.bank_name).to match(/CHASE/)
           expect(us_bank_account.default).to eq(true)
-          expect(us_bank_account.ach_mandate.text).to eq("cl mandate text")
           expect(us_bank_account.ach_mandate.accepted_at).to be_a Time
 
           expect(us_bank_account.verifications.count).to eq(1)

data/spec/integration/braintree/transaction_spec.rb

@@ -5301,6 +5301,61 @@ describe Braintree::Transaction do
       expect(transaction.shipping_details.international_phone[:national_number]).to eq("3121234567")
     end
 
+    it "accepts processing_merchant_category_code" do
+      result = Braintree::Transaction.sale(
+        :amount => "100.00",
+        :credit_card => {
+          :number => "4111111111111111",
+          :expiration_date => "05/2028"
+        },
+        :processing_merchant_category_code => "5411",
+      )
+
+      expect(result.success?).to eq(true)
+    end
+
+    it "returns validation error for a too long processing_merchant_category_code" do
+      result = Braintree::Transaction.sale(
+        :amount => "100.00",
+        :credit_card => {
+          :number => "4111111111111111",
+          :expiration_date => "05/2028"
+        },
+        :processing_merchant_category_code => "54111",
+      )
+
+      expect(result.success?).to eq(false)
+      expect(result.errors.for(:transaction).on(:processing_merchant_category_code)[0].code).to eq(Braintree::ErrorCodes::Transaction::ProcessingMerchantCategoryCodeIsInvalid)
+    end
+
+    it "returns validation error for an alphanumeric processing_merchant_category_code" do
+      result = Braintree::Transaction.sale(
+        :amount => "100.00",
+        :credit_card => {
+          :number => "4111111111111111",
+          :expiration_date => "05/2028"
+        },
+        :processing_merchant_category_code => "541A",
+      )
+
+      expect(result.success?).to eq(false)
+      expect(result.errors.for(:transaction).on(:processing_merchant_category_code)[0].code).to eq(Braintree::ErrorCodes::Transaction::ProcessingMerchantCategoryCodeIsInvalid)
+    end
+
+    it "returns validation error for a too short processing_merchant_category_code" do
+      result = Braintree::Transaction.sale(
+        :amount => "100.00",
+        :credit_card => {
+          :number => "4111111111111111",
+          :expiration_date => "05/2028"
+        },
+        :processing_merchant_category_code => "541",
+      )
+
+      expect(result.success?).to eq(false)
+      expect(result.errors.for(:transaction).on(:processing_merchant_category_code)[0].code).to eq(Braintree::ErrorCodes::Transaction::ProcessingMerchantCategoryCodeIsInvalid)
+    end
+
     it "allows merchant account to be specified" do
       result = Braintree::Transaction.sale(
         :amount => Braintree::Test::TransactionAmounts::Authorize,
@@ -6815,6 +6870,34 @@ describe Braintree::Transaction do
       expect(transaction.acquirer_reference_number).to eq("123456789 091019")
     end
 
+    it "finds a transaction and returns a payment_account_reference if the transaction has one" do
+      transaction = Braintree::Transaction.find("aft_txn")
+
+      expect(transaction.credit_card_details).not_to be_nil
+      expect(transaction.credit_card_details).to respond_to(:payment_account_reference)
+    end
+
+    it "finds a transaction and returns a payment_account_reference in apple_pay_details if the transaction has one" do
+      transaction = Braintree::Transaction.find("apple_pay_transaction")
+
+      expect(transaction.apple_pay_details).not_to be_nil
+      expect(transaction.apple_pay_details).to respond_to(:payment_account_reference)
+    end
+
+    it "finds a transaction and returns a payment_account_reference in google_pay_details if the transaction has one" do
+      transaction = Braintree::Transaction.find("android_pay_card_transaction")
+
+      expect(transaction.google_pay_details).not_to be_nil
+      expect(transaction.google_pay_details).to respond_to(:payment_account_reference)
+    end
+
+    it "finds a transaction and returns a payment_account_reference in google_pay_details for network token if the transaction has one" do
+      transaction = Braintree::Transaction.find("android_pay_network_token_transaction")
+
+      expect(transaction.google_pay_details).not_to be_nil
+      expect(transaction.google_pay_details).to respond_to(:payment_account_reference)
+    end
+
     context "disbursement_details" do
       it "includes disbursement_details on found transactions" do
         found_transaction = Braintree::Transaction.find("deposittransaction")

data/spec/integration/braintree/transaction_us_bank_account_spec.rb

@@ -140,7 +140,6 @@ describe Braintree::Transaction do
             expect(transaction.us_bank_account_details.account_type).to eq("checking")
             expect(transaction.us_bank_account_details.account_holder_name).to eq("John Doe")
             expect(transaction.us_bank_account_details.bank_name).to match(/CHASE/)
-            expect(transaction.us_bank_account_details.ach_mandate.text).to eq("cl mandate text")
             expect(transaction.us_bank_account_details.ach_mandate.accepted_at).to be_a Time
           end
 

data/spec/integration/braintree/us_bank_account_spec.rb

@@ -23,7 +23,6 @@ describe Braintree::UsBankAccount do
       expect(us_bank_account.account_type).to eq("checking")
       expect(us_bank_account.account_holder_name).to eq("John Doe")
       expect(us_bank_account.bank_name).to match(/CHASE/)
-      expect(us_bank_account.ach_mandate.text).to eq("cl mandate text")
       expect(us_bank_account.ach_mandate.accepted_at).to be_a Time
     end
 
@@ -63,7 +62,6 @@ describe Braintree::UsBankAccount do
       expect(us_bank_account.account_type).to eq("checking")
       expect(us_bank_account.account_holder_name).to eq("John Doe")
       expect(us_bank_account.bank_name).to match(/CHASE/)
-      expect(us_bank_account.ach_mandate.text).to eq("cl mandate text")
       expect(us_bank_account.ach_mandate.accepted_at).to be_a Time
     end
   end
@@ -96,7 +94,6 @@ describe Braintree::UsBankAccount do
       expect(us_bank_account.account_type).to eq("checking")
       expect(us_bank_account.account_holder_name).to eq("John Doe")
       expect(us_bank_account.bank_name).to match(/CHASE/)
-      expect(us_bank_account.ach_mandate.text).to eq("cl mandate text")
       expect(us_bank_account.ach_mandate.accepted_at).to be_a Time
     end
 

data/spec/unit/braintree/credit_card_verification_spec.rb

@@ -159,4 +159,21 @@ describe Braintree::CreditCardVerification do
       expect(verification.network_response_text).to eq("Successful approval/completion or V.I.P. PIN verification is successful")
     end
   end
+
+  describe "credit_card with payment_account_reference" do
+    it "includes payment_account_reference in credit_card hash when present" do
+      verification = Braintree::CreditCardVerification._new(
+        :status => "verified",
+        :credit_card => {
+          :bin => "401288",
+          :last_4 => "1881",
+          :card_type => "Visa",
+          :payment_account_reference => "V0010013019339005665779448477"
+        },
+      )
+
+      expect(verification.credit_card).to be_a(Hash)
+      expect(verification.credit_card[:payment_account_reference]).to eq("V0010013019339005665779448477")
+    end
+  end
 end

data/spec/unit/braintree/transaction/apple_pay_details_spec.rb

@@ -25,4 +25,13 @@ describe Braintree::ApplePayDetails do
     card = Braintree::ApplePayDetails._new(:gateway, {:purchase => "No"})
     expect(card.purchase).to eq("No")
   end
+
+  describe "payment_account_reference" do
+    it "returns the payment account reference when present" do
+      details = Braintree::Transaction::ApplePayDetails.new(
+        :payment_account_reference => "V0010013019339005665779448477",
+      )
+      expect(details.payment_account_reference).to eq("V0010013019339005665779448477")
+    end
+  end
 end

data/spec/unit/braintree/transaction/credit_card_details_spec.rb

@@ -39,7 +39,7 @@ describe Braintree::Transaction::CreditCardDetails do
         :image_url => "example.com/visa.png",
         :unique_number_identifier => "abc123",
       )
-      expect(details.inspect).to eq(%(#<token: "token", bin: "123456", business: "No", last_4: "6789", card_type: "Visa", commercial: "Unknown", consumer: "Unknown", corporate: "Unknown", country_of_issuance: "Lilliput", customer_location: "US", debit: "Yes", durbin_regulated: "No", expiration_date: "05/2012", healthcare: "No", image_url: "example.com/visa.png", issuing_bank: "Gulliver Bank", payroll: "Unknown", prepaid: "Yes", prepaid_reloadable: "Yes", product_id: "Unknown", purchase: "Unknown", cardholder_name: "The Cardholder", unique_number_identifier: "abc123">))
+      expect(details.inspect).to eq(%(#<token: "token", bin: "123456", business: "No", last_4: "6789", card_type: "Visa", commercial: "Unknown", consumer: "Unknown", corporate: "Unknown", country_of_issuance: "Lilliput", customer_location: "US", debit: "Yes", durbin_regulated: "No", expiration_date: "05/2012", healthcare: "No", image_url: "example.com/visa.png", issuing_bank: "Gulliver Bank", payroll: "Unknown", prepaid: "Yes", prepaid_reloadable: "Yes", product_id: "Unknown", purchase: "Unknown", cardholder_name: "The Cardholder", unique_number_identifier: "abc123", payment_account_reference: nil>))
     end
   end
 
@@ -67,4 +67,13 @@ describe Braintree::Transaction::CreditCardDetails do
       expect(details.is_network_tokenized?).to eq(false)
     end
   end
+
+  describe "payment_account_reference" do
+    it "returns the payment account reference when present" do
+      details = Braintree::Transaction::CreditCardDetails.new(
+        :payment_account_reference => "V0010013019339005665779448477",
+      )
+      expect(details.payment_account_reference).to eq("V0010013019339005665779448477")
+    end
+  end
 end

data/spec/unit/braintree/transaction/google_pay_details_spec.rb

@@ -25,4 +25,13 @@ describe Braintree::GooglePayDetails do
     card = Braintree::GooglePayDetails._new(:gateway, {:purchase => "No"})
     expect(card.purchase).to eq("No")
   end
+
+  context "payment_account_reference" do
+    it "returns the payment account reference when present" do
+      details = Braintree::Transaction::GooglePayDetails.new(
+        :payment_account_reference => "V0010013019339005665779448477",
+      )
+      expect(details.payment_account_reference).to eq("V0010013019339005665779448477")
+    end
+  end
 end

data/spec/unit/braintree/transaction_gateway_spec.rb

@@ -35,7 +35,7 @@ describe Braintree::TransactionGateway do
       expect(Braintree::TransactionGateway._create_signature).to match([
         :amount, :billing_address_id, :channel, :currency_iso_code, :customer_id, :device_data,
         :discount_amount, :exchange_rate_quote_id, :foreign_retailer,
-        :merchant_account_id, :order_id, :payment_method_nonce, :payment_method_token,
+        :merchant_account_id, :order_id, :payment_method_nonce, :payment_method_token, :processing_merchant_category_code,
         :product_sku, :purchase_order_number, :service_fee_amount, :shared_billing_address_id,
         :shared_customer_id, :shared_payment_method_nonce, :shared_payment_method_token,
         :shared_shipping_address_id, :shipping_address_id, :shipping_amount, :shipping_tax_amount,

data/spec/unit/braintree/transaction_spec.rb

@@ -157,6 +157,44 @@ describe Braintree::Transaction do
       expect(transaction.credit_card_details.issuing_bank).to eq("Mr Tumnus")
     end
 
+    describe "payment_account_reference in transaction details" do
+      it "exposes payment_account_reference in credit_card_details" do
+        transaction = Braintree::Transaction._new(
+          :gateway,
+          :credit_card => {
+            :bin => "401288",
+            :last_4 => "1881",
+            :card_type => "Visa",
+            :payment_account_reference => "V0010013019339005665779448477"
+          },
+        )
+        expect(transaction.credit_card_details.payment_account_reference).to eq("V0010013019339005665779448477")
+      end
+
+      it "exposes payment_account_reference in apple_pay_details" do
+        transaction = Braintree::Transaction._new(
+          :gateway,
+          :apple_pay => {
+            :payment_instrument_name => "Apple Pay",
+            :payment_account_reference => "V0010013019339005665779448477"
+          },
+        )
+        expect(transaction.apple_pay_details.payment_account_reference).to eq("V0010013019339005665779448477")
+      end
+
+      it "exposes payment_account_reference in google_pay_details" do
+        transaction = Braintree::Transaction._new(
+          :gateway,
+          :android_pay_card => {
+            :virtual_card_type => "Visa",
+            :payment_account_reference => "V0010013019339005665779448477"
+          },
+        )
+        expect(transaction.google_pay_details.payment_account_reference).to eq("V0010013019339005665779448477")
+      end
+
+    end
+
     it "sets up network token attributes in network_token_details" do
       transaction = Braintree::Transaction._new(
         :gateway,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: braintree
 version: !ruby/object:Gem::Version
-  version: 4.31.0
+  version: 4.32.0
 platform: ruby
 authors:
 - Braintree
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-06 00:00:00.000000000 Z
+date: 2025-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder
@@ -420,7 +420,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.2.5
 signing_key: 
 specification_version: 4
 summary: Braintree Ruby Server SDK