braintree 2.10.0 → 4.26.0

data/lib/braintree/credit_card_verification.rb

@@ -1,32 +1,92 @@
 module Braintree
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/general/card_verification
   class CreditCardVerification
     include BaseModule
+    include Braintree::Util::IdEquality
+
+    module GatewayRejectionReason
+      ApplicationIncomplete = "application_incomplete"
+      AVS          = "avs"
+      AVSAndCVV    = "avs_and_cvv"
+      CVV          = "cvv"
+      Duplicate    = "duplicate"
+      Fraud        = "fraud"
+      RiskThreshold = "risk_threshold"
+      ThreeDSecure = "three_d_secure"
+      TokenIssuance = "token_issuance"
+      Unrecognized = "unrecognized"
+    end
 
     module Status
-      FAILED = 'failed'
-      GATEWAY_REJECTED = 'gateway_rejected'
-      PROCESSOR_DECLINED = 'processor_declined'
-      VERIFIED = 'verified'
+      Failed = "failed"
+      GatewayRejected = "gateway_rejected"
+      ProcessorDeclined = "processor_declined"
+      Verified = "verified"
+
+      All = [Failed, GatewayRejected, ProcessorDeclined, Verified]
     end
 
-    attr_reader :avs_error_response_code, :avs_postal_code_response_code, :avs_street_address_response_code,
-      :cvv_response_code, :merchant_account_id, :processor_response_code, :processor_response_text, :status,
-      :gateway_rejection_reason
+    attr_reader :amount
+    attr_reader :ani_first_name_response_code
+    attr_reader :ani_last_name_response_code
+    attr_reader :avs_error_response_code
+    attr_reader :avs_postal_code_response_code
+    attr_reader :avs_street_address_response_code
+    attr_reader :billing
+    attr_reader :created_at
+    attr_reader :credit_card
+    attr_reader :currency_iso_code
+    attr_reader :cvv_response_code
+    attr_reader :gateway_rejection_reason
+    attr_reader :graphql_id
+    attr_reader :id
+    attr_reader :merchant_account_id
+    attr_reader :network_response_code
+    attr_reader :network_response_text
+    attr_reader :network_transaction_id
+    attr_reader :processor_response_code
+    attr_reader :processor_response_text
+    attr_reader :processor_response_type
+    attr_reader :risk_data
+    attr_reader :status
+    attr_reader :three_d_secure_info
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
+
+      @amount = Util.to_big_decimal(amount)
+
+      @risk_data = RiskData.new(attributes[:risk_data]) if attributes[:risk_data]
+      @three_d_secure_info = ThreeDSecureInfo.new(attributes[:three_d_secure_info]) if attributes[:three_d_secure_info]
     end
 
-    def inspect # :nodoc:
+    def inspect
       attr_order = [
-        :status, :processor_response_code, :processor_response_text,
-        :cvv_response_code, :avs_error_response_code,
-        :avs_postal_code_response_code, :avs_street_address_response_code,
-        :merchant_account_id, :gateway_rejection_reason
+        :amount,
+        :ani_first_name_response_code,
+        :ani_last_name_response_code,
+        :avs_error_response_code,
+        :avs_postal_code_response_code,
+        :avs_street_address_response_code,
+        :billing,
+        :created_at,
+        :credit_card,
+        :currency_iso_code,
+        :cvv_response_code,
+        :gateway_rejection_reason,
+        :id,
+        :merchant_account_id,
+        :network_response_code,
+        :network_response_text,
+        :processor_response_code,
+        :processor_response_text,
+        :status
       ]
       formatted_attrs = attr_order.map do |attr|
-        "#{attr}: #{send(attr).inspect}"
+        if attr == :amount
+          Util.inspect_amount(self.amount)
+        else
+          "#{attr}: #{send(attr).inspect}"
+        end
       end
       "#<#{self.class} #{formatted_attrs.join(", ")}>"
     end
@@ -35,8 +95,21 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
+    end
+
+    def self.find(*args)
+      Configuration.gateway.verification.find(*args)
+    end
+
+    def self.search(&block)
+      Configuration.gateway.verification.search(&block)
+    end
+
+    def self.create(attributes)
+      Util.verify_keys(CreditCardVerificationGateway._create_signature, attributes)
+      Configuration.gateway.verification.create(attributes)
     end
   end
 end

data/lib/braintree/credit_card_verification_gateway.rb

