braintree 4.14.0 → 4.18.0

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

data/lib/braintree/revoked_payment_method_metadata.rb

@@ -14,7 +14,7 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
+      def _new(*args)
         self.new(*args)
       end
     end

data/lib/braintree/risk_data.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class RiskData # :nodoc:
+  class RiskData
     include BaseModule
 
     attr_reader :customer_device_id

data/lib/braintree/samsung_pay_card.rb

@@ -1,6 +1,6 @@
 module Braintree
   class SamsungPayCard
-    include BaseModule # :nodoc:
+    include BaseModule
     include Braintree::Util::TokenEquality
 
     attr_reader :billing_address
@@ -29,7 +29,7 @@ module Braintree
     attr_reader :unique_number_identifier
     attr_reader :updated_at
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       @billing_address = attributes[:billing_address] ? Address._new(@gateway, attributes[:billing_address]) : nil
@@ -49,7 +49,7 @@ module Braintree
       @expired
     end
 
-    def inspect # :nodoc:
+    def inspect
       first = [:token]
       order = first + (self.class._attributes - first)
       nice_attributes = order.map do |attr|
@@ -66,7 +66,7 @@ module Braintree
       protected :new
     end
 
-    def self._attributes # :nodoc:
+    def self._attributes
       [
         :billing_address, :bin, :cardholder_name, :card_type, :created_at, :customer_id,
         :customer_location, :expiration_month, :expiration_year,
@@ -76,7 +76,7 @@ module Braintree
       ]
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
   end

data/lib/braintree/sepa_direct_debit_account.rb

@@ -17,7 +17,7 @@ module Braintree
     attr_reader :updated_at
     attr_reader :view_mandate_url
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       @subscriptions = (@subscriptions || []).map { |subscription_hash| Subscription._new(@gateway, subscription_hash) }
       set_instance_variables_from_hash(attributes)
@@ -31,7 +31,7 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
+    def self._new(*args)
       self.new(*args)
     end
 

data/lib/braintree/sepa_direct_debit_account_nonce_details.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class SepaDirectDebitAccountNonceDetails# :nodoc:
+  class SepaDirectDebitAccountNonceDetails
     include BaseModule
 
     attr_reader :bank_reference_token

data/lib/braintree/settlement_batch_summary_gateway.rb

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

data/lib/braintree/sha256_digest.rb

@@ -1,5 +1,5 @@
 module Braintree
-  module SHA256Digest # :nodoc:
+  module SHA256Digest
     def self.hexdigest(private_key, string)
       _hmac(private_key, string)
     end

data/lib/braintree/subscription/status_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Subscription
-    class StatusDetails # :nodoc:
+    class StatusDetails
       include BaseModule
 
       attr_reader :balance

data/lib/braintree/subscription.rb

@@ -91,7 +91,7 @@ module Braintree
       Configuration.gateway.subscription.update!(*args)
     end
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       @balance = Util.to_big_decimal(balance)
@@ -114,7 +114,7 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
+      def _new(*args)
         self.new(*args)
       end
     end

data/lib/braintree/subscription_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class SubscriptionGateway # :nodoc:
+  class SubscriptionGateway
     include BaseModule
 
     def initialize(gateway)
@@ -70,7 +70,7 @@ module Braintree
       return_object_or_raise(:subscription) { update(*args) }
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       [
         :billing_day_of_month,
         :first_billing_date,
@@ -94,7 +94,7 @@ module Braintree
       ] + _add_on_discount_signature
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       [
         :id,
         :merchant_account_id,
@@ -114,7 +114,7 @@ module Braintree
       ] + _add_on_discount_signature
     end
 
