braintree 4.14.0 → 4.18.0

data/lib/braintree/graphql_client.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class GraphQLClient < Http # :nodoc:
+  class GraphQLClient < Http
 
     def initialize(config)
       @config = config

data/lib/braintree/http.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class Http # :nodoc:
+  class Http
 
     LINE_FEED = "\r\n"
 
@@ -7,8 +7,8 @@ module Braintree
       @config = config
     end
 
-    def delete(_path, query_params = {})
-      path = _path + _build_query_string(query_params)
+    def delete(path, query_params = {})
+      full_path = path + _build_query_string(query_params)
       response = _http_do Net::HTTP::Delete, path
       if response.code.to_i == 200 || response.code.to_i == 204
         true
@@ -19,8 +19,8 @@ module Braintree
       end
     end
 
-    def get(_path, query_params = {})
-      path = _path + _build_query_string(query_params)
+    def get(path, query_params = {})
+      full_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
         Xml.hash_from_xml(_body(response))

data/lib/braintree/local_payment_completed.rb

@@ -7,7 +7,7 @@ module Braintree
     attr_reader :payment_method_nonce
     attr_reader :transaction
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
       @transaction = Transaction._new(Configuration.gateway, transaction) unless transaction.nil?
     end
@@ -16,7 +16,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
   end

data/lib/braintree/local_payment_expired.rb

@@ -5,7 +5,7 @@ module Braintree
     attr_reader :payment_id
     attr_reader :payment_context_id
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
     end
 
@@ -13,7 +13,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
   end

data/lib/braintree/local_payment_funded.rb

@@ -6,7 +6,7 @@ module Braintree
     attr_reader :payment_context_id
     attr_reader :transaction
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
       @transaction = Transaction._new(Configuration.gateway, transaction)
     end
@@ -15,7 +15,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
   end

data/lib/braintree/local_payment_reversed.rb

@@ -4,7 +4,7 @@ module Braintree
 
     attr_reader :payment_id
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
     end
 
@@ -12,7 +12,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
   end

data/lib/braintree/merchant.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Merchant
-    include BaseModule # :nodoc:
+    include BaseModule
 
     attr_reader :company_name
     attr_reader :country_code_alpha2
@@ -11,7 +11,7 @@ module Braintree
     attr_reader :id
     attr_reader :merchant_accounts
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @merchant_accounts = attributes.delete(:merchant_accounts).map do |merchant_account|
         MerchantAccount._new(gateway, merchant_account)
       end
@@ -23,7 +23,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
 

data/lib/braintree/merchant_account.rb

@@ -49,7 +49,7 @@ module Braintree
       Configuration.gateway.merchant_account.update!(*args)
     end
 
-    def initialize(gateway, attributes) # :nodoc
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       @individual_details = IndividualDetails.new(@individual)
@@ -60,7 +60,7 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
+      def _new(*args)
         self.new(*args)
       end
     end

data/lib/braintree/merchant_account_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class MerchantAccountGateway # :nodoc:
+  class MerchantAccountGateway
     include BaseModule
 
     def initialize(gateway)
@@ -51,7 +51,7 @@ module Braintree
       _create_for_currency(params)
     end
 
-    def _do_create(path, params=nil) # :nodoc:
+    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])
@@ -60,7 +60,7 @@ module Braintree
       end
     end
 
-    def _do_update(path, params=nil) # :nodoc:
+    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])
@@ -83,7 +83,7 @@ module Braintree
       end
     end
 
-    # this is part of Marketplace and shouldn't be removed unless we're removing all Marketplace code
+    # 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."
@@ -93,8 +93,8 @@ module Braintree
       end
     end
 
-    # this is part of Marketplace and shouldn't be removed unless we're removing all Marketplace code
-    def self._deprecated_create_signature # :nodoc:
+    # 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,
@@ -105,7 +105,7 @@ module Braintree
       ]
     end
 
