braintree 4.15.0 → 4.17.0

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"
@@ -72,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/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

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/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/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

data/lib/braintree/transaction.rb

@@ -77,9 +77,9 @@ module Braintree
       All = constants.map { |c| const_get(c) }
     end
 
-    module Type # :nodoc:
-      Credit = "credit" # :nodoc:
-      Sale = "sale" # :nodoc:
+    module Type
+      Credit = "credit"
+      Sale = "sale"
 
       All = constants.map { |c| const_get(c) }
     end
@@ -131,6 +131,8 @@ module Braintree
     attr_reader :merchant_account_id
     attr_reader :merchant_advice_code
     attr_reader :merchant_advice_code_text
+    attr_reader :meta_checkout_card_details
+    attr_reader :meta_checkout_token_details
     attr_reader :network_response_code                  # Response code from the card network
     attr_reader :network_response_text                  # Response text from the card network
     attr_reader :network_token_details
@@ -142,12 +144,12 @@ module Braintree
     attr_reader :paypal_details
     attr_reader :paypal_here_details
     attr_reader :plan_id
-    attr_reader :processor_authorization_code           # Authorization code from the processor.
-    attr_reader :processor_response_code                # Response code from the processor.
-    attr_reader :processor_response_text                # Response text from the processor.
-    attr_reader :processor_response_type                # Response type from the processor.
-    attr_reader :processor_settlement_response_code     # Settlement response code from the processor.
-    attr_reader :processor_settlement_response_text     # Settlement response text from the processor.
+    attr_reader :processor_authorization_code
+    attr_reader :processor_response_code
+    attr_reader :processor_response_text
+    attr_reader :processor_response_type
+    attr_reader :processor_settlement_response_code
+    attr_reader :processor_settlement_response_text
     attr_reader :product_sku
     attr_reader :purchase_order_number
     attr_reader :recurring
@@ -175,7 +177,7 @@ module Braintree
     attr_reader :tax_amount
     attr_reader :tax_exempt
     attr_reader :three_d_secure_info
-    attr_reader :type                                   # Will either be "sale" or "credit"
+    attr_reader :type
     attr_reader :updated_at
     attr_reader :us_bank_account_details
     attr_reader :venmo_account_details
@@ -298,7 +300,7 @@ module Braintree
       Configuration.gateway.transaction.void!(*args)
     end
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
 
@@ -313,6 +315,8 @@ module Braintree
       @disbursement_details = DisbursementDetails.new(@disbursement_details)
       @google_pay_details = GooglePayDetails.new(@google_pay_card)
       @local_payment_details = LocalPaymentDetails.new(@local_payment)
+      @meta_checkout_card_details = MetaCheckoutCardDetails.new(attributes[:meta_checkout_card])
+      @meta_checkout_token_details = MetaCheckoutTokenDetails.new(attributes[:meta_checkout_token])
       @payment_instrument_type = attributes[:payment_instrument_type]
       @payment_receipt = PaymentReceipt.new(attributes[:payment_receipt]) if attributes[:payment_receipt]
       @paypal_details = PayPalDetails.new(@paypal)
@@ -342,7 +346,7 @@ module Braintree
       refunded_installments.map! { |attrs| Installment.new(attrs) } if refunded_installments
     end
 
-    def inspect # :nodoc:
+    def inspect
       first = [:id, :type, :amount, :status]
       order = first + (self.class._attributes - first)
       nice_attributes = order.map do |attr|
@@ -359,12 +363,10 @@ module Braintree
       @gateway.transaction_line_item.find_all(id)
     end
 
-    # Returns true if the transaction has been refunded. False otherwise.
     def refunded?
       !@refund_id.nil?
     end
 
-    # Returns true if the transaction has been disbursed. False otherwise.
     def disbursed?
       @disbursement_details.valid?
     end
@@ -373,6 +375,7 @@ module Braintree
     # vault_billing_address will return the associated Braintree::Address. Because the
     # vault billing address can be updated after the transaction was created, the attributes
     # on vault_billing_address may not match the attributes on billing_details.
+    # NEXT_MAJOR_VERSION these methods are not documented in the developer docs, remove
     def vault_billing_address
       return nil if billing_details.id.nil?
       @gateway.address.find(customer_details.id, billing_details.id)
@@ -382,6 +385,7 @@ module Braintree
     # vault_credit_card will return the associated Braintree::CreditCard. Because the
     # vault credit card can be updated after the transaction was created, the attributes
     # on vault_credit_card may not match the attributes on credit_card_details.
+    # NEXT_MAJOR_VERSION these methods are not documented in the developer docs, remove
     def vault_credit_card
       return nil if credit_card_details.token.nil?
       @gateway.credit_card.find(credit_card_details.token)
@@ -391,6 +395,7 @@ module Braintree
     # vault_customer will return the associated Braintree::Customer. Because the
     # vault customer can be updated after the transaction was created, the attributes
     # on vault_customer may not match the attributes on customer_details.
+    # NEXT_MAJOR_VERSION these methods are not documented in the developer docs, remove
     def vault_customer
       return nil if customer_details.id.nil?
       @gateway.customer.find(customer_details.id)
@@ -400,6 +405,7 @@ module Braintree
     # vault_shipping_address will return the associated Braintree::Address. Because the
     # vault shipping address can be updated after the transaction was created, the attributes
     # on vault_shipping_address may not match the attributes on shipping_details.
+    # NEXT_MAJOR_VERSION these methods are not documented in the developer docs, remove
     def vault_shipping_address
       return nil if shipping_details.id.nil?
       @gateway.address.find(customer_details.id, shipping_details.id)
@@ -411,12 +417,12 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
+      def _new(*args)
         self.new(*args)
       end
     end
 
-    def self._attributes # :nodoc:
+    def self._attributes
       [:amount, :created_at, :credit_card_details, :customer_details, :id, :status, :subscription_details, :type, :updated_at, :processed_with_network_token?]
     end
   end