braintree 4.36.0 → 4.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bddd5ecd987b2c8f75088ac1877e7273eebe8463165f9c1db10c92f61aa5961a
-  data.tar.gz: 7757bdac8b5bf0808812c073b5e8fcd50e759b4078c51c41def3590467651f12
+  metadata.gz: 9847c722f0454ca6210b66fd3c083214b2f81947e2b8e2aa3ffd31e7892ae5c1
+  data.tar.gz: 0faf0a4519808b21007000b57e353fbf6fd89c02a64551f6fa5560fa00f9fbde
 SHA512:
-  metadata.gz: 37bba6f56222e7f56caca748920befd5d8f443669411cd42f998fe9c17d4c381605e50c38732ce5831f1e6368806ddb96ac0baa4438dd3dc34294d63db5cdfde
-  data.tar.gz: 7f2ae5944a6e3b08da6df35cb6c26aeffbac5c6baa6124d24ddf52abdc7216b6a6a3e77278124993cec2592513cff4ad9d2619eb7b65b15ea835f3fa37f239a5
+  metadata.gz: 91921d4cd7aabff1e758003dc4de8e715c5dd3ba704d5682b9adb74340012eb94eb7c328e40a6620985b1ad129006d62d2c15160f49b483f9b34d3ea8e441d6b
+  data.tar.gz: 384b5dcaf3a750f916b1cfb49bc60b625d8cc8c2fc729f3999fe81e6b5c0fcdba32de94cdceb7fde1a1184a12fb3eeaf95eac2dfbfb46c58b38935d578e82b78

data/lib/braintree/credit_card_verification.rb

@@ -40,6 +40,7 @@ module Braintree
     attr_reader :gateway_rejection_reason
     attr_reader :graphql_id
     attr_reader :id
+    attr_reader :mastercard_transaction_link_id
     attr_reader :merchant_account_id
     attr_reader :network_response_code
     attr_reader :network_response_text

data/lib/braintree/transaction.rb

@@ -122,6 +122,7 @@ module Braintree
     attr_reader :installment_count
     attr_reader :installments
     attr_reader :local_payment_details
+    attr_reader :mastercard_transaction_link_id
     attr_reader :merchant_account_id
     attr_reader :merchant_advice_code
     attr_reader :merchant_advice_code_text

data/lib/braintree/transaction_gateway.rb

@@ -344,6 +344,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 = 36
+    Minor = 38
     Tiny = 0
 
     String = "#{Major}.#{Minor}.#{Tiny}"

data/spec/integration/braintree/credit_card_verification_spec.rb

@@ -48,6 +48,42 @@ describe Braintree::CreditCardVerification, "search" do
       expect(result.credit_card_verification.processor_response_type).to eq(Braintree::ProcessorResponseTypes::Approved)
     end
 
