4.28.0

Co-authored-by: Kevin Laguerre <klaguerre@paypal.com>

Author: braintreeps

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 4.28.0
+
+- Add `account_information_inquiry` to
+  - `CreditCardVerification#create`
+  - `PaymentMethod#create` and `PaymentMethod#update`
+  - `CreditCard#create` and `CreditCard#update`
+- Enhancements to PayPal customer recommendations
+  - Create a session and get recommendations in one call
+  - Hash customer email and phone number
+- Add `business`, `consumer`, `corporate`, and `purchase` from the bin data to credit card responses
+
 ## 4.27.0
 
 - Remove marketplace features

README.md

@@ -32,7 +32,7 @@ The Braintree Ruby SDK is tested against Ruby versions 2.6, 2.7 and 3.0.
 _The Ruby core development community has released [End-of-Life branches](https://www.ruby-lang.org/en/downloads/branches/) for Ruby versions lower than 2.6, which are no longer receiving security updates. As a result, Braintree no longer supports these versions of Ruby. **We have updated our gem specifications to reflect these updates.**_
 
 ## Versions
-> :warning: **The SSL certificates for Ruby SDK versions older than 4.23.0 are set to expire by June 31, 2025. If you do not update your SDK to the latest version with the updated certificates by June 31, 2025, 100% of your impacted traffic will fail**
+> :warning: **The SSL certificates for Ruby SDK versions older than 2.82.0 are set to expire by March 30, 2026. If you do not update your SDK to the latest version with the updated certificates by March 30, 2026, 100% of your impacted traffic will fail**
 
 Braintree employs a deprecation policy for our SDKs. For more information on the statuses of an SDK check our [developer docs](https://developer.paypal.com/braintree/docs/reference/general/server-sdk-deprecation-policy). [Minimum supported versions](https://developer.paypal.com/braintree/docs/reference/general/best-practices/ruby#server-sdk-versions) are also available in our developer docs.
 

lib/braintree.rb

@@ -83,8 +83,12 @@
 require "braintree/graphql/inputs/customer_session_input"
 require "braintree/graphql/inputs/phone_input"
 require "braintree/graphql/inputs/update_customer_session_input"
+require "braintree/graphql/inputs/paypal_purchase_unit_input"
+require "braintree/graphql/inputs/paypal_payee_input"
+require "braintree/graphql/inputs/monetary_amount_input"
 require "braintree/graphql/types/customer_recommendations_payload"
 require "braintree/graphql/types/payment_options"
+require "braintree/graphql/types/payment_recommendations"
 require "braintree/graphql/unions/customer_recommendations"
 require "braintree/graphql_client"
 require "braintree/google_pay_card"

lib/braintree/apple_pay_card.rb

@@ -12,9 +12,12 @@ module CardType
 
     attr_reader :billing_address
     attr_reader :bin
+    attr_reader :business
     attr_reader :card_type
     attr_reader :cardholder_name
     attr_reader :commercial
+    attr_reader :consumer
+    attr_reader :corporate
     attr_reader :country_of_issuance
     attr_reader :created_at
     attr_reader :customer_id
@@ -34,6 +37,7 @@ module CardType
     attr_reader :prepaid
     attr_reader :prepaid_reloadable
     attr_reader :product_id
+    attr_reader :purchase
     attr_reader :source_card_last4
     attr_reader :source_description
     attr_reader :subscriptions

lib/braintree/bin_data.rb

@@ -2,7 +2,10 @@ module Braintree
   class BinData
     include BaseModule
 
+    attr_reader :business
     attr_reader :commercial
+    attr_reader :consumer
+    attr_reader :corporate
     attr_reader :country_of_issuance
     attr_reader :debit
     attr_reader :durbin_regulated
@@ -12,6 +15,7 @@ class BinData
     attr_reader :prepaid
     attr_reader :prepaid_reloadable
     attr_reader :product_id
+    attr_reader :purchase
 
     def initialize(attributes)
       set_instance_variables_from_hash attributes unless attributes.nil?
@@ -26,8 +30,9 @@ def inspect
 
     def self._attributes
       [
-        :commercial, :country_of_issuance, :debit, :durbin_regulated, :healthcare,
-        :issuing_bank, :payroll, :prepaid, :prepaid_reloadable, :product_id
+        :business, :commercial, :consumer, :corporate, :country_of_issuance, :debit,
+        :durbin_regulated, :healthcare, :issuing_bank, :payroll, :prepaid,
+        :prepaid_reloadable, :product_id, :purchase
       ]
     end
   end

lib/braintree/credit_card.rb

@@ -45,14 +45,18 @@ module CardTypeIndicator
       Unknown = "Unknown"
     end
 
-    Commercial = CountryOfIssuance = Debit = DurbinRegulated = Healthcare =
-      IssuingBank = Payroll = Prepaid = PrepaidReloadable = ProductId = CardTypeIndicator
+    Business = Commercial = Consumer = Corporate = CountryOfIssuance = Debit =
+      DurbinRegulated = Healthcare = IssuingBank = Payroll = Prepaid = PrepaidReloadable =
+      ProductId = Purchase = CardTypeIndicator
 
     attr_reader :billing_address
     attr_reader :bin
+    attr_reader :business
     attr_reader :card_type
     attr_reader :cardholder_name
     attr_reader :commercial
+    attr_reader :consumer
+    attr_reader :corporate
     attr_reader :country_of_issuance
     attr_reader :created_at
     attr_reader :customer_id
@@ -68,6 +72,7 @@ module CardTypeIndicator
     attr_reader :prepaid
     attr_reader :prepaid_reloadable
     attr_reader :product_id
+    attr_reader :purchase
     attr_reader :subscriptions
     attr_reader :token
     attr_reader :unique_number_identifier
@@ -200,9 +205,10 @@ class << self
 
     def self._attributes
       [
-        :billing_address, :bin, :card_type, :cardholder_name, :commercial, :country_of_issuance, :created_at, :customer_id,
-        :debit, :durbin_regulated, :expiration_month, :expiration_year, :healthcare, :image_url, :is_network_tokenized?,
-        :issuing_bank, :last_4, :payroll, :prepaid, :prepaid_reloadable, :product_id, :token, :updated_at
+        :billing_address, :bin, :business, :card_type, :cardholder_name, :commercial, :consumer, :corporate,
+        :country_of_issuance, :created_at, :customer_id, :debit, :durbin_regulated, :expiration_month,
+        :expiration_year, :healthcare, :image_url, :is_network_tokenized?, :issuing_bank, :last_4, :payroll,
+        :prepaid, :prepaid_reloadable, :product_id, :purchase, :token, :updated_at
       ]
     end
 

lib/braintree/credit_card_gateway.rb

@@ -96,6 +96,7 @@ def self._signature(type)
       # NEXT_MAJOR_VERSION Remove venmo_sdk_session
       # The old venmo SDK class has been deprecated
       options = [
+        :account_information_inquiry,
         :fail_on_duplicate_payment_method,
         :fail_on_duplicate_payment_method_for_customer,
         :make_default,

lib/braintree/credit_card_verification_gateway.rb

@@ -61,6 +61,7 @@ def self._create_signature
         ]},
         :intended_transaction_source,
         {:options => [
+          :account_information_inquiry,
           :account_type,
           :amount,
           :merchant_account_id,

lib/braintree/customer_session_gateway.rb

@@ -19,16 +19,13 @@ class CustomerSessionGateway
       GRAPHQL
 
       GET_CUSTOMER_RECOMMENDATIONS = <<~GRAPHQL
-        query CustomerRecommendations($input: CustomerRecommendationsInput!) {
-          customerRecommendations(input: $input) {
+        mutation GenerateCustomerRecommendations($input: GenerateCustomerRecommendationsInput!) {
+          generateCustomerRecommendations(input: $input) {
+            sessionId
             isInPayPalNetwork
-            recommendations {
-              ... on PaymentRecommendations {
-                paymentOptions {
+            paymentRecommendations {
                   paymentOption
                   recommendedPriority
-                }
-              }
             }
           }
         }
@@ -143,7 +140,11 @@ def get_customer_recommendations(customer_recommendations_input)
             SuccessfulResult.new(:customer_recommendations => extract_customer_recommendations_payload(response))
           end
         rescue StandardError => e
-          raise UnexpectedError, e.message
+          if e.message.include?("Authorization failed")
+            raise AuthorizationError, e.message
+          else
+            raise ServerError, e.message
+          end
         end
       end
 
@@ -187,8 +188,8 @@ def pop_value(map, key)
       end
 
       def extract_customer_recommendations_payload(data)
-        customer_recommendations_hash = get_value(data, "data.customerRecommendations")
-        Braintree::CustomerRecommendationsPayload._new(customer_recommendations_hash)
+        customer_recommendations_hash = get_value(data, "data.generateCustomerRecommendations")
+        Braintree::CustomerRecommendationsPayload._new({:response => {"generateCustomerRecommendations" => customer_recommendations_hash}})
       end
     end
   end

lib/braintree/google_pay_card.rb

@@ -3,7 +3,10 @@ class GooglePayCard
     include BaseModule
 
     attr_reader :bin
+    attr_reader :business
     attr_reader :commercial
+    attr_reader :consumer
+    attr_reader :corporate
     attr_reader :country_of_issuance
     attr_reader :created_at
     attr_reader :customer_id
@@ -20,6 +23,7 @@ class GooglePayCard
     attr_reader :prepaid
     attr_reader :prepaid_reloadable
     attr_reader :product_id
+    attr_reader :purchase
     attr_reader :source_card_last_4
     attr_reader :source_card_type
     attr_reader :source_description