@@ -0,0 +1,87 @@
+module Braintree
+  class CreditCardVerificationGateway
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+      @config.assert_has_access_token_or_keys
+    end
+
+    def find(id)
+      raise ArgumentError if id.nil? || id.to_s.strip == ""
+      response = @config.http.get("#{@config.base_merchant_path}/verifications/#{id}")
+      CreditCardVerification._new(response[:verification])
+    rescue NotFoundError
+      raise NotFoundError, "verification with id #{id.inspect} not found"
+    end
+
+    def search(&block)
+      search = CreditCardVerificationSearch.new
+      block.call(search) if block
+
+      response = @config.http.post("#{@config.base_merchant_path}/verifications/advanced_search_ids", {:search => search.to_hash})
+      ResourceCollection.new(response) { |ids| _fetch_verifications(search, ids) }
+    end
+
+    def create(params)
+      response = @config.http.post("#{@config.base_merchant_path}/verifications", :verification => params)
+      _handle_verification_create_response(response)
+    end
+
+    def _handle_verification_create_response(response)
+      if response[:verification]
+        SuccessfulResult.new(:verification => CreditCardVerification._new(response[:verification]))
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise UnexpectedError, "expected :verification or :api_error_response"
+      end
+    end
+
+    def _fetch_verifications(search, ids)
+      search.ids.in ids
+      response = @config.http.post("#{@config.base_merchant_path}/verifications/advanced_search", {:search => search.to_hash})
+      attributes = response[:credit_card_verifications]
+      Util.extract_attribute_as_array(attributes, :verification).map { |attrs| CreditCardVerification._new(attrs) }
+    end
+
+    def self._create_signature
+      [
+        {:credit_card => [
+          {:billing_address => AddressGateway._shared_signature},
+          :cardholder_name,
+          :cvv,
+          :expiration_date,
+          :expiration_month,
+          :expiration_year,
+          :number,
+        ]},
+        {:external_vault => [
+          :previous_network_transaction_id,
+          :status,
+        ]},
+        :intended_transaction_source,
+        {:options => [
+          :account_type,
+          :amount,
+          :merchant_account_id,
+        ]},
+        :payment_method_nonce,
+        {:risk_data => [
+          :customer_browser,
+          :customer_ip,
+        ]},
+        :three_d_secure_authentication_id,
+        {:three_d_secure_pass_thru => [
+          :authentication_response,
+          :cavv,
+          :cavv_algorithm,
+          :directory_response,
+          :ds_transaction_id,
+          :eci_flag,
+          :three_d_secure_version,
+          :xid,
+        ]},
+      ]
+    end
+  end
+end

data/lib/braintree/credit_card_verification_search.rb

@@ -0,0 +1,20 @@
+module Braintree
+  class CreditCardVerificationSearch < AdvancedSearch
+     text_fields(
+       :billing_address_details_postal_code,
+       :credit_card_cardholder_name,
+       :customer_email,
+       :customer_id,
+       :id,
+       :payment_method_token,
+     )
+
+    equality_fields :credit_card_expiration_date
+    partial_match_fields :credit_card_number
+
+    multiple_value_field :credit_card_card_type, :allows => CreditCard::CardType::All
+    multiple_value_field :status, :allows => CreditCardVerification::Status::All
+    multiple_value_field :ids
+    range_fields :created_at
+  end
+end

data/lib/braintree/customer.rb

@@ -1,133 +1,134 @@
 module Braintree
-  # See http://www.braintreepaymentsolutions.com/docs/ruby
   class Customer
     include BaseModule
+    include Braintree::Util::IdEquality
+
+    attr_reader :addresses
+    attr_reader :apple_pay_cards
+    attr_reader :company
+    attr_reader :created_at
+    attr_reader :credit_cards
+    attr_reader :custom_fields
+    attr_reader :email
+    attr_reader :fax
+    attr_reader :first_name
+    attr_reader :google_pay_cards
+    attr_reader :graphql_id
+    attr_reader :id
+    attr_reader :international_phone
+    attr_reader :last_name
+    attr_reader :paypal_accounts
+    attr_reader :phone
+    attr_reader :samsung_pay_cards
+    attr_reader :sepa_direct_debit_accounts
+    attr_reader :tax_identifiers
+    attr_reader :updated_at
+    attr_reader :us_bank_accounts
+    attr_reader :venmo_accounts
+    attr_reader :visa_checkout_cards
+    attr_reader :website
 