+    it "returns mastercard transaction link id in response" do
+      verification_params = {
+        :credit_card => {
+          :expiration_date => "05/2032",
+          :number => Braintree::Test::CreditCardNumbers::MasterCard,
+        },
+      }
+
+      result = Braintree::CreditCardVerification.create(verification_params)
+
+      expect(result).to be_success
+      expect(result.credit_card_verification.status).to eq(Braintree::CreditCardVerification::Status::Verified)
+      expect(result.credit_card_verification.processor_response_code).to eq("1000")
+      expect(result.credit_card_verification.processor_response_text).to eq("Approved")
+      expect(result.credit_card_verification.processor_response_type).to eq(Braintree::ProcessorResponseTypes::Approved)
+      expect(result.credit_card_verification.mastercard_transaction_link_id).to match(/\A[a-zA-Z0-9]{22}\z/)
+    end
+
+    it "doesnot return mastercard transaction link id in response for a non mastercard" do
+      verification_params = {
+        :credit_card => {
+          :expiration_date => "05/2032",
+          :number => Braintree::Test::CreditCardNumbers::Visa,
+        },
+      }
+
+      result = Braintree::CreditCardVerification.create(verification_params)
+
+      expect(result).to be_success
+      expect(result.credit_card_verification.status).to eq(Braintree::CreditCardVerification::Status::Verified)
+      expect(result.credit_card_verification.processor_response_code).to eq("1000")
+      expect(result.credit_card_verification.processor_response_text).to eq("Approved")
+      expect(result.credit_card_verification.processor_response_type).to eq(Braintree::ProcessorResponseTypes::Approved)
+      expect(result.credit_card_verification.mastercard_transaction_link_id).to be_nil
+    end
+
     it "creates a new verification for Visa ANI" do
       verification_params = {
         :credit_card => {

data/spec/integration/braintree/transaction_spec.rb

@@ -336,7 +336,7 @@ describe Braintree::Transaction do
 
     describe "sca_exemption" do
       context "with a valid request" do
-        it "succeeds" do
+        xit "succeeds" do
           requested_exemption = "low_value"
           result = Braintree::Transaction.create(
             :type => "sale",
@@ -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,
@@ -7960,6 +8044,40 @@ describe Braintree::Transaction do
     end
   end
 
+  describe "mastercard_transaction_link_id" do
+    it "is available in response for mastercard" do
+      result = Braintree::Transaction.create(
+        :type => "sale",
+        :amount => Braintree::Test::TransactionAmounts::Authorize,
+        :accept_partial_authorization => true,
+        :credit_card => {
+          :number => Braintree::Test::CreditCardNumbers::MasterCard,
+          :expiration_date => "05/2029"
+        },
+      )
+
+      expect(result.success?).to eq(true)
+      expect(result.transaction.processor_response_code).to eq("1000")
+      expect(result.transaction.mastercard_transaction_link_id).to match(/\A[a-zA-Z0-9]{22}\z/)
+    end
+
+    it "is not available in response for non mastercard" do
+      result = Braintree::Transaction.create(
+        :type => "sale",
+        :amount => Braintree::Test::TransactionAmounts::Authorize,
+        :accept_partial_authorization => true,
+        :credit_card => {
+          :number => Braintree::Test::CreditCardNumbers::Visa,
+          :expiration_date => "05/2029"
+        },
+      )
+
+      expect(result.success?).to eq(true)
+      expect(result.transaction.processor_response_code).to eq("1000")
+      expect(result.transaction.mastercard_transaction_link_id).to be_nil
+    end
+  end
+
   context "Surcharge Amount" do
     it "accepts surcharge_amount field" do
       result = Braintree::Transaction.create(

data/spec/unit/braintree/credit_card_verification_spec.rb

@@ -60,6 +60,13 @@ describe Braintree::CreditCardVerification do
     expect(verification.network_transaction_id).to eq "123456789012345"
   end
 
+  it "sets mastercard_transaction_link_id" do
+    verification = Braintree::CreditCardVerification._new(
+      :mastercard_transaction_link_id => "ZairABg6CIFekPMsnK0cJ2",
+    )
+    expect(verification.mastercard_transaction_link_id).to eq "ZairABg6CIFekPMsnK0cJ2"
+  end
+
   describe "self.create" do
     it "rejects invalid parameters" do
       expect do

data/spec/unit/braintree/transaction_gateway_spec.rb

@@ -185,6 +185,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
@@ -577,6 +583,16 @@ describe Braintree::Transaction do
     end
   end
 
+  describe "mastercard transaction link id" do
+    it "is correctly set" do
+      transaction = Braintree::Transaction._new(
+        :gateway,
+        :mastercard_transaction_link_id => "ZairABg6CIFekPMsnK0cJ2",
+      )
+      expect(transaction.mastercard_transaction_link_id).to eq("ZairABg6CIFekPMsnK0cJ2")
+    end
+  end
+
   describe "request includes surcharge amount" do
     it "if the surcharge_amount is present" do
       transaction = Braintree::Transaction._new(:gateway, :surcharge_amount => "1.00")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: braintree
 version: !ruby/object:Gem::Version
-  version: 4.36.0
+  version: 4.38.0
 platform: ruby
 authors:
 - Braintree
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-05 00:00:00.000000000 Z
+date: 2026-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder