fat_zebra 1.1.0 → 1.1.3

data/README.markdown

@@ -1,7 +1,7 @@
 Ruby API Library for Fat Zebra
 ==============================
 
-Release 1.0.0 for API version 1.0
+Release 1.1.3 for API version 1.0
 
 A Ruby client for the [Fat Zebra](https://www.fatzebra.com.au) Online Payment Gateway (for Australian Merchants)
 

data/lib/fat_zebra/gateway.rb

@@ -31,18 +31,36 @@ module FatZebra
 		# cvv - the credit card verification value (cvv, cav, csc etc)
 		# reference - a reference for the purchase
 		# customer_ip - the customers IP address (for fraud prevention)
+		# currency - the currency of the transaction, ISO 4217 code (http://en.wikipedia.org/wiki/ISO_4217)
 		#
 		# Returns a new FatZebra::Models::Response (purchase) object
-		def purchase(amount, card_data, reference, customer_ip)
+		def purchase(amount, card_data, reference, customer_ip, currency = "AUD")
+		
+			if card_data.keys.include?(:token)
+				warn "[DEPRECATED] please use {:card_token => \".....\"} instead of {:token => \".....\"}"
+				card_data[:card_token] ||= card_data.delete(:token)
+			end
+
+			if card_data.keys.include?(:number)
+				warn "[DEPRECATED] please use :card_number instead of :number"
+				card_data[:card_number] ||= card_data.delete(:number)
+			end
+
+			if card_data.keys.include?(:expiry)
+				warn "[DEPRECATED] please use :card_expiry instead of :expiry"
+				card_data[:card_expiry] ||= card_data.delete(:expiry)
+			end
+
 			params = {
 				:amount => amount,
 				:card_holder => card_data.delete(:card_holder),
-				:card_number => card_data.delete(:number),
-				:card_expiry => extract_date(card_data.delete(:expiry)),
+				:card_number => card_data.delete(:card_number),
+				:card_expiry => extract_date(card_data.delete(:card_expiry)),
 				:cvv => card_data.delete(:cvv),
-				:card_token => card_data.delete(:token),
+				:card_token => card_data.delete(:card_token),
 				:reference => reference,
-				:customer_ip => customer_ip
+				:customer_ip => customer_ip,
+				:currency => currency
 			}
 
 			params.delete_if {|key, value| value.nil? } # If token is nil, remove, otherwise, remove card values
@@ -173,6 +191,34 @@ module FatZebra
 			FatZebra::Models::Response.new(response, :card)
 		end
 
+		# Public: Fetch a previously tokenized card
+		#
+		# token - the card token
+		#
+		# Returns FatZebra::Models::Response (Card)
+		def tokenized_card(token)
+			response = make_request(:get, "credit_cards/#{token}.json")
+			FatZebra::Models::Response.new(response, :card)
+		end
+
+		def tokenized_cards
+			records = []
+			options = {:offets => 0, :limit => 10}
+
+			# Format dates for the request
+			options[:from] = options[:from].strftime("%Y%m%dT%H%M") if options[:from]
+			options[:to] = options[:to].strftime("%Y%m%dT%H%M") if options[:to]
+
+			response = make_request(:get, "credit_cards.json", options)
+			if response["successful"]
+				response["response"].each do |record|
+					records << FatZebra::Models::Card.new(record)
+				end
+				records
+			else
+				raise StandardError, "Unable to query credit cards, #{response["errors"].inspect}"
+			end
+		end
 
 		private
 		# Private: Extracts the date value from a Date/DateTime value

data/lib/fat_zebra/models/card.rb

@@ -2,6 +2,32 @@ module FatZebra
 	module Models
 		class Card < Base
 			attribute :token, :card_holder, :card_number, :card_expiry, :transaction_count, :raw
-		end
-	end
+
+      def charge!()
+
+      end
+
+      class << self
+        # Tokenizes a credit card
+        # 
+        # @param [String] the credit card holder name
+        # @param [String] the card number
+        # @param [String] the credit card expiry date (mm/yyyy)
+        # @param [String] the card CVV
+        #
+        # @return Response
+        def create(card_holder, card_number, expiry, cvv)
+          params = {
+            :card_holder => card_holder,
+            :card_number => card_number,
+            :card_expiry => expiry,
+            :cvv => cvv
+          }
+
+          response = FatZebra.gateway.make_request(:post, "credit_cards", params)
+          Response.new(response, :card)
+        end
+      end
+  	end
+  end
 end

data/lib/fat_zebra/models/purchase.rb

@@ -2,7 +2,18 @@ module FatZebra
 	module Models
 		class Purchase < Base
 			attribute :id, :amount, :reference, :message, :authorization, :transaction_id, :card_number,
-					  :card_holder, :card_expiry, :authorized, :successful, :card_token, :raw
+					  :card_holder, :card_expiry, :authorized, :successful, :card_token, :raw, :currency
+
+      def approved?
+        self.successful
+      end
+
+      def card_type
+        cards = []
+        cards[4] = "VISA"
+        cards[5] = "MasterCard"
+        cards[3] = "AMEX/JCB"
+      end
 		end
 	end
 end

data/lib/fat_zebra/version.rb

@@ -1,3 +1,3 @@
 module FatZebra
-  VERSION = "1.1.0"
+  VERSION = "1.1.3"
 end

data/spec/gateway_spec.rb

@@ -24,39 +24,39 @@ describe FatZebra::Gateway do
 	end
 
 	it "should perform a purchase" do
-		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, "TEST#{rand}", "1.2.3.4")
+		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :card_number => "5555555555554444", :card_expiry => "05/2013", :cvv => 123}, "TEST#{rand}", "1.2.3.4")
 		result.should be_successful
 		result.errors.should be_empty
 	end
 
 	it "should fetch a purchase" do
