braintree 4.23.0 → 4.34.0

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

@@ -0,0 +1,129 @@
+# Represents the customer recommendations information associated with a PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+  class CustomerRecommendationsPayload
+    include BaseModule
+
+    attr_reader :attrs
+    attr_reader :session_id
+    attr_reader :is_in_paypal_network
+    attr_reader :recommendations
+
+    def initialize(attributes)
+      @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
+          puts e.backtrace.join("\n")
+          raise
+        end
+      else
+        @session_id = attributes[:session_id]
+        @is_in_paypal_network = attributes[:is_in_paypal_network]
+        @recommendations = attributes[:recommendations]
+      end
+    end
+
+    def _extract_recommendations(response)
+      begin
+        payment_recommendations = _get_value(response, "generateCustomerRecommendations.paymentRecommendations")
+
+        payment_options_list = []
+        payment_recommendations_list = []
+
+        payment_recommendations.each_with_index do |recommendation, _i|
+          recommended_priority = _get_value(recommendation, "recommendedPriority")
+          payment_option_string = _get_value(recommendation, "paymentOption")
+
+          begin
+            payment_option = payment_option_string
+
+            payment_option_obj = Braintree::PaymentOptions._new({
+              paymentOption: payment_option,
+              recommendedPriority: recommended_priority
+            })
+
+            payment_recommendation_obj = Braintree::PaymentRecommendations._new({
+              paymentOption: payment_option,
+              recommendedPriority: recommended_priority
+            })
+
+            payment_options_list << payment_option_obj
+            payment_recommendations_list << payment_recommendation_obj
+          rescue => e
+            puts e.backtrace.join("\n")
+            raise
+          end
+        end
+
+        customer_recommendations = CustomerRecommendations._new({
+          payment_recommendations: payment_recommendations_list
+        })
+
+        return customer_recommendations
+      rescue => e
+        puts e.backtrace.join("\n")
+        raise ServerError.new("Error extracting recommendations: #{e.message}")
+      end
+    end
+
+    def _get_value(response, key)
+      current_map = response
+      key_parts = key.split(".")
+
+      # Navigate through nested dictionaries for all but last key
+      (0...key_parts.length - 1).each do |i|
+        sub_key = key_parts[i]
+        current_map = _pop_value(current_map, sub_key)
+      end
+
+      # Get the final value
+      last_key = key_parts[-1]
+      value = _pop_value(current_map, last_key)
+      return value
+    end
+
+    def _pop_value(response, key)
+
+    # Try as string first
+    if response.key?(key)
+        return response[key]
+    end
+
+    # Then try as symbol
+    symkey = key.to_sym
+    if response.key?(symkey)
+        return response[symkey]
+    end
+
+    # Finally try as string with string keys
+    if response.key?(key.to_s)
+        return response[key.to_s]
+    end
+
+    raise ServerError.new("Couldn't parse response")
+    end
+    def inspect
+      inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+      "#<#{self.class} #{inspected_attributes.join(" ")}>"
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args)
+      self.new(*args)
+    end
+  end
+end
+
+

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

@@ -0,0 +1,35 @@
+# Represents the payment method and priority associated with a PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class PaymentOptions
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :payment_option
+        attr_reader :recommended_priority
+
+        def initialize(attributes)
+            @attrs = [:payment_option, :recommended_priority]
+            @payment_option = attributes[:paymentOption] if attributes[:paymentOption]
+            @recommended_priority = attributes[:recommendedPriority] if attributes[:recommendedPriority]
+
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        class << self
+            protected :new
+        end
+
+        def self._new(*args)
+            self.new(*args)
+        end
+    end
+end
+
+

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

@@ -0,0 +1,35 @@
+# Represents the payment method and priority associated with a PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class PaymentRecommendations
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :payment_option
+        attr_reader :recommended_priority
+
+        def initialize(attributes)
+            @attrs = [:payment_option, :recommended_priority]
+            @payment_option = attributes[:paymentOption] if attributes[:paymentOption]
+            @recommended_priority = attributes[:recommendedPriority] if attributes[:recommendedPriority]
+
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        class << self
+            protected :new
+        end
+
+        def self._new(*args)
+            self.new(*args)
+        end
+    end
+end
+
+

