module Braintree # See http://www.braintreepaymentsolutions.com/docs/ruby class Customer include BaseModule 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) } 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 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) } end # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/delete def self.delete(customer_id) Configuration.gateway.customer.delete(customer_id) end # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/search def self.find(customer_id) Configuration.gateway.customer.find(customer_id) 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 # 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) 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) } 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 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: @gateway = gateway set_instance_variables_from_hash(attributes) @credit_cards = (@credit_cards || []).map { |pm| CreditCard._new gateway, pm } @addresses = (@addresses || []).map { |addr| Address._new gateway, addr } 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 delete @gateway.customer.delete(id) end def inspect # :nodoc: first = [:id] last = [:addresses, :credit_cards] order = first + (self.class._attributes - first - last) + last nice_attributes = order.map do |attr| "#{attr}: #{send(attr).inspect}" end "#<#{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 CreditCard.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 CreditCard.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 CreditCard.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 CreditCard.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 end def self._attributes # :nodoc: [ :addresses, :company, :credit_cards, :email, :fax, :first_name, :id, :last_name, :phone, :website, :created_at, :updated_at ] end end end