braintree 4.14.0 → 4.16.0

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

data/lib/braintree/paypal_account_gateway.rb

@@ -28,7 +28,7 @@ module Braintree
       @config.http.delete("#{@config.base_merchant_path}/payment_methods/paypal_account/#{token}")
     end
 
-    def _do_create(path, params) # :nodoc:
+    def _do_create(path, params)
       response = @config.http.post("#{@config.base_merchant_path}#{path}", params)
       if response[:paypal_account]
         SuccessfulResult.new(:paypal_account => PayPalAccount._new(@gateway, response[:paypal_account]))
@@ -39,7 +39,7 @@ module Braintree
       end
     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[:paypal_account]
         SuccessfulResult.new(:paypal_account => PayPalAccount._new(@gateway, response[:paypal_account]))
@@ -50,7 +50,7 @@ module Braintree
       end
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       options = [:fail_on_duplicate_payment_method, :make_default]
       [
         :email, :token, :billing_agreement_id, :customer_id,
@@ -58,14 +58,14 @@ module Braintree
       ]
     end
 
-    def self._create_nested_signature # :nodoc:
+    def self._create_nested_signature
       [
         :email, :token, :billing_agreement_id,
         {:options => [:make_default]}
       ]
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       options = [:fail_on_duplicate_payment_method, :make_default]
       [:email, :token, :billing_agreement_id, {:options => options}]
     end

data/lib/braintree/plan.rb

@@ -23,7 +23,7 @@ module Braintree
       Configuration.gateway.plan.all
     end
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       add_ons.map! { |attrs| AddOn._new(attrs) }

data/lib/braintree/plan_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class PlanGateway # :nodoc:
+  class PlanGateway
     include BaseModule
 
     def initialize(gateway)
@@ -102,7 +102,7 @@ module Braintree
       ]
     end
 
-    def _do_create(path, params) # :nodoc:
+    def _do_create(path, params)
       response = @config.http.post("#{@config.base_merchant_path}#{path}", params)
       if response[:plan]
         SuccessfulResult.new(:plan => Plan._new(@gateway, response[:plan]))

data/lib/braintree/resource_collection.rb

@@ -1,10 +1,10 @@
 module Braintree
-  class ResourceCollection # :nodoc:
+  class ResourceCollection
     include Enumerable
 
     attr_reader :ids
 
-    def initialize(response, &block) # :nodoc:
+    def initialize(response, &block)
       @ids = Util.extract_attribute_as_array(response[:search_results], :ids)
       @page_size = response[:search_results][:page_size]
       @paging_block = block