data/lib/braintree/graphql/unions/customer_recommendations.rb

@@ -0,0 +1,47 @@
+# A union of all possible customer recommendations associated with a PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+  class CustomerRecommendations
+    include BaseModule
+
+    attr_reader :payment_options, :payment_recommendations
+
+    def initialize(attributes = {})
+      @payment_recommendations = initialize_payment_recommendations(attributes[:payment_recommendations])
+
+      # Always derive payment_options from payment_recommendations
+      @payment_options = @payment_recommendations.map do |recommendation|
+        PaymentOptions._new(
+          paymentOption: recommendation.payment_option,
+          recommendedPriority: recommendation.recommended_priority,
+        )
+      end
+    end
+
+    def inspect
+      "#<#{self.class} payment_options: #{payment_options.inspect}, payment_recommendations: #{payment_recommendations.inspect}>"
+    end
+
+    private
+
+    def initialize_payment_recommendations(payment_recommendations)
+      return [] if payment_recommendations.nil?
+
+      payment_recommendations.map do |recommendation_hash|
+        if recommendation_hash.is_a?(PaymentRecommendations)
+          recommendation_hash
+        else
+          PaymentRecommendations._new(recommendation_hash)
+        end
+      end
+    end
+
+    class << self
+      def _new(attributes = {})
+        new(attributes)
+      end
+    end
+  end
+end

data/lib/braintree/graphql_client.rb

@@ -30,5 +30,21 @@ module Braintree
       body = Zlib::GzipReader.new(StringIO.new(body)).read if response.header["Content-Encoding"] == "gzip"
       JSON.parse(body, :symbolize_names => true)
     end
+
+    def self.get_validation_errors(response)
+      return nil unless response.key?(:errors) && response[:errors].is_a?(Array)
+      validation_errors = response[:errors].map do |error|
+        {
+          :attribute => "",
+          :code => get_validation_error_code(error),
+          :message => error[:message]
+        }
+      end
+      {errors: validation_errors}
+    end
+
+    def self.get_validation_error_code(error)
+      error[:extensions] && error[:extensions][:legacyCode] rescue nil
+    end
   end
 end

data/lib/braintree/merchant_account.rb

@@ -18,44 +18,20 @@ module Braintree
       include Braintree::MerchantAccount::FundingDestination
     end
 
-    attr_reader :business_details
     attr_reader :currency_iso_code
     attr_reader :default
-    attr_reader :funding_details
     attr_reader :id
-    attr_reader :individual_details
-    attr_reader :master_merchant_account
     attr_reader :status
 
     alias_method :default?, :default
 
-    def self.create(*args)
-      Configuration.gateway.merchant_account.create(*args)
-    end
-
-    def self.create!(*args)
-      Configuration.gateway.merchant_account.create!(*args)
-    end
-
     def self.find(*args)
       Configuration.gateway.merchant_account.find(*args)
     end
 
-    def self.update(*args)
-      Configuration.gateway.merchant_account.update(*args)
-    end
-
-    def self.update!(*args)
-      Configuration.gateway.merchant_account.update!(*args)
-    end
-
     def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
-      @individual_details = IndividualDetails.new(@individual)
-      @business_details = BusinessDetails.new(@business)
-      @funding_details = FundingDetails.new(@funding)
-      @master_merchant_account = MerchantAccount._new(@gateway, attributes.delete(:master_merchant_account)) if attributes[:master_merchant_account]
     end
 
     class << self
@@ -66,7 +42,7 @@ module Braintree
     end
 
     def inspect
-      order = [:id, :status, :master_merchant_account]
+      order = [:id, :status]
       nice_attributes = order.map do |attr|
         "#{attr}: #{send(attr).inspect}"
       end

data/lib/braintree/merchant_account_gateway.rb

@@ -20,16 +20,6 @@ module Braintree
       PaginatedResult.new(body[:total_items], body[:page_size], merchant_accounts)
     end
 
