braintree 2.10.0 → 4.26.0

data/lib/braintree/error_result.rb

@@ -1,20 +1,28 @@
 module Braintree
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/result_objects
   class ErrorResult
 
-    attr_reader :credit_card_verification, :transaction, :subscription, :errors, :params, :message
+    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:
+    def initialize(gateway, data)
       @gateway = gateway
-      @params = data[:params]
+      @params = data[:params] if data[:params]
       @credit_card_verification = CreditCardVerification._new(data[:verification]) if data[:verification]
+      @merchant_account = MerchantAccount._new(gateway, data[:merchant_account]) if data[:merchant_account]
       @message = data[:message]
       @transaction = Transaction._new(gateway, data[:transaction]) if data[:transaction]
+      @verification = CreditCardVerification._new(data[:verification]) if data[:verification]
       @subscription = Subscription._new(gateway, data[:subscription]) if data[:subscription]
       @errors = Errors.new(data[:errors])
     end
 
-    def inspect # :nodoc:
+    def inspect
       if @credit_card_verification
         verification_inspect = " credit_card_verification: #{@credit_card_verification.inspect}"
       end
@@ -24,7 +32,6 @@ module Braintree
       "#<#{self.class} params:{...} errors:<#{@errors._inner_inspect}>#{verification_inspect}#{transaction_inspect}>"
     end
 
-    # Always returns false.
     def success?
       false
     end

data/lib/braintree/errors.rb

@@ -1,10 +1,10 @@
 module Braintree
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/validation_errors
   class Errors
     include Enumerable
 
-    def initialize(data = {}) # :nodoc:
-      @errors = ValidationErrorCollection.new(data.merge(:errors => []))
+    def initialize(data = {})
+      data = data.merge(:errors => []) unless data
+      @errors = ValidationErrorCollection.new(data)
     end
 
     def each(&block)
@@ -15,7 +15,7 @@ module Braintree
       @errors.for(scope)
     end
 
-    def inspect # :nodoc:
+    def inspect
       "#<#{self.class} #{_inner_inspect}>"
     end
 
@@ -26,7 +26,7 @@ module Braintree
       @errors.deep_size
     end
 
-    def _inner_inspect # :nodoc:
+    def _inner_inspect
       @errors._inner_inspect
     end
   end

data/lib/braintree/exceptions.rb

@@ -1,42 +1,34 @@
-module Braintree # :nodoc:
-  # Super class for all Braintree exceptions.
+module Braintree
   class BraintreeError < ::StandardError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
   class AuthenticationError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
   class AuthorizationError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
-  class ConfigurationError < BraintreeError
-    def initialize(setting, message) # :nodoc:
-      super "Braintree::Configuration.#{setting} #{message}"
-    end
-  end
+  class ConfigurationError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
-  class DownForMaintenanceError < BraintreeError; end
+  class GatewayTimeoutError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
-  class ForgedQueryString < BraintreeError; end
+  class InvalidSignature < BraintreeError; end
+
+  class InvalidChallenge < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
   class NotFoundError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
+  class RequestTimeoutError < BraintreeError; end
+
   class ServerError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
+  class ServiceUnavailableError < BraintreeError; end
+
   class SSLCertificateError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
+  class TooManyRequestsError < BraintreeError; end
+
   class UnexpectedError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
   class UpgradeRequiredError < BraintreeError; end
 
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/exceptions
   class ValidationsFailed < BraintreeError
     attr_reader :error_result
 
@@ -52,5 +44,7 @@ module Braintree # :nodoc:
       inspect
     end
   end
+
+  class TestOperationPerformedInProduction < BraintreeError; end
 end
 

data/lib/braintree/exchange_rate.rb

@@ -0,0 +1,13 @@
+module Braintree
+  class ExchangeRate
+    include BaseModule
+
+    def initialize(gateway, attributes)
+      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
+
+    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)
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def inspect
+      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
+    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
+
+    attr_reader :attrs
+    attr_reader :base_currency
+    attr_reader :base_amount
+    attr_reader :markup
+    attr_reader :quote_currency
+
+    def initialize(attributes)
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def inspect
+      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
+
+    attr_reader :quotes
+
+    def initialize(attributes)
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+      @quotes = (@quotes || []).map { |quote_hash| ExchangeRateQuoteInput.new(quote_hash) }
+    end
+
+    def inspect
+      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
+
+    attr_reader :quotes
+
+    def initialize(attributes)
+      @attrs = attributes.keys
+      set_instance_variables_from_hash(attributes)
+      @quotes = (@quotes || []).map { |quote_hash| ExchangeRateQuote.new(quote_hash) }
+    end
+
+    def inspect
+      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
+    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

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

data/lib/braintree/gateway.rb

@@ -1,6 +1,6 @@
 module Braintree
-  class Gateway # :nodoc:
-    attr_reader :config
+  class Gateway
+    attr_reader :config, :graphql_client
 
     def initialize(config)
       if config.is_a?(Hash)
@@ -10,12 +10,26 @@ module Braintree
       else
         raise ArgumentError, "config is an invalid type"
       end
+
+      @graphql_client = GraphQLClient.new(@config)
+    end
+
+    def add_on
+      AddOnGateway.new(self)
     end
 
     def address
       AddressGateway.new(self)
     end
 
