braintree 4.23.0 → 4.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80f9d00b4dec8e85066f61cecaf04c5863399c8c6552d5158d0fe69f8b81a64f
-  data.tar.gz: 4664e8431f59bf1293d6cafbaf3623b6fe2069aa81af17520384b5e85c34a0a5
+  metadata.gz: 1c3d511f196493254353d03633aedd94e6bc5ac4c0d075ab354a19435ca1e223
+  data.tar.gz: dcfc72a09d796a25d40451abe117dda0ea63a2e53874f45de0ee5546b94fc440
 SHA512:
-  metadata.gz: 73131e462a1c99744d967f82cecdda88dc2780e04c3bb69f51cd7149fc8e747d7e487e31cc5e5e3fe7f4440d6da3ef42a90ee7e027c7fa0f567ad2b84a6119dd
-  data.tar.gz: a17216eb8f219f33af17d79accae60eccc23e059753ac159aed34063ec7f8abb0566c6268097647bb1a657fabf507d4f9d1d90c39e3c73b0e66f9d4c1a29c8bc
+  metadata.gz: aa45eeeda00fb2a9d9999c8c2d41a3f9ef4385190598ade9d89ca2017222e893b31e9e3104ed81aa6f03a96bd4f9b0e1247b5e948d2687885eac5e5a0dbd7967
+  data.tar.gz: d554568c2653f57c5b69ce9bec05655d84f8aa01b96357b3effda416bc1c1c3a8da473db9930669e3c65b7165d1b4fe131ca5578ed4f396fab201d61cbdf376c

data/lib/braintree/address_gateway.rb

@@ -84,6 +84,11 @@ module Braintree
     def self._update_signature
       _create_signature
     end
+
+    def self._address_attributes
+      [:street_address, :extended_address, :locality, :region, :postal_code, :country_code_alpha2,
+       {:international_phone => [:country_code, :national_number]}]
+    end
   end
 end
 

data/lib/braintree/apple_pay_card.rb

@@ -12,9 +12,12 @@ module Braintree
 
     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
@@ -26,13 +29,16 @@ module Braintree
     attr_reader :expired
     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_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 :subscriptions

data/lib/braintree/bank_account_instant_verification_gateway.rb

@@ -0,0 +1,38 @@
+module Braintree
+  class BankAccountInstantVerificationGateway
+
+    CREATE_JWT_MUTATION =
+      "mutation CreateBankAccountInstantVerificationJwt($input: CreateBankAccountInstantVerificationJwtInput!) { " +
+      "  createBankAccountInstantVerificationJwt(input: $input) {" +
+      "    jwt" +
+      "  }" +
+      "}"
+
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+    end
+
+    def create_jwt(request)
+      variables = request.to_graphql_variables
+      response = @gateway.graphql_client.query(CREATE_JWT_MUTATION, variables)
+      errors = Braintree::GraphQLClient.get_validation_errors(response)
+
+      if errors
+        ErrorResult.new(@gateway, {errors: errors})
+      else
+        data = response.dig(:data, :createBankAccountInstantVerificationJwt)
+
+        if data.nil?
+          raise UnexpectedError, "expected :createBankAccountInstantVerificationJwt"
+        end
+
+        jwt_attrs = {
+          :jwt => data[:jwt]
+        }
+
+        SuccessfulResult.new(:bank_account_instant_verification_jwt => BankAccountInstantVerificationJwt._new(jwt_attrs))
+      end
+    end
+  end
+end

data/lib/braintree/bank_account_instant_verification_jwt.rb

@@ -0,0 +1,23 @@
+module Braintree
+  class BankAccountInstantVerificationJwt
+    include BaseModule
+
+    attr_reader :jwt
+
+    def initialize(attributes)
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def self._new(*args)
+      self.new(*args)
+    end
+
+    def inspect
+      attr_order = [:jwt]
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<#{self.class} #{formatted_attrs.join(', ')}>"
+    end
+  end
+end

data/lib/braintree/bank_account_instant_verification_jwt_request.rb

@@ -0,0 +1,21 @@
+module Braintree
+  class BankAccountInstantVerificationJwtRequest
+    include BaseModule
+
+    attr_accessor :business_name, :return_url, :cancel_url
+
+    def initialize(attributes = {})
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def to_graphql_variables
+      variables = {:input => {}}
+
+      variables[:input][:businessName] = business_name if business_name
+      variables[:input][:returnUrl] = return_url if return_url
+      variables[:input][:cancelUrl] = cancel_url if cancel_url
+
+      variables
+    end
+  end
+end

data/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
@@ -10,7 +13,9 @@ module Braintree
     attr_reader :issuing_bank
     attr_reader :payroll
     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?
@@ -25,8 +30,9 @@ module Braintree
 
     def self._attributes
       [
-        :commercial, :country_of_issuance, :debit, :durbin_regulated, :healthcare,
-        :issuing_bank, :payroll, :prepaid, :product_id
+        :business, :commercial, :consumer, :corporate, :country_of_issuance, :debit,
+        :durbin_regulated, :healthcare, :issuing_bank, :payroll, :prepaid,
+        :prepaid_reloadable, :product_id, :purchase
       ]
     end
   end