-    attr_reader :addresses, :company, :created_at, :credit_cards, :email, :fax, :first_name, :id, :last_name,
-      :phone, :updated_at, :website, :custom_fields
-
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/search
     def self.all
       Configuration.gateway.customer.all
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/create
-    def self.create(attributes = {})
-      Configuration.gateway.customer.create(attributes)
-    end
-
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/create
-    def self.create!(attributes = {})
-      return_object_or_raise(:customer) { create(attributes) }
+    def self.create(*args)
+      Configuration.gateway.customer.create(*args)
     end
 
-    # Deprecated. Use Braintree::TransparentRedirect.url
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/create_tr
-    def self.create_customer_url
-      warn "[DEPRECATED] Customer.create_customer_url is deprecated. Please use TransparentRedirect.url"
-      Configuration.gateway.customer.create_customer_url
+    def self.create!(*args)
+      Configuration.gateway.customer.create!(*args)
     end
 
-    # Deprecated. Use Braintree::TransparentRedirect.confirm
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/create_tr
-    def self.create_from_transparent_redirect(query_string)
-      warn "[DEPRECATED] Customer.create_from_transparent_redirect is deprecated. Please use TransparentRedirect.confirm"
-      Configuration.gateway.customer.create_from_transparent_redirect(query_string)
-    end
-
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
     def self.credit(customer_id, transaction_attributes)
       Transaction.credit(transaction_attributes.merge(:customer_id => customer_id))
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
     def self.credit!(customer_id, transaction_attributes)
-       return_object_or_raise(:transaction){ credit(customer_id, transaction_attributes) }
+       return_object_or_raise(:transaction) { credit(customer_id, transaction_attributes) }
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/delete
-    def self.delete(customer_id)
-      Configuration.gateway.customer.delete(customer_id)
+    def self.delete(*args)
+      Configuration.gateway.customer.delete(*args)
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/search
-    def self.find(customer_id)
-      Configuration.gateway.customer.find(customer_id)
+    def self.find(*args)
+      Configuration.gateway.customer.find(*args)
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
     def self.sale(customer_id, transaction_attributes)
       Transaction.sale(transaction_attributes.merge(:customer_id => customer_id))
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
     def self.sale!(customer_id, transaction_attributes)
       return_object_or_raise(:transaction) { sale(customer_id, transaction_attributes) }
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/search
     def self.search(&block)
       Configuration.gateway.customer.search(&block)
     end
 
-    # Returns a ResourceCollection of transactions for the customer with the given +customer_id+.
-    def self.transactions(customer_id, options = {})
-      Configuration.gateway.customer.transactions(customer_id, options = {})
-    end
-
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/update
-    def self.update(customer_id, attributes)
-      Configuration.gateway.customer.update(customer_id, attributes)
+    def self.transactions(*args)
+      Configuration.gateway.customer.transactions(*args)
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/update
-    def self.update!(customer_id, attributes)
-      return_object_or_raise(:customer) { update(customer_id, attributes) }
+    def self.update(*args)
+      Configuration.gateway.customer.update(*args)
     end
 
-    # Deprecated. Use Braintree::TransparentRedirect.url
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/update_tr
-    def self.update_customer_url
-      warn "[DEPRECATED] Customer.update_customer_url is deprecated. Please use TransparentRedirect.url"
-      Configuration.gateway.customer.update_customer_url
+    def self.update!(*args)
+      Configuration.gateway.customer.update!(*args)
     end
 
-    # Deprecated. Use Braintree::TransparentRedirect.confirm
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/update_tr
-    def self.update_from_transparent_redirect(query_string)
-      warn "[DEPRECATED] Customer.update_from_transparent_redirect is deprecated. Please use TransparentRedirect.confirm"
-      Configuration.gateway.customer.update_from_transparent_redirect(query_string)
-    end
-
-    def initialize(gateway, attributes) # :nodoc:
+    # NEXT_MAJOR_VERSION remove samsung_pay_cards
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
       @credit_cards = (@credit_cards || []).map { |pm| CreditCard._new gateway, pm }
