braintree 2.74.0 → 4.12.0

data/lib/braintree/error_result.rb

@@ -1,7 +1,14 @@
 module Braintree
   class ErrorResult
 
-    attr_reader :credit_card_verification, :merchant_account, :transaction, :subscription, :errors, :params, :message, :verification
+    attr_reader :credit_card_verification
+    attr_reader :errors
+    attr_reader :merchant_account
+    attr_reader :message
+    attr_reader :params
+    attr_reader :subscription
+    attr_reader :transaction
+    attr_reader :verification
 
     def initialize(gateway, data) # :nodoc:
       @gateway = gateway

data/lib/braintree/exceptions.rb

@@ -8,9 +8,7 @@ module Braintree # :nodoc:
 
   class ConfigurationError < BraintreeError; end
 
-  class DownForMaintenanceError < BraintreeError; end
-
-  class ForgedQueryString < BraintreeError; end
+  class GatewayTimeoutError < BraintreeError; end
 
   class InvalidSignature < BraintreeError; end
 
@@ -18,8 +16,12 @@ module Braintree # :nodoc:
 
   class NotFoundError < BraintreeError; end
 
+  class RequestTimeoutError < BraintreeError; end
+
   class ServerError < BraintreeError; end
 
+  class ServiceUnavailableError < BraintreeError; end
+
   class SSLCertificateError < BraintreeError; end
 
   class TooManyRequestsError < BraintreeError; end

data/lib/braintree/exchange_rate.rb