-		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, "TES#{rand}T", "1.2.3.4")
+		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :card_number => "5555555555554444", :card_expiry => "05/2013", :cvv => 123}, "TES#{rand}T", "1.2.3.4")
 		purchase = @gw.purchases(:id => result.purchase.id)
 		purchase.id.should == result.purchase.id
 	end
 
 	it "should fetch a purchase via reference" do
 		ref = "TES#{rand}T"
-		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, ref, "1.2.3.4")
+		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :card_number => "5555555555554444", :card_expiry => "05/2013", :cvv => 123}, ref, "1.2.3.4")
 
 		purchases = @gw.purchases(:reference => ref)
 		purchases.id.should == result.purchase.id
 	end
 
-	it "should fetch purchases within a date range" do
-		start = Time.now
-		5.times do |i|
-			@gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, "TEST#{rand(1000)}-#{i}", "1.2.3.4")
-		end
+	# it "should fetch purchases within a date range" do
+	# 	start = Time.now
+	# 	5.times do |i|
+	# 		@gw.purchase(10000, {:card_holder => "Matthew Savage", :card_number => "5555555555554444", :card_expiry => "05/2013", :cvv => 123}, "TEST#{rand(1000)}-#{i}", "1.2.3.4")
+	# 	end
 
-		purchases = @gw.purchases(:from => start - 300, :to => Time.now + 300)
-		purchases.count.should >= 5
-	end
+	# 	purchases = @gw.purchases(:from => start - 300, :to => Time.now + 300)
+	# 	purchases.count.should >= 5
+	# end
 
 	it "should fetch purchases with a from date" do
 		start = Time.now
 		5.times do |i|
-			@gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, "TEST#{rand(1000)}-#{i}", "1.2.3.4")
+			@gw.purchase(10000, {:card_holder => "Matthew Savage", :card_number => "5555555555554444", :card_expiry => "05/2013", :cvv => 123}, "TEST#{rand(1000)}-#{i}", "1.2.3.4")
 		end
 
 		purchases = @gw.purchases(:from => start)
@@ -64,7 +64,7 @@ describe FatZebra::Gateway do
 	end
 
 	it "should refund a transaction" do
-		purchase = @gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, "TES#{rand}T", "1.2.3.4")
+		purchase = @gw.purchase(10000, {:card_holder => "Matthew Savage", :card_number => "5555555555554444", :card_expiry => "05/2013", :cvv => 123}, "TES#{rand}T", "1.2.3.4")
 		result = @gw.refund(purchase.result.id, 100, "REFUND-#{purchase.result.id}")
 
 		result.should be_successful
@@ -76,4 +76,27 @@ describe FatZebra::Gateway do
 		response.should be_successful
 		response.result.token.should_not be_nil
 	end
+
+	it "should fetch a tokenized card" do
+		token = @gw.tokenize("M Smith", "5123456789012346", "05/2013", "123").result.token
+		card_response = @gw.tokenized_card(token)
+
+		card_response.should be_successful
+		card_response.result.token.should == token
+		card_response.result.card_number.should == "512345XXXXXX2346"
+	end
+
+	it "should fetch all cards" do
+		cards = @gw.tokenized_cards
+
+		cards.first.should be_instance_of(FatZebra::Models::Card)
+	end
+
+	it "should perform a purchase with a tokenized card" do
+		token = @gw.tokenize("M Smith", "5123456789012346", "05/2013", "123").result.token
+		purchase = @gw.purchase(10000, {:card_token => token}, "TEST#{rand}}", "127.0.0.1")
+
+		purchase.should be_successful
+		purchase.result.successful.should be_true
+	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fat_zebra
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-27 00:00:00.000000000 Z
+date: 2013-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70289032097440 !ruby/object:Gem::Requirement
+  requirement: &70319775786820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70289032097440
+  version_requirements: *70319775786820
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70289032096820 !ruby/object:Gem::Requirement
+  requirement: &70319775828120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70289032096820
+  version_requirements: *70319775828120
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70289032095980 !ruby/object:Gem::Requirement
+  requirement: &70319775827160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70289032095980
+  version_requirements: *70319775827160
 - !ruby/object:Gem::Dependency
   name: yard-tomdoc
-  requirement: &70289032095080 !ruby/object:Gem::Requirement
+  requirement: &70319775826140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70289032095080
+  version_requirements: *70319775826140
 - !ruby/object:Gem::Dependency
   name: ZenTest
-  requirement: &70289032094060 !ruby/object:Gem::Requirement
+  requirement: &70319775824660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70289032094060
+  version_requirements: *70319775824660
 - !ruby/object:Gem::Dependency
   name: rest-client
-  requirement: &70289032093020 !ruby/object:Gem::Requirement
+  requirement: &70319775824080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70289032093020
+  version_requirements: *70319775824080
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70289032092480 !ruby/object:Gem::Requirement
+  requirement: &70319775823500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,7 +87,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70289032092480
+  version_requirements: *70319775823500
 description: Provides integration with the Fat Zebra internet payment gateway (www.fatzebra.com.au),
   including purchase, refund, auth, capture and recurring billing functionality.
 email:
@@ -133,7 +133,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1093919880626549256
+      hash: -2567456050335982654
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -142,10 +142,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1093919880626549256
+      hash: -2567456050335982654
 requirements: []
 rubyforge_project: fat_zebra
-rubygems_version: 1.8.10
+rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
 summary: Fat Zebra payments gem - integrate your ruby app with Fat Zebra