-    def self._signature # :nodoc:
+    def self._signature
       [
         {:individual => [
           :first_name, :last_name, :email, :date_of_birth, :ssn, :phone,
@@ -119,11 +119,11 @@ module Braintree
       ]
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       _signature + [:tos_accepted, :master_merchant_account_id, :id]
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       _signature
     end
   end

data/lib/braintree/meta_checkout_card.rb

@@ -0,0 +1,89 @@
+module Braintree
+    class MetaCheckoutCard
+      include BaseModule # :nodoc:
+      include Braintree::Util::TokenEquality
+
+      attr_reader :bin
+      attr_reader :container_id
+      attr_reader :card_type
+      attr_reader :cardholder_name
+      attr_reader :commercial
+      attr_reader :country_of_issuance
+      attr_reader :created_at
+      attr_reader :customer_id
+      attr_reader :customer_location
+      attr_reader :debit
+      attr_reader :durbin_regulated
+      attr_reader :expiration_month
+      attr_reader :expiration_year
+      attr_reader :healthcare
+      attr_reader :image_url
+      attr_reader :issuing_bank
+      attr_reader :last_4
+      attr_reader :payroll
+      attr_reader :prepaid
+      attr_reader :product_id
+      attr_reader :subscriptions
+      attr_reader :token
+      attr_reader :unique_number_identifier
+      attr_reader :updated_at
+      attr_reader :verification
+
+
+      def initialize(gateway, attributes) # :nodoc:
+        @gateway = gateway
+        set_instance_variables_from_hash(attributes)
+        @subscriptions = (@subscriptions || []).map { |subscription_hash| Subscription._new(@gateway, subscription_hash) }
+        @verification = _most_recent_verification(attributes)
+      end
+
+      def _most_recent_verification(attributes)
+        verification = (attributes[:verifications] || []).sort_by { |v| v[:created_at] }.reverse.first
+        CreditCardVerification._new(verification) if verification
+      end
+
+      def default?
+        @default
+      end
+
+      # Expiration date formatted as MM/YYYY
+      def expiration_date
+        "#{expiration_month}/#{expiration_year}"
+      end
+
+      def expired?
+        @expired
+      end
+
+      def inspect # :nodoc:
+        first = [:token]
+        order = first + (self.class._attributes - first)
+        nice_attributes = order.map do |attr|
+          "#{attr}: #{send(attr).inspect}"
+        end
+        "#<#{self.class} #{nice_attributes.join(', ')}>"
+      end
+
+      def masked_number
+        "#{bin}******#{last_4}"
+      end
+
+      class << self
+        protected :new
+      end
+
+      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
+        ]
+      end
+
+      def self._new(*args) # :nodoc:
+        self.new(*args)
+      end
+    end
+  end

data/lib/braintree/meta_checkout_token.rb

@@ -0,0 +1,88 @@
+module Braintree
+    class MetaCheckoutToken
+      include BaseModule # :nodoc:
+      include Braintree::Util::TokenEquality
+
+      attr_reader :bin
+      attr_reader :container_id
+      attr_reader :card_type
+      attr_reader :cardholder_name
+      attr_reader :commercial
+      attr_reader :country_of_issuance
+      attr_reader :created_at
+      attr_reader :cryptogram
+      attr_reader :customer_id
+      attr_reader :customer_location
+      attr_reader :debit
+      attr_reader :durbin_regulated
+      attr_reader :ecommerce_indicator
+      attr_reader :expiration_month
+      attr_reader :expiration_year
+      attr_reader :healthcare
+      attr_reader :image_url
+      attr_reader :issuing_bank
+      attr_reader :last_4
+      attr_reader :payroll
+      attr_reader :prepaid
+      attr_reader :product_id
+      attr_reader :token
+      attr_reader :unique_number_identifier
+      attr_reader :updated_at
+      attr_reader :verification
+
+      def initialize(gateway, attributes) # :nodoc:
+        @gateway = gateway
+        set_instance_variables_from_hash(attributes)
+        @verification = _most_recent_verification(attributes)
+      end
+
+      def _most_recent_verification(attributes)
+        verification = (attributes[:verifications] || []).sort_by { |v| v[:created_at] }.reverse.first
+        CreditCardVerification._new(verification) if verification
+      end
+
+      def default?
+        @default
+      end
+
+      # Expiration date formatted as MM/YYYY
+      def expiration_date
+        "#{expiration_month}/#{expiration_year}"
+      end
+
+      def expired?
+        @expired
+      end
+
+      def inspect # :nodoc:
+        first = [:token]
+        order = first + (self.class._attributes - first)
+        nice_attributes = order.map do |attr|
+          "#{attr}: #{send(attr).inspect}"
+        end
+        "#<#{self.class} #{nice_attributes.join(', ')}>"
+      end
+
+      def masked_number
+        "#{bin}******#{last_4}"
+      end
+
+      class << self
+        protected :new
+      end
+
+      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
+        ]
+      end
+
+      def self._new(*args) # :nodoc:
+        self.new(*args)
+      end
+    end
+  end