@@ -0,0 +1,13 @@
+module Braintree
+  class ExchangeRate
+    include BaseModule # :nodoc:
+
+    def initialize(gateway, attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def self.generate(exchange_rate_quote_request)
+      Configuration.gateway.exchange_rate_quote.generate(exchange_rate_quote_request)
+    end
+  end
+end

data/lib/braintree/exchange_rate_quote.rb

@@ -0,0 +1,24 @@
+module Braintree
+  class ExchangeRateQuote
+    include BaseModule # :nodoc:
+
+    attr_reader :attrs
+    attr_reader :base_amount
+    attr_reader :exchange_rate
+    attr_reader :expires_at
+    attr_reader :id
+    attr_reader :quote_amount
+    attr_reader :refreshes_at
+    attr_reader :trade_rate
+
+    def initialize(attributes) # :nodoc:
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def inspect # :nodoc:
+      inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+      "#<#{self.class} #{inspected_attributes.join(" ")}>"
+    end
+  end
+end

data/lib/braintree/exchange_rate_quote_gateway.rb

@@ -0,0 +1,35 @@
+module Braintree
+  class ExchangeRateQuoteGateway # :nodoc
+    def initialize(gateway)
+      @gateway = gateway
+    end
+
+    DEFINITION = <<-GRAPHQL
+      mutation GenerateExchangeRateQuoteInput($input: GenerateExchangeRateQuoteInput!) {
+        generateExchangeRateQuote(input: $input) {
+          quotes {
+            id
+            baseAmount {value, currencyCode}
+            quoteAmount {value, currencyCode}
+            exchangeRate
+            tradeRate
+            expiresAt
+            refreshesAt
+          }
+        }
+      }
+    GRAPHQL
+
+    def generate(params)
+      response = @gateway.config.graphql_client.query(DEFINITION, {input: params})
+
+      if response.has_key?(:data) && response[:data][:generateExchangeRateQuote]
+        response[:data][:generateExchangeRateQuote]
+      elsif response[:errors]
+        ErrorResult.new(@gateway, response[:errors])
+      else
+        raise UnexpectedError, "expected :generateExchangeRateQuote or :api_error_response in GraphQL response"
+      end
+    end
+  end
+end

data/lib/braintree/exchange_rate_quote_input.rb

@@ -0,0 +1,21 @@
+module Braintree
+  class ExchangeRateQuoteInput
+    include BaseModule # :nodoc:
+
+    attr_reader :attrs
+    attr_reader :base_currency
+    attr_reader :base_amount
+    attr_reader :markup
+    attr_reader :quote_currency
+
+    def initialize(attributes) # :nodoc:
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def inspect # :nodoc:
+      inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+      "#<#{self.class} #{inspected_attributes.join(" ")}>"
+    end
+  end
+end

data/lib/braintree/exchange_rate_quote_request.rb

@@ -0,0 +1,18 @@
+module Braintree
+  class ExchangeRateQuoteRequest
+    include BaseModule # :nodoc:
+
+    attr_reader :quotes
+
+    def initialize(attributes) # :nodoc:
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+      @quotes = (@quotes || []).map { |quote_hash| ExchangeRateQuoteInput.new(quote_hash) }
+    end
+
+    def inspect # :nodoc:
+      inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+      "#<#{self.class} #{inspected_attributes.join(" ")}>"
+    end
+  end
+end

data/lib/braintree/exchange_rate_quote_response.rb

@@ -0,0 +1,18 @@
+module Braintree
+  class ExchangeRateQuoteResponse
+    include BaseModule # :nodoc:
+
+    attr_reader :quotes
+
+    def initialize(attributes) # :nodoc:
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+      @quotes = (@quotes || []).map { |quote_hash| ExchangeRateQuote.new(quote_hash) }
+    end
+
+    def inspect # :nodoc:
+      inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+      "#<#{self.class} #{inspected_attributes.join(" ")}>"
+    end
+  end
+end

data/lib/braintree/facilitated_details.rb

@@ -0,0 +1,21 @@
+module Braintree
+  class FacilitatedDetails # :nodoc:
+    include BaseModule
+
+    attr_reader :merchant_id
+    attr_reader :merchant_name
+    attr_reader :payment_method_nonce
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+    end
+
+    def inspect
+      attr_order = [:merchant_id, :merchant_name, :payment_method_nonce]
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<FacilitatorDetails #{formatted_attrs.join(", ")}>"
+    end
+  end
+end

data/lib/braintree/facilitator_details.rb

@@ -2,7 +2,8 @@ module Braintree
   class FacilitatorDetails # :nodoc:
     include BaseModule
 
-    attr_reader :oauth_application_client_id, :oauth_application_name
+    attr_reader :oauth_application_client_id
+    attr_reader :oauth_application_name
 
     def initialize(attributes)
       set_instance_variables_from_hash attributes unless attributes.nil?

data/lib/braintree/gateway.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Gateway
-    attr_reader :config
+    attr_reader :config, :graphql_client
 
     def initialize(config)
       if config.is_a?(Hash)
@@ -10,6 +10,8 @@ module Braintree
       else
         raise ArgumentError, "config is an invalid type"
       end
+
+      @graphql_client = GraphQLClient.new(@config)
     end
 
     def add_on
@@ -20,6 +22,10 @@ module Braintree
       AddressGateway.new(self)
     end
 
+    def apple_pay
+      ApplePayGateway.new(self)
+    end
+
     def client_token
       ClientTokenGateway.new(self)
     end
@@ -36,6 +42,18 @@ module Braintree
       DiscountGateway.new(self)
     end
 
+    def dispute
+      DisputeGateway.new(self)
+    end
+
+    def document_upload
+      DocumentUploadGateway.new(self)
+    end
+
+    def exchange_rate_quote
+      ExchangeRateQuoteGateway.new(self)
+    end
+
     def oauth
       OAuthGateway.new(self)
     end
@@ -60,8 +78,8 @@ module Braintree
       UsBankAccountGateway.new(self)
     end
 
-    def ideal_payment
-      IdealPaymentGateway.new(self)
+    def sepa_direct_debit_account
+      SepaDirectDebitAccountGateway.new(self)
     end
 
     def merchant
@@ -72,10 +90,6 @@ module Braintree
       MerchantAccountGateway.new(self)
     end
 
-    def europe_bank_account
-      EuropeBankAccountGateway.new(self)
-    end
-
     def settlement_batch_summary
       SettlementBatchSummaryGateway.new(self)
     end
@@ -84,18 +98,22 @@ module Braintree
       SubscriptionGateway.new(self)
     end
 
-    def transparent_redirect
-      TransparentRedirectGateway.new(self)
-    end
-
     def transaction
       TransactionGateway.new(self)
     end
 
+    def transaction_line_item
+      TransactionLineItemGateway.new(self)
+    end
+
     def testing
       TestingGateway.new(self)
     end
 
+    def us_bank_account_verification
+      UsBankAccountVerificationGateway.new(self)
+    end
+
     def verification
       CreditCardVerificationGateway.new(self)
     end

data/lib/braintree/google_pay_card.rb

@@ -0,0 +1,61 @@
+module Braintree
+  class GooglePayCard
+    include BaseModule # :nodoc:
+
+    attr_reader :bin
+    attr_reader :commercial
+    attr_reader :country_of_issuance
+    attr_reader :created_at
+    attr_reader :customer_id
+    attr_reader :debit
+    attr_reader :default
+    attr_reader :durbin_regulated
+    attr_reader :expiration_month
+    attr_reader :expiration_year
+    attr_reader :google_transaction_id
+    attr_reader :healthcare
+    attr_reader :image_url
+    attr_reader :issuing_bank
+    attr_reader :payroll
+    attr_reader :prepaid
+    attr_reader :product_id
+    attr_reader :source_card_last_4
+    attr_reader :source_card_type
+    attr_reader :source_description
+    attr_reader :subscriptions
+    attr_reader :token
+    attr_reader :updated_at
+    attr_reader :virtual_card_last_4
+    attr_reader :virtual_card_type
+
+    def initialize(gateway, attributes) # :nodoc:
+      @gateway = gateway
+      set_instance_variables_from_hash(attributes)
+      @subscriptions = (@subscriptions || []).map { |subscription_hash| Subscription._new(@gateway, subscription_hash) }
+    end
+
+    def default?
+      @default
+    end
+
+    def is_network_tokenized?
+      @is_network_tokenized
+    end
+
+    def card_type
+      virtual_card_type
+    end
+
+    def last_4
+      virtual_card_last_4
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/granted_payment_instrument_update.rb

@@ -0,0 +1,23 @@
+module Braintree
+  class GrantedPaymentInstrumentUpdate
+    include BaseModule
+
+    attr_reader :grant_owner_merchant_id
+    attr_reader :grant_recipient_merchant_id
+    attr_reader :payment_method_nonce
+    attr_reader :token
+    attr_reader :updated_fields
+
+    def initialize(attributes)
+      set_instance_variables_from_hash(attributes)
+      @payment_method_nonce = attributes[:payment_method_nonce][:nonce]
+    end
+
+    class << self
+      protected :new
+      def _new(*args) # :nodoc:
+        self.new(*args)
+      end
+    end
+  end
+end

data/lib/braintree/graphql_client.rb

@@ -0,0 +1,34 @@
+module Braintree
+  class GraphQLClient < Http # :nodoc:
+
+    def initialize(config)
+      @config = config
+      @graphql_headers = {
+        "Accept" => "application/json",
+        "Braintree-Version" => @config.graphql_api_version,
+        "Content-Type" => "application/json"
+      }
+    end
+
+    def query(definition, variables = {}, operationName = nil)
+      graphql_connection = _setup_connection(@config.graphql_server, @config.graphql_port)
+
+      request = {}
+      request["query"] = definition
+      request["operationName"] = operationName if operationName
+      request["variables"] = variables
+
+      response = _http_do Net::HTTP::Post, @config.graphql_base_url, request.to_json, nil, graphql_connection, @graphql_headers
+      data = _parse_response(response)
+      Util.raise_exception_for_graphql_error(data)
+
+      data
+    end
+
+    def _parse_response(response)
+      body = response.body
+      body = Zlib::GzipReader.new(StringIO.new(body)).read if response.header["Content-Encoding"] == "gzip"
+      JSON.parse(body, :symbolize_names => true)
+    end
+  end
+end

data/lib/braintree/http.rb

@@ -1,20 +1,25 @@
 module Braintree
   class Http # :nodoc:
 
+    LINE_FEED = "\r\n"
+
     def initialize(config)
       @config = config
     end
 
-    def delete(path)
+    def delete(_path, query_params = {})
+      path = _path + _build_query_string(query_params)
       response = _http_do Net::HTTP::Delete, path
-      if response.code.to_i == 200
+      if response.code.to_i == 200 || response.code.to_i == 204
         true
+      elsif response.code.to_i == 422
+        Xml.hash_from_xml(_body(response))
       else
         Util.raise_exception_for_status_code(response.code)
       end
     end
 
-    def get(_path, query_params={})
+    def get(_path, query_params = {})
       path = _path + _build_query_string(query_params)
       response = _http_do Net::HTTP::Get, path
       if response.code.to_i == 200 || response.code.to_i == 422
@@ -24,8 +29,12 @@ module Braintree
       end
     end
 
-    def post(path, params = nil)
-      response = _http_do Net::HTTP::Post, path, _build_xml(params)
+    def post(path, params = nil, file = nil)
+      body = params
+      if !file
+        body = _build_xml(params)
+      end
+      response = _http_do Net::HTTP::Post, path, body, file
       if response.code.to_i == 200 || response.code.to_i == 201 || response.code.to_i == 422
         Xml.hash_from_xml(_body(response))
       else
@@ -58,19 +67,34 @@ module Braintree
       end
     end
 
-    def _http_do(http_verb, path, body = nil)
+    def _setup_connection(server = @config.server, port = @config.port)
       if @config.proxy_address
         connection = Net::HTTP.new(
-          @config.server,
-          @config.port,
+          server,
+          port,
           @config.proxy_address,
           @config.proxy_port,
           @config.proxy_user,
-          @config.proxy_pass
+          @config.proxy_pass,
         )
       else
-        connection = Net::HTTP.new(@config.server, @config.port)
+        connection = Net::HTTP.new(server, port)
       end
+    end
+
+    def _compose_headers(header_overrides = {})
+      headers = {}
+      headers["Accept"] = "application/xml"
+      headers["User-Agent"] = @config.user_agent
+      headers["Accept-Encoding"] = "gzip"
+      headers["X-ApiVersion"] = @config.api_version
+      headers["Content-Type"] = "application/xml"
+
+      headers.merge(header_overrides)
+    end
+
+    def _http_do(http_verb, path, body = nil, file = nil, connection = nil, header_overrides = {})
+      connection ||= _setup_connection
 
       connection.open_timeout = @config.http_open_timeout
       connection.read_timeout = @config.http_read_timeout
@@ -81,12 +105,10 @@ module Braintree
         connection.ca_file = @config.ca_file
         connection.verify_callback = proc { |preverify_ok, ssl_context| _verify_ssl_certificate(preverify_ok, ssl_context) }
       end
+
       connection.start do |http|
         request = http_verb.new(path)
-        request["Accept"] = "application/xml"
-        request["User-Agent"] = @config.user_agent
-        request["Accept-Encoding"] = "gzip"
-        request["X-ApiVersion"] = @config.api_version
+        _compose_headers(header_overrides).each { |header, value| request[header] = value }
         if @config.client_credentials?
           request.basic_auth @config.client_id, @config.client_secret
         elsif @config.access_token
@@ -96,9 +118,21 @@ module Braintree
         end
         @config.logger.debug "[Braintree] [#{_current_time}] #{request.method} #{path}"
         if body
-          request["Content-Type"] = "application/xml"
-          request.body = body
-          @config.logger.debug _format_and_sanitize_body_for_log(body)
+          if file
+            boundary = DateTime.now.strftime("%Q")
+            request["Content-Type"] = "multipart/form-data; boundary=#{boundary}"
+
+            form_params = []
+            body.each do |k, v|
+              form_params.push(_add_form_field(k, v))
+            end
+            form_params.push(_add_file_part("file", file))
+            request.body = form_params.collect { |p| "--" + boundary + "#{LINE_FEED}" + p }.join("") + "--" + boundary + "--"
+            @config.logger.debug _format_and_sanitize_body_for_log(_build_xml(body))
+          else
+            request.body = body
+            @config.logger.debug _format_and_sanitize_body_for_log(body)
+          end
         end
         response = http.request(request)
         @config.logger.info "[Braintree] [#{_current_time}] #{request.method} #{path} #{response.code}"
@@ -112,9 +146,35 @@ module Braintree
       raise Braintree::SSLCertificateError
     end
 
+    def _add_form_field(key, value)
+      return "Content-Disposition: form-data; name=\"#{key}\"#{LINE_FEED}#{LINE_FEED}#{value}#{LINE_FEED}"
+    end
+
+    def _add_file_part(key, file)
+      mime_type = _mime_type_for_file_name(file.path)
+      return "Content-Disposition: form-data; name=\"#{key}\"; filename=\"#{file.path}\"#{LINE_FEED}" +
+          "Content-Type: #{mime_type}#{LINE_FEED}#{LINE_FEED}#{file.read}#{LINE_FEED}"
+    end
+
+    def _mime_type_for_file_name(filename)
+      file_extension = File.extname(filename).strip.downcase[1..-1]
+      if file_extension == "jpeg" || file_extension == "jpg"
+        return "image/jpeg"
+      elsif file_extension == "png"
+        return "image/png"
+      elsif file_extension == "pdf"
+        return "application/pdf"
+      else
+        return "application/octet-stream"
+      end
+    end
+
     def _body(response)
-      if response.header["Content-Encoding"] == "gzip"
+      content_encoding = response.header["Content-Encoding"]
+      if content_encoding == "gzip"
         Zlib::GzipReader.new(StringIO.new(response.body)).read
+      elsif content_encoding.nil?
+        ""
       else
         raise UnexpectedError, "expected a gzipped response"
       end
@@ -126,8 +186,9 @@ module Braintree
 
     def _format_and_sanitize_body_for_log(input_xml)
       formatted_xml = input_xml.gsub(/^/, "[Braintree] ")
-      formatted_xml = formatted_xml.gsub(/<number>(.{6}).+?(.{4})<\/number>/, '<number>\1******\2</number>')
-      formatted_xml = formatted_xml.gsub(/<cvv>.+?<\/cvv>/, '<cvv>***</cvv>')
+      formatted_xml = formatted_xml.gsub(/<number>(.{6}).+?(.{4})<\/number>/m, '<number>\1******\2</number>')
+      formatted_xml = formatted_xml.gsub(/<cvv>.+?<\/cvv>/m, "<cvv>***</cvv>")
+      formatted_xml = formatted_xml.gsub(/<encrypted-card-data>.+?<\/encrypted-card-data>/m, "<encrypted-card-data>***</encrypted-card-data>")
       formatted_xml
     end
 

data/lib/braintree/local_payment_completed.rb

@@ -0,0 +1,23 @@
+module Braintree
+  class LocalPaymentCompleted
+    include BaseModule
+
+    attr_reader :payment_id
+    attr_reader :payer_id
+    attr_reader :payment_method_nonce
+    attr_reader :transaction
+
+    def initialize(attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+      @transaction = Transaction._new(Configuration.gateway, transaction) unless transaction.nil?
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/local_payment_expired.rb

@@ -0,0 +1,21 @@
+module Braintree
+  class LocalPaymentExpired
+    include BaseModule
+
+    attr_reader :payment_id
+    attr_reader :payment_context_id
+
+    def initialize(attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new(*args)
+    end
+  end
+end
+

data/lib/braintree/local_payment_funded.rb

@@ -0,0 +1,22 @@
+module Braintree
+  class LocalPaymentFunded
+    include BaseModule
+
+    attr_reader :payment_id
+    attr_reader :payment_context_id
+    attr_reader :transaction
+
+    def initialize(attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+      @transaction = Transaction._new(Configuration.gateway, transaction)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/local_payment_reversed.rb

@@ -0,0 +1,19 @@
+module Braintree
+  class LocalPaymentReversed
+    include BaseModule
+
+    attr_reader :payment_id
+
+    def initialize(attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new(*args)
+    end
+  end
+end