data/lib/braintree/configuration.rb

@@ -239,7 +239,7 @@ module Braintree
       when :production
         "#{endpoint}.braintreegateway.com"
       when :qa
-        "gateway.qa2.braintreepayments.com"
+        "gateway.qa.braintreepayments.com"
       when :sandbox
         "api.sandbox.braintreegateway.com"
       end

data/lib/braintree/credit_card.rb

@@ -45,14 +45,18 @@ module Braintree
       Unknown = "Unknown"
     end
 
-    Commercial = Debit = DurbinRegulated = Healthcare = Payroll = Prepaid = ProductId =
-      IssuingBank = CountryOfIssuance = 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
@@ -66,7 +70,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
@@ -199,9 +205,10 @@ module Braintree
 
     def self._attributes
       [
-        :billing_address, :bin, :card_type, :cardholder_name, :created_at, :customer_id, :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, :is_network_tokenized?
+        :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
 

data/lib/braintree/credit_card_gateway.rb

@@ -96,6 +96,7 @@ module Braintree
       # 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,

data/lib/braintree/credit_card_verification_gateway.rb

@@ -18,7 +18,8 @@ module Braintree
       search = CreditCardVerificationSearch.new
       block.call(search) if block
 
-      response = @config.http.post("#{@config.base_merchant_path}/verifications/advanced_search_ids", {:search => search.to_hash})
+      search_params = search.to_hash.merge({:verification_type => ["credit_card"]})
+      response = @config.http.post("#{@config.base_merchant_path}/verifications/advanced_search_ids", {:search => search_params})
       ResourceCollection.new(response) { |ids| _fetch_verifications(search, ids) }
     end
 
@@ -39,7 +40,8 @@ module Braintree
 
     def _fetch_verifications(search, ids)
       search.ids.in ids
-      response = @config.http.post("#{@config.base_merchant_path}/verifications/advanced_search", {:search => search.to_hash})
+      search_params = search.to_hash.merge({:verification_type => ["credit_card"]})
+      response = @config.http.post("#{@config.base_merchant_path}/verifications/advanced_search", {:search => search_params})
       attributes = response[:credit_card_verifications]
       Util.extract_attribute_as_array(attributes, :verification).map { |attrs| CreditCardVerification._new(attrs) }
     end
@@ -61,6 +63,7 @@ module Braintree
         ]},
         :intended_transaction_source,
         {:options => [
+          :account_information_inquiry,
           :account_type,
           :amount,
           :merchant_account_id,

data/lib/braintree/customer_session_gateway.rb

@@ -0,0 +1,195 @@
+# Creates and manages PayPal customer sessions.
+
+module Braintree
+    class CustomerSessionGateway
+      CREATE_CUSTOMER_SESSION = <<~GRAPHQL
+        mutation CreateCustomerSession($input: CreateCustomerSessionInput!) {
+          createCustomerSession(input: $input) {
+            sessionId
+          }
+        }
+      GRAPHQL
+
+      UPDATE_CUSTOMER_SESSION = <<~GRAPHQL
+        mutation UpdateCustomerSession($input: UpdateCustomerSessionInput!) {
+          updateCustomerSession(input: $input) {
+            sessionId
+          }
+        }
+      GRAPHQL
+
+      GET_CUSTOMER_RECOMMENDATIONS = <<~GRAPHQL
+        mutation GenerateCustomerRecommendations($input: GenerateCustomerRecommendationsInput!) {
+          generateCustomerRecommendations(input: $input) {
+            sessionId
+            isInPayPalNetwork
+            paymentRecommendations {
+                  paymentOption
+                  recommendedPriority
+            }
+          }
+        }
+      GRAPHQL
+
+      def initialize(gateway, graphql_client)
+        @gateway = gateway
+        @graphql_client = graphql_client
+      end
+
+      # Creates a new customer session.
+      #
+      # Example:
+      #   customer = {
+      #    email: "test@example.com",
+      #    device_fingerprint_id: "1234",
+      #    phone: {country_phone_code: "1", phone_number: "5555555555"},
+      #    paypal_app_installed: true,
+      #    venmo_app_installed: true,
+      #   }
+      #   input = Braintree::CreateCustomerSessionInput.new(
+      #                customer: customer,
+      #   )
+      #   result = gateway.customer_session.create_customer_session(input)
+      #   if result.success?
+      #     puts "Created session #{result.session_id}"
+      #   else
+      #     puts "Validations failed"
+      #     puts result.errors.first.message
+      #   end
+      #
+      # @param input [CreateCustomerSessionInput] The input parameters for creating a customer session.
+      #
+      # @return [(Successful|Error)Result] A result object with session ID if successful, or errors otherwise.
+      #
+      # @raise [UnexpectedError] If there is an unexpected error during the process.
+      def create_customer_session(input)
+        execute_mutation(CREATE_CUSTOMER_SESSION, input, :createCustomerSession)
+      end
+
+
+      # Updates an existing customer session.
+      #
+      # Example:
+      #   customer = {
+      #    email: "test@example.com",
+      #    device_fingerprint_id: "1234",
+      #    phone: {country_phone_code: "1", phone_number: "5555555555"},
+      #    paypal_app_installed: true,
+      #    venmo_app_installed: true,
+      #   }
+      #   input = Braintree::UpdateCustomerSessionInput.new(
+      #                session_id: "11EF-34BC-2702904B-9026-555555555555",
+      #                customer: customer,
+      #   )
+      #   result = gateway.customer_session.updated_customer_session(input)
+      #   if result.success?
+      #     puts "Updated session #{result.session_id}"
+      #   else
+      #     puts "Validations failed"
+      #     puts result.errors.first.message
+      #   end
+      #
+      # @param input [UpdateCustomerSessionInput] The input parameters for updating a customer session.
+      #
+      # @return [(Successful|Error)Result] A result object with session ID if successful, or errors otherwise.
+      #
+      # @raise [UnexpectedError] If there is an unexpected error during the process.
+      def update_customer_session(input)
+        execute_mutation(UPDATE_CUSTOMER_SESSION, input, :updateCustomerSession)
+      end
+
+      # Retrieves customer recommendations associated with a customer session.
+      #
+      # Example:
+      #   customer = {
+      #    email: "test@example.com",
+      #    device_fingerprint_id: "1234",
+      #    phone: {country_phone_code: "1", phone_number: "5555555555"},
+      #    paypal_app_installed: true,
+      #    venmo_app_installed: true,
+      #   }
+      #   input = Braintree::CustomerRecommendationsInput.new(
+      #                session_id: "11EF-34BC-2702904B-9026-555555555555",
+      #                customer: customer,
+      #                recommendations: [Braintree::Recommendations::PAYMENT_RECOMMENDATIONS]
+      #   )
+      #   result = gateway.customer_session.get_customer_recommendations(input)
+      #   if result.success?
+      #     puts "Fetched customer recommendations"
+      #     payload = result.customer_recommendations
+      #     puts payload
+      #   else
+      #     puts "Validations failed"
+      #     puts result.errors.first.message
+      #   end
+      #
+      # @param input [CustomerRecommendationsInput] The input parameters for retrieving customer recommendations.
+      #
+      # @return [Result\Error|Result\Successful] A result object containing the customer recommendations if successful, or errors otherwise.
+      #
+      # @raise [UnexpectedError] If there is an unexpected error during the process.
+      def get_customer_recommendations(customer_recommendations_input)
+        variables = {"input" => customer_recommendations_input.to_graphql_variables}
+
+        begin
+          response = @graphql_client.query(GET_CUSTOMER_RECOMMENDATIONS, variables)
+          errors = GraphQLClient.get_validation_errors(response)
+          if errors
+            ErrorResult.new(@gateway, {errors:errors})
+          else
+            SuccessfulResult.new(:customer_recommendations => extract_customer_recommendations_payload(response))
+          end
+        rescue StandardError => e
+          if e.message.include?("Authorization failed")
+            raise AuthorizationError, e.message
+          else
+            raise ServerError, e.message
+          end
+        end
+      end
+
+      private
+
+      def execute_mutation(query, input, operation_name)
+        variables = {"input" => input.to_graphql_variables}
+        begin
+          response = @graphql_client.query(query, variables)
+          errors = GraphQLClient.get_validation_errors(response)
+          if errors
+            ErrorResult.new(@gateway, {errors:errors})
+          else
+            session_id = get_value(response, "data.#{operation_name}.sessionId")
+            SuccessfulResult.new(:session_id => session_id)
+          end
+        rescue StandardError => e
+          raise UnexpectedError, e.message
+        end
+      end
+
+      def get_value(response, key)
+        map = response
+        key_parts = key.split(".")
+
+        key_parts[0..-2].each do |sub_key|
+          map = pop_value(map, sub_key)
+          raise UnexpectedError, "Couldn't parse response"  unless map.is_a?(Hash)
+        end
+
+        pop_value(map, key_parts.last)
+      end
+
+      def pop_value(map, key)
+        key = key.to_sym
+        if map.key?(key)
+          map[key]
+        else
+          raise UnexpectedError, "Couldn't parse response"
+        end
+      end
+
+      def extract_customer_recommendations_payload(data)
+        customer_recommendations_hash = get_value(data, "data.generateCustomerRecommendations")
+        Braintree::CustomerRecommendationsPayload._new({:response => {"generateCustomerRecommendations" => customer_recommendations_hash}})
+      end
+    end
+  end

data/lib/braintree/dispute.rb

@@ -32,6 +32,7 @@ module Braintree
     attr_reader :reply_by_date
     attr_reader :status
     attr_reader :status_history
+    attr_reader :remaining_file_evidence_storage
     attr_reader :transaction
     attr_reader :transaction_details
     attr_reader :updated_at