+      @paypal_accounts = (@paypal_accounts || []).map { |pm| PayPalAccount._new gateway, pm }
+      @apple_pay_cards = (@apple_pay_cards || []).map { |pm| ApplePayCard._new gateway, pm }
+      @google_pay_cards = (@google_pay_cards || []).map { |pm| GooglePayCard._new gateway, pm }
+      @venmo_accounts = (@venmo_accounts || []).map { |pm| VenmoAccount._new gateway, pm }
+      @us_bank_accounts = (@us_bank_accounts || []).map { |pm| UsBankAccount._new gateway, pm }
+      @visa_checkout_cards = (@visa_checkout_cards|| []).map { |pm| VisaCheckoutCard._new gateway, pm }
+      @sepa_direct_debit_accounts = (@sepa_debit_accounts || []).map { |pm| SepaDirectDebitAccount._new gateway, pm }
+      @samsung_pay_cards = (@samsung_pay_cards|| []).map { |pm| SamsungPayCard._new gateway, pm } # Deprecated
       @addresses = (@addresses || []).map { |addr| Address._new gateway, addr }
+      @tax_identifiers = (@tax_identifiers || []).map { |addr| TaxIdentifier._new gateway, addr }
+      @custom_fields = attributes[:custom_fields].is_a?(Hash) ? attributes[:custom_fields] : {}
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
     def credit(transaction_attributes)
       @gateway.transaction.credit(transaction_attributes.merge(:customer_id => id))
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
     def credit!(transaction_attributes)
       return_object_or_raise(:transaction) { credit(transaction_attributes) }
     end
 
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/delete
+    def default_payment_method
+      payment_methods.find { |payment_instrument| payment_instrument.default? }
+    end
+
     def delete
       @gateway.customer.delete(id)
     end
 
-    def inspect # :nodoc:
+    def payment_methods
+      @credit_cards +
+        @paypal_accounts +
+        @apple_pay_cards +
+        @google_pay_cards +
+        @venmo_accounts +
+        @us_bank_accounts +
+        @visa_checkout_cards +
+        @samsung_pay_cards +
+        @sepa_direct_debit_accounts
+    end
+
+    def inspect
       first = [:id]
-      last = [:addresses, :credit_cards]
+      last = [:addresses, :credit_cards, :paypal_accounts, :tax_identifiers]
       order = first + (self.class._attributes - first - last) + last
       nice_attributes = order.map do |attr|
         "#{attr}: #{send(attr).inspect}"
@@ -135,66 +136,27 @@ module Braintree
       "#<#{self.class} #{nice_attributes.join(', ')}>"
     end
 
-    # Deprecated. Use Braintree::Customer.sale
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
-    def sale(transaction_attributes)
-      warn "[DEPRECATED] sale as an instance method is deprecated. Please use Customer.sale"
-      @gateway.transaction.sale(transaction_attributes.merge(:customer_id => id))
-    end
-
-    # Deprecated. Use Braintree::Customer.sale!
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/create_from_vault
-    def sale!(transaction_attributes)
-      warn "[DEPRECATED] sale! as an instance method is deprecated. Please use Customer.sale!"
-      return_object_or_raise(:transaction) { sale(transaction_attributes) }
-    end
-
-    # Returns a ResourceCollection of transactions for the customer.
     def transactions(options = {})
       @gateway.customer.transactions(id, options)
     end
 
-    # Deprecated. Use Braintree::Customer.update
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/update
-    def update(attributes)
-      warn "[DEPRECATED] update as an instance method is deprecated. Please use Customer.update"
-      result = @gateway.customer.update(id, attributes)
-      if result.success?
-        copy_instance_variables_from_object result.customer
-      end
-      result
-    end
-
-    # Deprecated. Use Braintree::Customer.update!
-    #
-    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/update
-    def update!(attributes)
-      warn "[DEPRECATED] update! as an instance method is deprecated. Please use Customer.update!"
-      return_object_or_raise(:customer) { update(attributes) }
-    end
-
-    # Returns true if +other+ is a Customer with the same id
-    def ==(other)
-      return false unless other.is_a?(Customer)
-      id == other.id
-    end
-
     class << self
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
 
-    def self._attributes # :nodoc:
+    def self._attributes
       [
-        :addresses, :company, :credit_cards, :email, :fax, :first_name, :id, :last_name, :phone, :website,
-        :created_at, :updated_at
+        :addresses, :company, :credit_cards, :email, :fax, :first_name, :id, :international_phone,
+        :last_name, :phone, :website, :created_at, :updated_at, :tax_identifiers
       ]
     end
+
+    def self._now_timestamp
+      Time.now.to_i
+    end
   end
 end