data/lib/braintree/modification.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class Modification # :nodoc:
+  class Modification
     include BaseModule
 
     attr_reader :amount
@@ -17,12 +17,12 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
+      def _new(*args)
         self.new(*args)
       end
     end
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
       @amount = Util.to_big_decimal(amount)
     end

data/lib/braintree/oauth_credentials.rb

@@ -1,13 +1,13 @@
 module Braintree
   class OAuthCredentials
-    include BaseModule # :nodoc:
+    include BaseModule
 
     attr_reader :access_token
     attr_reader :expires_at
     attr_reader :refresh_token
     attr_reader :token_type
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
     end
 
@@ -15,7 +15,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
   end

data/lib/braintree/paginated_collection.rb

@@ -1,8 +1,8 @@
 module Braintree
-  class PaginatedCollection # :nodoc:
+  class PaginatedCollection
     include Enumerable
 
-    def initialize(&block) # :nodoc:
+    def initialize(&block)
       @next_page_block = block
     end
 

data/lib/braintree/paginated_result.rb

@@ -6,7 +6,7 @@ module Braintree
     attr_reader :page_size
     attr_reader :total_items
 
-    def initialize(total_items, page_size, current_page) # :nodoc:
+    def initialize(total_items, page_size, current_page)
       @total_items = total_items
       @current_page = current_page
       @page_size = page_size

data/lib/braintree/payment_instrument_type.rb

@@ -4,6 +4,8 @@ module Braintree
     CreditCard = "credit_card"
     GooglePayCard = "android_pay_card"
     LocalPayment = "local_payment"
+    MetaCheckoutCard = "meta_checkout_card"
+    MetaCheckoutToken = "meta_checkout_token"
     PayPalAccount = "paypal_account"
     PayPalHere = "paypal_here"
     SamsungPayCard = "samsung_pay_card"

data/lib/braintree/payment_method_customer_data_updated_metadata.rb

@@ -7,7 +7,7 @@ module Braintree
     attr_reader :datetime_updated
     attr_reader :enriched_customer_data
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       set_instance_variables_from_hash(attributes)
       @payment_method = PaymentMethodParser.parse_payment_method(gateway, attributes[:payment_method])
       @enriched_customer_data = EnrichedCustomerData._new(enriched_customer_data) if enriched_customer_data
@@ -17,7 +17,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
   end

data/lib/braintree/payment_method_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class PaymentMethodGateway # :nodoc:
+  class PaymentMethodGateway
     include BaseModule
 
     def initialize(gateway)