-    def self._add_on_discount_signature # :nodoc:
+    def self._add_on_discount_signature
       [
         {
           :add_ons => [
@@ -133,7 +133,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[:subscription]
         SuccessfulResult.new(:subscription => Subscription._new(@gateway, response[:subscription]))
@@ -144,7 +144,7 @@ module Braintree
       end
     end
 
-    def _fetch_subscriptions(search, ids) # :nodoc:
+    def _fetch_subscriptions(search, ids)
       search.ids.in ids
       response = @config.http.post("#{@config.base_merchant_path}/subscriptions/advanced_search", {:search => search.to_hash})
       attributes = response[:subscriptions]

data/lib/braintree/subscription_search.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class SubscriptionSearch < AdvancedSearch  # :nodoc:
+  class SubscriptionSearch < AdvancedSearch
     multiple_value_field :in_trial_period
     multiple_value_field :ids
     text_fields :id, :transaction_id

data/lib/braintree/successful_result.rb

@@ -25,7 +25,7 @@ module Braintree
     attr_reader :transaction
     attr_reader :us_bank_account_verification
 
-    def initialize(attributes = {}) # :nodoc:
+    def initialize(attributes = {})
       @attrs = attributes.keys
       attributes.each do |key, value|
         instance_variable_set("@#{key}", value)
@@ -33,7 +33,7 @@ module Braintree
       @credit_card_verification = @verification
     end
 
-    def inspect # :nodoc:
+    def inspect
       inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
       "#<#{self.class} #{inspected_attributes.join(" ")}>"
     end

data/lib/braintree/test/credit_card.rb

@@ -1,8 +1,5 @@
 module Braintree
-  module Test # :nodoc:
-    # The constants contained in the Braintree::Test::CreditCardNumbers module provide
-    # credit card numbers that should be used when working in the sandbox environment. The sandbox
-    # will not accept any credit card numbers other than the ones listed below.
+  module Test
     module CreditCardNumbers
       module CardTypeIndicators
         Prepaid           = "4111111111111210"
@@ -18,16 +15,16 @@ module Braintree
       end
 
       AmExes = %w[378282246310005 371449635398431 378734493671000]
-      CarteBlanches = %w[30569309025904] # :nodoc:
-      DinersClubs = %w[38520000023237] # :nodoc:
+      CarteBlanches = %w[30569309025904]
+      DinersClubs = %w[38520000023237]
 
       Discover = "6011111111111117"
       Discovers = %w[6011111111111117 6011000990139424]
-      JCBs = %w[3530111333300000 3566002020360505] # :nodoc:
+      JCBs = %w[3530111333300000 3566002020360505]
 
-      Maestro = "6304000000000000" # :nodoc:
+      Maestro = "6304000000000000"
       MasterCard = "5555555555554444"
-      MasterCardInternational = "5105105105105100" # :nodoc:
+      MasterCardInternational = "5105105105105100"
 
       MasterCards = %w[5105105105105100 5555555555554444]
 
@@ -37,7 +34,7 @@ module Braintree
 
       Visa = "4012888888881881"
       VisaCountryOfIssuanceIE = "4023490000000008"
-      VisaInternational = "4009348888881881" # :nodoc:
+      VisaInternational = "4009348888881881"
       VisaPrepaid = "4500600000000061"
 
       Fraud = "4000111111111511"

data/lib/braintree/test/merchant_account.rb

@@ -1,5 +1,5 @@
 module Braintree
-  module Test # :nodoc:
+  module Test
     module MerchantAccount
       Approve = "approve_me"
 

data/lib/braintree/test/nonce.rb

@@ -18,6 +18,8 @@ module Braintree
       GooglePayVisa = "fake-android-pay-visa-nonce"
       GooglePayMasterCard = "fake-android-pay-mastercard-nonce"
       GooglePayAmEx = "fake-android-pay-amex-nonce"
+      MetaCheckoutCard = "fake-meta-checkout-card-nonce"
+      MetaCheckoutToken = "fake-meta-checkout-token-nonce"
       VenmoAccount = "fake-venmo-account-nonce"
       VenmoAccountTokenIssuanceError = "fake-token-issuance-error-venmo-account-nonce"
       ThreeDSecureVisaFullAuthentication = "fake-three-d-secure-visa-full-authentication-nonce"
@@ -53,6 +55,7 @@ module Braintree
       TransactableCountryOfIssuanceUSA = "fake-valid-country-of-issuance-usa-nonce"
       TransactableCountryOfIssuanceCAD = "fake-valid-country-of-issuance-cad-nonce"
       TransactableIssuingBankNetworkOnly = "fake-valid-issuing-bank-network-only-nonce"
+      TransactablePinlessDebitVisa = "fake-pinless-debit-visa-nonce"
       ProcessorDeclinedVisa = "fake-processor-declined-visa-nonce"
       ProcessorDeclinedMasterCard = "fake-processor-declined-mastercard-nonce"
       ProcessorDeclinedAmEx = "fake-processor-declined-amex-nonce"
@@ -71,6 +74,7 @@ module Braintree
       SamsungPayMasterCard = "tokensam_fake_mastercard"
       SamsungPayVisa = "tokensam_fake_visa"
       SepaDirectDebit = "fake-sepa-direct-debit-nonce"
+      UsBankAccount = "fake-us-bank-account-nonce"
     end
   end
 end

data/lib/braintree/test/transaction_amounts.rb

@@ -1,7 +1,6 @@
 module Braintree
-  module Test # :nodoc:
-    # The constants in this module can be used to create transactions with
-    # the desired status in the sandbox environment.
+  module Test
+    # NEXT_MAJOR_VERSION are these even being used anymore? Can we remove this class??
     module TransactionAmounts
       Authorize = "1000.00"
       Decline = "2000.00"

data/lib/braintree/test/venmo_sdk.rb

@@ -1,3 +1,5 @@
+# NEXT_MAJOR_VERSION Remove this class
+# The old venmo SDK class has been deprecated
 module Braintree
   module Test
     module VenmoSDK

data/lib/braintree/testing_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class TestingGateway # :nodoc:
+  class TestingGateway
 
     def initialize(gateway)
       @gateway = gateway

data/lib/braintree/three_d_secure_info.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class ThreeDSecureInfo # :nodoc:
+  class ThreeDSecureInfo
     include BaseModule
 
     attr_reader :acs_transaction_id

data/lib/braintree/transaction/address_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class AddressDetails # :nodoc:
+    class AddressDetails
       include BaseModule
 
       module ShippingMethod
@@ -10,6 +10,7 @@ module Braintree
         Ground = "ground"
         Electronic = "electronic"
         ShipToStore = "ship_to_store"
+        PickupInStore = "pickup_in_store"
       end
 
       attr_reader :company

data/lib/braintree/transaction/credit_card_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class CreditCardDetails # :nodoc:
+    class CreditCardDetails
       include BaseModule
 
       attr_reader :account_type
@@ -64,7 +64,10 @@ module Braintree
         "#{bin}******#{last_4}"
       end
 
+      # NEXT_MAJOR_VERSION Remove this method
+      # The old venmo SDK class has been deprecated
       def venmo_sdk?
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
         @venmo_sdk
       end
 

data/lib/braintree/transaction/customer_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class CustomerDetails # :nodoc:
+    class CustomerDetails
       include BaseModule
 
       attr_reader :company

data/lib/braintree/transaction/disbursement_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class DisbursementDetails # :nodoc:
+    class DisbursementDetails
       include BaseModule
 
       attr_reader :disbursement_date

data/lib/braintree/transaction/local_payment_details.rb

@@ -8,6 +8,8 @@ module Braintree
       attr_reader :debug_id
       attr_reader :description
       attr_reader :funding_source
+      attr_reader :implicitly_vaulted_payment_method_global_id
+      attr_reader :implicitly_vaulted_payment_method_token
       attr_reader :payer_id
       attr_reader :payment_id
       attr_reader :refund_from_transaction_fee_amount

data/lib/braintree/transaction/meta_checkout_card_details.rb

@@ -0,0 +1,52 @@
+module Braintree
+    class Transaction
+      class MetaCheckoutCardDetails # :nodoc:
+        include BaseModule
+
+        attr_reader :bin
+        attr_reader :card_type
+        attr_reader :cardholder_name
+        attr_reader :commercial
+        attr_reader :container_id
+        attr_reader :country_of_issuance
+        attr_reader :created_at
+        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 :is_network_tokenized
+        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
+
+        def initialize(attributes)
+          set_instance_variables_from_hash attributes unless attributes.nil?
+        end
+
+        def expiration_date
+          "#{expiration_month}/#{expiration_year}"
+        end
+
+        def inspect
+          attr_order = [:token, :bin, :last_4, :card_type, :expiration_date, :cardholder_name, :customer_location, :prepaid,
+          :healthcare, :durbin_regulated, :debit, :commercial, :payroll, :product_id, :country_of_issuance, :issuing_bank, :image_url, :container_id]
+          formatted_attrs = attr_order.map do |attr|
+            "#{attr}: #{send(attr).inspect}"
+          end
+          "#<#{formatted_attrs.join(", ")}>"
+        end
+
+        def masked_number
+          "#{bin}******#{last_4}"
+        end
+      end
+    end
+  end

data/lib/braintree/transaction/meta_checkout_token_details.rb

@@ -0,0 +1,54 @@
+module Braintree
+    class Transaction
+      class MetaCheckoutTokenDetails # :nodoc:
+        include BaseModule
+
+        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_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 :is_network_tokenized
+        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
+
+        def initialize(attributes)
+          set_instance_variables_from_hash attributes unless attributes.nil?
+        end
+
+        def expiration_date
+          "#{expiration_month}/#{expiration_year}"
+        end
+
+        def inspect
+          attr_order = [:container_id, :cryptogram, :ecommerce_indicator, :token, :bin, :last_4, :card_type, :expiration_date, :cardholder_name, :customer_location, :prepaid,
+          :healthcare, :durbin_regulated, :debit, :commercial, :payroll, :product_id, :country_of_issuance, :issuing_bank, :is_network_tokenized, :image_url]
+          formatted_attrs = attr_order.map do |attr|
+            "#{attr}: #{send(attr).inspect}"
+          end
+          "#<#{formatted_attrs.join(", ")}>"
+        end
+
+        def masked_number
+          "#{bin}******#{last_4}"
+        end
+      end
+    end
+  end

data/lib/braintree/transaction/package_details.rb

@@ -0,0 +1,16 @@
+module Braintree
+    class Transaction
+        class PackageDetails
+            include BaseModule
+
+            attr_reader :carrier
+            attr_reader :id
+            attr_reader :paypal_tracking_id
+            attr_reader :tracking_number
+
+            def initialize(attributes)
+                set_instance_variables_from_hash attributes unless attributes.nil?
+            end
+        end
+    end
+end

data/lib/braintree/transaction/samsung_pay_card_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class SamsungPayCardDetails # :nodoc:
+    class SamsungPayCardDetails
       include BaseModule
 
       attr_reader :bin

data/lib/braintree/transaction/sepa_direct_debit_account_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class SepaDirectDebitAccountDetails # :nodoc:
+    class SepaDirectDebitAccountDetails
       include BaseModule
 
       attr_reader :bank_reference_token

data/lib/braintree/transaction/status_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class StatusDetails # :nodoc:
+    class StatusDetails
       include BaseModule
 
       attr_reader :amount

data/lib/braintree/transaction/subscription_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class SubscriptionDetails # :nodoc:
+    class SubscriptionDetails
       include BaseModule
 
       attr_reader :billing_period_end_date

data/lib/braintree/transaction/us_bank_account_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class UsBankAccountDetails # :nodoc:
+    class UsBankAccountDetails
       include BaseModule
 
       attr_reader :account_holder_name

data/lib/braintree/transaction/visa_checkout_card_details.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class VisaCheckoutCardDetails # :nodoc:
+    class VisaCheckoutCardDetails
       include BaseModule
 
       attr_reader :bin