+    def apple_pay
+      ApplePayGateway.new(self)
+    end
+
+    def client_token
+      ClientTokenGateway.new(self)
+    end
+
     def credit_card
       CreditCardGateway.new(self)
     end
@@ -24,16 +38,100 @@ module Braintree
       CustomerGateway.new(self)
     end
 
-    def subscription
-      SubscriptionGateway.new(self)
+    def customer_session
+      CustomerSessionGateway.new(self, graphql_client)
+    end
+
+    def discount
+      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
+
+    def plan
+      PlanGateway.new(self)
+    end
+
+    def payment_method
+      PaymentMethodGateway.new(self)
+    end
+
+    def payment_method_nonce
+      PaymentMethodNonceGateway.new(self)
+    end
+
+    def paypal_account
+      PayPalAccountGateway.new(self)
     end
 
-    def transparent_redirect
-      TransparentRedirectGateway.new(self)
+    def paypal_payment_resource
+      PayPalPaymentResourceGateway.new(self)
+    end
+
+    def us_bank_account
+      UsBankAccountGateway.new(self)
+    end
+
+    def sepa_direct_debit_account
+      SepaDirectDebitAccountGateway.new(self)
+    end
+
+    def merchant
+      MerchantGateway.new(self)
+    end
+
+    def merchant_account
+      MerchantAccountGateway.new(self)
+    end
+
+    def settlement_batch_summary
+      SettlementBatchSummaryGateway.new(self)
+    end
+
+    def subscription
+      SubscriptionGateway.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
+
+    def webhook_notification
+      WebhookNotificationGateway.new(self)
+    end
+
+    def webhook_testing
+      WebhookTestingGateway.new(self)
+    end
   end
 end

data/lib/braintree/google_pay_card.rb

@@ -0,0 +1,62 @@
+module Braintree
+  class GooglePayCard
+    include BaseModule
+
+    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 :prepaid_reloadable
+    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)
+      @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)
+      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)
+        self.new(*args)
+      end
+    end
+  end
+end

data/lib/braintree/graphql/enums/recommendations.rb

@@ -0,0 +1,7 @@
+# Represents available types of customer recommendations that can be retrieved using a PayPal customer session.
+
+module Braintree
+  module Recommendations
+    PAYMENT_RECOMMENDATIONS = "PAYMENT_RECOMMENDATIONS"
+  end
+end

data/lib/braintree/graphql/enums/recommended_payment_option.rb

@@ -0,0 +1,8 @@
+# Represents available payment options related to PayPal customer session recommendations.
+
+module Braintree
+  module RecommendedPaymentOption
+    PAYPAL = "PAYPAL"
+    VENMO = "VENMO"
+  end
+end

data/lib/braintree/graphql/inputs/create_customer_session_input.rb

@@ -0,0 +1,35 @@
+# Represents the input to request the creation of a PayPal customer session.
+
+module Braintree
+    class CreateCustomerSessionInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :merchant_account_id
+        attr_reader :session_id
+        attr_reader :customer
+        attr_reader :domain
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+            @customer = attributes[:customer] ? CustomerSessionInput.new(attributes[:customer]) : nil
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["merchantAccountId"] = merchant_account_id if merchant_account_id
+            variables["sessionId"] = session_id if session_id
+            variables["domain"] = domain if domain
+            variables["customer"] = customer.to_graphql_variables if customer
+            variables
+        end
+    end
+end
+
+

data/lib/braintree/graphql/inputs/customer_recommendations_input.rb

@@ -0,0 +1,41 @@
+# Represents the input to request PayPal customer session recommendations.
+
+module Braintree
+    class CustomerRecommendationsInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :merchant_account_id
+        attr_reader :session_id
+        attr_reader :recommendations
+        attr_reader :customer
+
+        def initialize(attributes)
+            unless attributes[:session_id]
+                raise ArgumentError, "Expected hash to contain a :session_id"
+            end
+            unless attributes[:recommendations]
+                raise ArgumentError, "Expected hash to contain a :recommendations"
+            end
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+            @customer = attributes[:customer] ? CustomerSessionInput.new(attributes[:customer]) : nil
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["merchantAccountId"] = merchant_account_id if merchant_account_id
+            variables["sessionId"] = session_id if session_id
+            variables["recommendations"] = recommendations if recommendations
+            variables["customer"] = customer.to_graphql_variables if customer
+            variables
+        end
+    end
+end
+
+

data/lib/braintree/graphql/inputs/customer_session_input.rb

@@ -0,0 +1,39 @@
+# Customer identifying information for a PayPal customer session.
+
+module Braintree
+    class CustomerSessionInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :email
+        attr_reader :phone
+        attr_reader :device_fingerprint_id
+        attr_reader :paypal_app_installed
+        attr_reader :venmo_app_installed
+        attr_reader :user_agent
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+            @phone = attributes[:phone] ? PhoneInput.new(attributes[:phone]) : nil
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["email"] = email if email
+            variables["phone"] = phone.to_graphql_variables if phone
+            variables["deviceFingerprintId"] = device_fingerprint_id if device_fingerprint_id
+            variables["paypalAppInstalled"] = paypal_app_installed if paypal_app_installed
+            variables["venmoAppInstalled"] = venmo_app_installed if venmo_app_installed
+            variables["userAgent"] = user_agent if user_agent
+            variables
+        end
+    end
+end
+
+