@@ -9,6 +9,10 @@ module Braintree
     end
 
     def create(attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(PaymentMethodGateway._create_signature, attributes)
       _do_create("/payment_methods", :payment_method => attributes)
     end
@@ -17,7 +21,7 @@ module Braintree
       return_object_or_raise(:payment_method) { create(*args) }
     end
 
-    def _do_create(path, params=nil) # :nodoc:
+    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])
@@ -60,6 +64,10 @@ module Braintree
     end
 
     def update(token, attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(PaymentMethodGateway._update_signature, attributes)
       _do_update(:put, "/payment_methods/any/#{token}", :payment_method => attributes)
     end
@@ -68,7 +76,7 @@ module Braintree
       return_object_or_raise(:payment_method) { update(*args) }
     end
 
-    def _do_update(http_verb, path, params) # :nodoc:
+    def _do_update(http_verb, path, params)
       response = @config.http.send(http_verb, "#{@config.base_merchant_path}#{path}", params)
       if response[:api_error_response]
         ErrorResult.new(@gateway, response[:api_error_response])
@@ -134,27 +142,30 @@ module Braintree
       end
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       _signature(:create)
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       _signature(:update)
     end
 
-    def self._delete_signature # :nodoc:
+    def self._delete_signature
       [:revoke_all_grants]
     end
 
-    def self._signature(type) # :nodoc:
+    def self._signature(type)
       billing_address_params = AddressGateway._shared_signature
       paypal_options_shipping_signature = AddressGateway._shared_signature
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_session
+      # The old venmo SDK class has been deprecated
       options = [
         :make_default,
         :skip_advanced_fraud_checking,
         :us_bank_account_verification_method,
-        :venmo_sdk_session,
+        :venmo_sdk_session, # Deprecated
         :verification_account_type,
+        :verification_add_ons,
         :verification_amount,
         :verification_currency_iso_code,
         :verification_merchant_account_id,
@@ -168,10 +179,12 @@ module Braintree
           {:shipping => paypal_options_shipping_signature}
         ],
       ]
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_payment_method_code
+      # The old venmo SDK class has been deprecated
       signature = [
         :billing_address_id, :cardholder_name, :cvv, :expiration_date, :expiration_month,
-        :expiration_year, :number, :token, :venmo_sdk_payment_method_code, :device_data,
-        :payment_method_nonce,
+        :expiration_year, :number, :token, :venmo_sdk_payment_method_code, # Deprecated
+        :device_data, :payment_method_nonce,
         {:options => options},
         {:billing_address => billing_address_params}
       ]

data/lib/braintree/payment_method_nonce.rb

@@ -1,6 +1,6 @@
 module Braintree
   class PaymentMethodNonce
-    include BaseModule # :nodoc:
+    include BaseModule
 
     def self.create(*args)
       Configuration.gateway.payment_method_nonce.create(*args)
@@ -22,7 +22,7 @@ module Braintree
     attr_reader :type
     attr_reader :authentication_insight
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       @details = PaymentMethodNonceDetails.new(attributes[:details]) if attributes[:details]
@@ -34,7 +34,7 @@ module Braintree
       @default
     end
 
-    def to_s # :nodoc:
+    def to_s
       nonce
     end
 
@@ -42,7 +42,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(gateway, attributes) # :nodoc:
+    def self._new(gateway, attributes)
       new(gateway, attributes)
     end
   end

data/lib/braintree/payment_method_nonce_details.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class PaymentMethodNonceDetails # :nodoc:
+  class PaymentMethodNonceDetails
     include BaseModule
 
     attr_reader :bin

data/lib/braintree/payment_method_nonce_details_payer_info.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class PaymentMethodNonceDetailsPayerInfo # :nodoc:
+  class PaymentMethodNonceDetailsPayerInfo
     include BaseModule
 
     attr_reader :billing_agreement_id

data/lib/braintree/payment_method_nonce_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class PaymentMethodNonceGateway # :nodoc:
+  class PaymentMethodNonceGateway
     include BaseModule
 
     def initialize(gateway)

data/lib/braintree/paypal_account.rb

@@ -13,7 +13,7 @@ module Braintree
     attr_reader :token
     attr_reader :updated_at
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       @subscriptions = (@subscriptions || []).map { |subscription_hash| Subscription._new(@gateway, subscription_hash) }
@@ -51,7 +51,6 @@ module Braintree
       return_object_or_raise(:transaction) { sale(token, transaction_attributes) }
     end
 
-    # Returns true if this paypal account is the customer's default payment method.
     def default?
       @default
     end