-    def create(attributes)
-      signature = MerchantAccountGateway._detect_signature(attributes)
-      Util.verify_keys(signature, attributes)
-      _do_create "/merchant_accounts/create_via_api", :merchant_account => attributes
-    end
-
-    def create!(*args)
-      return_object_or_raise(:merchant_account) { create(*args) }
-    end
-
     def find(merchant_account_id)
       raise ArgumentError if merchant_account_id.nil? || merchant_account_id.to_s.strip == ""
       response = @config.http.get("#{@config.base_merchant_path}/merchant_accounts/#{merchant_account_id}")
@@ -38,37 +28,10 @@ module Braintree
       raise NotFoundError, "Merchant account with id #{merchant_account_id} not found"
     end
 
-    def update(merchant_account_id, attributes)
-      Util.verify_keys(MerchantAccountGateway._update_signature, attributes)
-      _do_update "/merchant_accounts/#{merchant_account_id}/update_via_api", :merchant_account => attributes
-    end
-
-    def update!(*args)
-      return_object_or_raise(:merchant_account) { update(*args) }
-    end
-
     def create_for_currency(params)
       _create_for_currency(params)
     end
 
-    def _do_create(path, params=nil)
-      response = @config.http.post("#{@config.base_merchant_path}#{path}", params)
-      if response[:api_error_response]
-        ErrorResult.new(@gateway, response[:api_error_response])
-      else
-        SuccessfulResult.new(:merchant_account => MerchantAccount._new(@gateway, response[:merchant_account]))
-      end
-    end
-
-    def _do_update(path, params=nil)
-      response = @config.http.put("#{@config.base_merchant_path}#{path}", params)
-      if response[:api_error_response]
-        ErrorResult.new(@gateway, response[:api_error_response])
-      else
-        SuccessfulResult.new(:merchant_account => MerchantAccount._new(@gateway, response[:merchant_account]))
-      end
-    end
-
     def _create_for_currency(params)
       response = @config.http.post("#{@config.base_merchant_path}/merchant_accounts/create_for_currency", :merchant_account => params)
 
@@ -82,49 +45,5 @@ module Braintree
         raise UnexpectedError, "expected :merchant or :api_error_response"
       end
     end
-
-    # NEXT_MAJOR_VERSION this is part of Marketplace and shouldn't be removed unless we're removing all Marketplace code
-    def self._detect_signature(attributes)
-      if attributes.has_key?(:applicant_details)
-        warn "[DEPRECATED] Passing :applicant_details to create is deprecated. Please use :individual, :business, and :funding."
-        MerchantAccountGateway._deprecated_create_signature
-      else
-        MerchantAccountGateway._create_signature
-      end
-    end
-
-    # NEXT_MAJOR_VERSION this is part of Marketplace and shouldn't be removed unless we're removing all Marketplace code
-    def self._deprecated_create_signature
-      [
-        {:applicant_details => [
-          :first_name, :last_name, :email, :date_of_birth, :ssn, :routing_number,
-          :account_number, :tax_id, :company_name, :phone,
-          {:address => [:street_address, :postal_code, :locality, :region]}]
-        },
-        :tos_accepted, :master_merchant_account_id, :id
-      ]
-    end
-
-    def self._signature
-      [
-        {:individual => [
-          :first_name, :last_name, :email, :date_of_birth, :ssn, :phone,
-          {:address => [:street_address, :locality, :region, :postal_code]}]
-        },
-        {:business => [
-          :dba_name, :legal_name, :tax_id,
-          {:address => [:street_address, :locality, :region, :postal_code]}]
-        },
-        {:funding => [:destination, :email, :mobile_phone, :routing_number, :account_number, :descriptor]}
-      ]
-    end
-
-    def self._create_signature
-      _signature + [:tos_accepted, :master_merchant_account_id, :id]
-    end
-
-    def self._update_signature
-      _signature
-    end
   end
 end

data/lib/braintree/meta_checkout_card.rb

@@ -4,10 +4,13 @@ module Braintree
       include Braintree::Util::TokenEquality
 
       attr_reader :bin
-      attr_reader :container_id
+      attr_reader :business
       attr_reader :card_type
       attr_reader :cardholder_name
       attr_reader :commercial
