module Braintree class CreditCard include BaseModule # :nodoc: attr_reader :billing_address, :bin, :card_type, :cardholder_name, :created_at, :customer_id, :expiration_month, :expiration_year, :last_4, :token, :updated_at def self.create(attributes) if attributes.has_key?(:expiration_date) && (attributes.has_key?(:expiration_month) || attributes.has_key?(:expiration_year)) raise ArgumentError.new("create with both expiration_month and expiration_year or only expiration_date") end Util.verify_keys(_create_signature, attributes) _do_create("/payment_methods", :credit_card => attributes) end def self.create!(attributes) return_object_or_raise(:credit_card) { create(attributes) } end # The transparent redirect URL to use to create a credit card. def self.create_credit_card_url "#{Braintree::Configuration.base_merchant_url}/payment_methods/all/create_via_transparent_redirect_request" end def self.create_from_transparent_redirect(query_string) params = TransparentRedirect.parse_and_validate_query_string query_string _do_create("/payment_methods/all/confirm_transparent_redirect_request", :id => params[:id]) end def self.credit(token, transaction_attributes) Transaction.credit(transaction_attributes.merge( :payment_method_token => token )) end def self.credit!(token, transaction_attributes) return_object_or_raise(:transaction) { credit(token, transaction_attributes) } end # Returns a PagedCollection of expired credit cards. def self.expired(options = {}) page_number = options[:page] || 1 response = Http.get("/payment_methods/all/expired?page=#{page_number}") attributes = response[:payment_methods] attributes[:items] = Util.extract_attribute_as_array(attributes, :credit_card).map do |payment_method_attributes| new payment_method_attributes end PagedCollection.new(attributes) { |page_number| CreditCard.expired(:page => page_number) } end # Returns a PagedCollection of credit cards expiring between +start_date+ and +end_date+ inclusive. # Only the month and year of the start and end dates are used. def self.expiring_between(start_date, end_date, options = {}) page_number = options[:page] || 1 response = Http.get("/payment_methods/all/expiring?page=#{page_number}&start=#{start_date.strftime('%m%Y')}&end=#{end_date.strftime('%m%Y')}") attributes = response[:payment_methods] attributes[:items] = Util.extract_attribute_as_array(attributes, :credit_card).map do |payment_method_attributes| new payment_method_attributes end PagedCollection.new(attributes) { |page_number| CreditCard.expiring_between(start_date, end_date, :page => page_number) } end # Finds the credit card with the given +token+. Raises a NotFoundError if it cannot be found. def self.find(token) response = Http.get "/payment_methods/#{token}" new(response[:credit_card]) rescue NotFoundError raise NotFoundError, "payment method with token #{token.inspect} not found" end def self.sale(token, transaction_attributes) Transaction.sale(transaction_attributes.merge( :payment_method_token => token )) end def self.sale!(token, transaction_attributes) return_object_or_raise(:transaction) { sale(token, transaction_attributes) } end def self.update(token, attributes) Util.verify_keys(_update_signature, attributes) _do_update(:put, "/payment_methods/#{token}", :credit_card => attributes) end def self.update!(token, attributes) return_object_or_raise(:credit_card) { update(token, attributes) } end def self.update_from_transparent_redirect(query_string) params = TransparentRedirect.parse_and_validate_query_string query_string _do_update(:post, "/payment_methods/all/confirm_transparent_redirect_request", :id => params[:id]) end # The transparent redirect URL to use to update a credit card. def self.update_credit_card_url "#{Braintree::Configuration.base_merchant_url}/payment_methods/all/update_via_transparent_redirect_request" end def initialize(attributes) # :nodoc: _init attributes end # Creates a credit transaction for this credit card. def credit(transaction_attributes) Transaction.credit(transaction_attributes.merge( :payment_method_token => self.token )) end def credit!(transaction_attributes) return_object_or_raise(:transaction) { credit(transaction_attributes) } end def delete Http.delete("/payment_methods/#{token}") end # Returns true if this credit card is the customer's default. def default? @default end # Expiration date formatted as MM/YYYY def expiration_date "#{expiration_month}/#{expiration_year}" end # Returns true if the credit card is expired. def expired? if expiration_year.to_i == Time.now.year return expiration_month.to_i < Time.now.month end expiration_year.to_i < Time.now.year 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 # Creates a sale transaction for this credit card. def sale(transaction_attributes) CreditCard.sale(self.token, transaction_attributes) end def sale!(transaction_attributes) return_object_or_raise(:transaction) { sale(transaction_attributes) } end def update(attributes) Util.verify_keys(self.class._update_signature, attributes) response = Http.put "/payment_methods/#{token}", :credit_card => attributes if response[:credit_card] _init response[:credit_card] SuccessfulResult.new(:credit_card => self) elsif response[:api_error_response] ErrorResult.new(response[:api_error_response]) else raise UnexpectedError, "expected :credit_card or :api_error_response" end end def update!(attributes) return_object_or_raise(:credit_card) { update(attributes) } end # Returns true if +other+ is a +CreditCard+ with the same token. def ==(other) return false unless other.is_a?(CreditCard) token == other.token end class << self protected :new end def self._attributes # :nodoc: [ :billing_address, :bin, :card_type, :cardholder_name, :created_at, :customer_id, :expiration_month, :expiration_year, :last_4, :token, :updated_at ] end def self._create_signature # :nodoc: [ :customer_id, :cardholder_name, :cvv, :number, :expiration_date, :token, {:options => [:verify_card]}, {:billing_address => [:first_name, :last_name, :company, :country_name, :extended_address, :locality, :region, :postal_code, :street_address]} ] end def self._new(*args) # :nodoc: self.new *args end def self._do_create(url, params) # :nodoc: response = Http.post url, params if response[:credit_card] SuccessfulResult.new(:credit_card => new(response[:credit_card])) elsif response[:api_error_response] ErrorResult.new(response[:api_error_response]) else raise UnexpectedError, "expected :credit_card or :api_error_response" end end def self._do_update(http_verb, url, params) # :nodoc: response = Http.send http_verb, url, params if response[:credit_card] SuccessfulResult.new(:credit_card => new(response[:credit_card])) elsif response[:api_error_response] ErrorResult.new(response[:api_error_response]) else raise UnexpectedError, "expected :credit_card or :api_error_response" end end def self._update_signature # :nodoc: [ :cardholder_name, :cvv, :number, :expiration_date, :token, {:options => [:verify_card]}, {:billing_address => [:first_name, :last_name, :company, :country_name, :extended_address, :locality, :region, :postal_code, :street_address]} ] end def _init(attributes) # :nodoc: set_instance_variables_from_hash(attributes) @billing_address = attributes[:billing_address] ? Address._new(attributes[:billing_address]) : nil end end end