+      attr_reader :consumer
+      attr_reader :container_id
+      attr_reader :corporate
       attr_reader :country_of_issuance
       attr_reader :created_at
       attr_reader :customer_id
@@ -22,7 +25,9 @@ module Braintree
       attr_reader :last_4
       attr_reader :payroll
       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
@@ -74,11 +79,11 @@ module Braintree
 
       def self._attributes # :nodoc:
         [
-          :bin, :card_type, :cardholder_name, :created_at,
-          :customer_id, :customer_location, :expiration_month, :expiration_year,
-          :last_4, :token, :updated_at, :prepaid, :payroll, :product_id,
-          :commercial, :debit, :durbin_regulated, :healthcare,
-          :country_of_issuance, :issuing_bank, :image_url, :container_id
+          :bin, :business, :card_type, :cardholder_name, :commercial,
+          :consumer, :container_id, :corporate, :country_of_issuance, :created_at, :customer_id,
+          :customer_location, :debit, :durbin_regulated, :expiration_month,
+          :expiration_year, :healthcare, :image_url, :issuing_bank, :last_4, :payroll, :prepaid,
+          :prepaid_reloadable, :product_id, :purchase, :token, :updated_at
         ]
       end
 

data/lib/braintree/meta_checkout_token.rb

@@ -4,10 +4,13 @@ module Braintree
       include Braintree::Util::TokenEquality
 
       attr_reader :bin
-      attr_reader :container_id
+      attr_reader :business
       attr_reader :card_type
       attr_reader :cardholder_name
       attr_reader :commercial
+      attr_reader :consumer
+      attr_reader :container_id
+      attr_reader :corporate
       attr_reader :country_of_issuance
       attr_reader :created_at
       attr_reader :cryptogram
@@ -24,7 +27,9 @@ module Braintree
       attr_reader :last_4
       attr_reader :payroll
       attr_reader :prepaid
+      attr_reader :prepaid_reloadable
       attr_reader :product_id
+      attr_reader :purchase
       attr_reader :token
       attr_reader :unique_number_identifier
       attr_reader :updated_at
@@ -73,11 +78,11 @@ module Braintree
 
       def self._attributes # :nodoc:
         [
-          :bin, :card_type, :cardholder_name, :created_at,
-          :customer_id, :customer_location, :expiration_month, :expiration_year,
-          :last_4, :token, :updated_at, :prepaid, :payroll, :product_id,
-          :commercial, :debit, :durbin_regulated, :healthcare, :ecommerce_indicator,
-          :country_of_issuance, :issuing_bank, :image_url, :container_id, :cryptogram
+          :bin, :business, :card_type, :cardholder_name, :commercial, :consumer, :container_id,
+          :corporate, :country_of_issuance, :created_at, :cryptogram, :customer_id, :customer_location,
+          :debit, :durbin_regulated, :ecommerce_indicator, :expiration_month, :expiration_year,
+          :healthcare, :image_url, :issuing_bank, :last_4, :payroll, :prepaid, :prepaid_reloadable,
+          :product_id, :purchase, :token, :updated_at
         ]
       end
 

data/lib/braintree/payment_method_gateway.rb

@@ -160,6 +160,7 @@ module Braintree
       # NEXT_MAJOR_VERSION Remove venmo_sdk_session
       # The old venmo SDK class has been deprecated
       options = [
+        :account_information_inquiry,
         :make_default,
         :skip_advanced_fraud_checking,
         :us_bank_account_verification_method,
@@ -200,16 +201,24 @@ module Braintree
           :ds_transaction_id,
         ]
       }
+      signature << {
+        :us_bank_account => [
+          :ach_mandate_text,
+          :ach_mandate_accepted_at,
+        ]
+      }
 
       case type
       when :create
         options << :fail_on_duplicate_payment_method
         options << :fail_on_duplicate_payment_method_for_customer
+        options << :accountInformationInquiry
         signature << :customer_id
         signature << :paypal_refresh_token
       when :update
         options << :fail_on_duplicate_payment_method
         options << :fail_on_duplicate_payment_method_for_customer
+        options << :accountInformationInquiry
         billing_address_params << {:options => [:update_existing]}
       else
         raise ArgumentError

data/lib/braintree/paypal_payment_resource.rb

@@ -0,0 +1,22 @@
+module Braintree
+    class PayPalPaymentResource
+        include BaseModule
+
+        def self.update(*args)
+            Configuration.gateway.paypal_payment_resource.update(*args)
+        end
+
+        class << self
+            protected :new
+            def _new(*args)
+              self.new(*args)
+            end
+        end
+
+        def initialize(gateway, attributes)
+            @gateway = gateway
+            set_instance_variables_from_hash(attributes)
+        end
+    end
+end
+

data/lib/braintree/paypal_payment_resource_gateway.rb

@@ -0,0 +1,36 @@
+module Braintree
+    class PayPalPaymentResourceGateway
+        include BaseModule
+
+        def initialize(gateway)
+            @gateway = gateway
+            @config = gateway.config
+            @config.assert_has_access_token_or_keys
+        end
+
+        def update(attributes)
+            Util.verify_keys(PayPalPaymentResourceGateway._update_signature, attributes)
+            response = @config.http.put("#{@config.base_merchant_path}/paypal/payment_resource", :paypal_payment_resource => attributes)
+            if response[:payment_method_nonce]
+                SuccessfulResult.new(:payment_method_nonce => PaymentMethodNonce._new(@gateway, response[:payment_method_nonce]))
+            elsif response[:api_error_response]
+                ErrorResult.new(@gateway, response[:api_error_response])
+            else
+                raise UnexpectedError, "expected :paypal_payment_resource or :api_error_response"
+            end
+        end
+
+        def self._update_signature
+            [
+                :amount,
+                {:amount_breakdown => [:discount, :handling, :insurance, :item_total, :shipping, :shipping_discount, :tax_total]},
+                :currency_iso_code, :custom_field, :description,
+                {:line_items => [:description, :image_url, :kind, :name, :product_code, :quantity, :total_amount, :unit_amount, :unit_tax_amount, :url]},
+                :order_id, :payee_email, :payment_method_nonce,
+                {:shipping => [:country_name, :country_code_alpha2, :country_code_alpha3, :country_code_numeric, :extended_address, :first_name, {:international_phone => [:country_code, :national_number]},
+                :last_name, :locality, :postal_code, :region, :street_address]},
+                {:shipping_options => [:amount, :id, :label, :selected, :type]}
+            ]
+        end
+    end
+end

data/lib/braintree/successful_result.rb

@@ -23,7 +23,10 @@ module Braintree
     attr_reader :subscription
     attr_reader :supported_networks
     attr_reader :transaction
+    attr_reader :bank_account_instant_verification_jwt
     attr_reader :us_bank_account_verification
+    attr_reader :session_id
+    attr_reader :customer_recommendations
 
     def initialize(attributes = {})
       @attrs = attributes.keys

data/lib/braintree/test/credit_card.rb

@@ -3,8 +3,13 @@ module Braintree
     module CreditCardNumbers
       module CardTypeIndicators
         Prepaid           = "4111111111111210"
+        PrepaidReloadable = "4229989900000002"
+        Business          = "4229989800000003"
         Commercial        = "4111111111131010"
+        Consumer          = "4229989700000004"
+        Corporate         = "4229989100000000"
         Payroll           = "4111111114101010"
+        Purchase          = "4229989500000006"
         Healthcare        = "4111111510101010"
         DurbinRegulated   = "4111161010101010"
         Debit             = "4117101010101010"

data/lib/braintree/transaction/apple_pay_details.rb

@@ -4,9 +4,12 @@ module Braintree
       include BaseModule
 
       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 :debit
       attr_reader :durbin_regulated
@@ -15,13 +18,17 @@ module Braintree
       attr_reader :global_id
       attr_reader :healthcare
       attr_reader :image_url
+      attr_reader :is_device_token
       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
+      attr_reader :prepaid_reloadable
       attr_reader :product_id
+      attr_reader :purchase
       attr_reader :source_card_last4
       attr_reader :source_description
       attr_reader :token