spreedly-core-ruby 0.1.4 → 0.1.5

data/README.md

@@ -209,7 +209,7 @@ For this example, I will be using an Authorize.net account that only has a login
     
     puts "Authorize.net gateway token is #{gateway.token}"
     
-For most users, you will start off using only one gateway token, and as such can configure it as an environment variable to hold your gateway token. In addition to the previous environment variables, the SpreedlyCore.configure method will also look for a SPREEDLYCORE_GATEWAY_TOKEN environment value.
+For most users, you will start off using only one gateway token, and as such can configure it as an environment variable to hold your gateway token. In addition to the previous environment variables, the `SpreedlyCore.configure` method will also look for a SPREEDLYCORE_GATEWAY_TOKEN environment value.
 
 	# create an initializer at config/initializers/spreedly_core.rb
     # values already set for ENV['SPREEDLYCORE_API_LOGIN'], ENV['SPREEDLYCORE_API_SECRET'], and ENV['SPREEDLYCORE_GATEWAY_TOKEN']
@@ -237,23 +237,35 @@ For those using multiple gateway tokens, there is a class variable that holds th
     
 Creating Payment Types Programatically
 ------------
-For those using multiple gateway tokens, there is a class variable that holds the active gateway token. Before running any sort of transaction against a payment method, you'll need to set the gateway token that you wish to charge against.
+**Please note that this practice requires you to be PCI compliant!**
 
-    SpreedlyCore.configure
-    
-    SpreedlyCore.gateway_token(paypal_gateway_token)
-    SpreedlyCore::PaymentMethod.find(pm_token).purchase(550)
-    
-    SpreedlyCore.gateway_token(authorize_gateway_token)
-    SpreedlyCore::PaymentMethod.find(pm_token).purchase(2885)
-    
-    SpreedlyCore.gateway_token(braintree_gateway_token)
-    SpreedlyCore::PaymentMethod.find(pm_token).credit(150)
+In special cases, you may want to create payment types programmatically and will not be using the transparent redirect functionality. This can be done using the `SpreedlyCore::PaymentMethod.create` method, and will behave as follows:
+
+* Card validation is done in realtime, and a 422 Unprocessable will be returned if validation fails.
+* Successful execution will return an AddPaymentMethodTransaction object (*not* a PaymentMethod object). Adding a payment method is wrapped in a transaction much like doing a purchase or authorize request is. The returned object will have the PaymentMethod object as a child.
+* You still need to manually call `retain` on the payment method if you wish to retain the card.
+
+The example below illustrates both a successful payment method creation, and how to handle one with errors.
+
+	SpreedlyCore.configure
+	
+	pm_transaction = SpreedlyCore::PaymentMethod.create(:credit_card => good_card_hash)
+	pm_token = pm_transaction.payment_method.token
+	puts "Payment method token is #{pm_token}"
+	
+	retain_transaction = pm_transaction.payment_method.retain
+	retain_transaction.succeeded? # true
+	
+	begin
+      pm_transaction = SpreedlyCore::PaymentMethod.create(:credit_card => bad_card_hash)
+    rescue Exception => e
+      puts "Errors when submitting the card: #{e.errors.join(",")}"
+    end
 
 Contributing
 ------------
 1. [Fork](http://help.github.com/forking/) spreedly-core-ruby
-2. Create a topic branch - `git checkout -b my_branch
+2. Create a topic branch - `git checkout -b my_branch`
 3. Make your changes on your topic branch.
 4. DO NOT bump the version number, or put it in a separate commit that I can ignore.
 3. Push to your branch - `git push origin my_branch`

data/lib/spreedly-core-ruby.rb

@@ -32,8 +32,12 @@ module SpreedlyCore
   end
 
   class UnprocessableRequest < Error
+    attr_accessor :errors
+
     def initialize(errors)
       errors = [errors] unless errors.is_a?(Array)
+      @errors = errors
+      
       super(errors.join("\n"))
     end
   end

data/lib/spreedly-core-ruby/version.rb

@@ -1,4 +1,4 @@
 module SpreedlyCore
-  Version = VERSION = "0.1.4"
+  Version = VERSION = "0.1.5"
   ApiVersion = API_VERSION = "v1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spreedly-core-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
   prerelease: 
 platform: ruby
 authors:
@@ -14,7 +14,7 @@ date: 2012-03-21 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
-  requirement: &70226775420580 !ruby/object:Gem::Requirement
+  requirement: &70270991883080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -22,10 +22,10 @@ dependencies:
         version: 0.7.7
   type: :runtime
   prerelease: false
-  version_requirements: *70226775420580
+  version_requirements: *70270991883080
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &70226775420040 !ruby/object:Gem::Requirement
+  requirement: &70270991882520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +33,10 @@ dependencies:
         version: 3.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *70226775420040
+  version_requirements: *70270991882520
 - !ruby/object:Gem::Dependency
   name: builder
-  requirement: &70226775419660 !ruby/object:Gem::Requirement
+  requirement: &70270991882080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -44,10 +44,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70226775419660
+  version_requirements: *70270991882080
 - !ruby/object:Gem::Dependency
   name: ruby-debug19
-  requirement: &70226775419000 !ruby/object:Gem::Requirement
+  requirement: &70270991881440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,10 +55,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70226775419000
+  version_requirements: *70270991881440
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70226775418400 !ruby/object:Gem::Requirement
+  requirement: &70270991880840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -66,10 +66,10 @@ dependencies:
         version: 0.8.7
   type: :development
   prerelease: false
-  version_requirements: *70226775418400
+  version_requirements: *70270991880840
 - !ruby/object:Gem::Dependency
   name: webmock
-  requirement: &70226775417800 !ruby/object:Gem::Requirement
+  requirement: &70270991880280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -77,7 +77,7 @@ dependencies:
         version: 1.6.2
   type: :development
   prerelease: false
-  version_requirements: *70226775417800
+  version_requirements: *70270991880280
 description: Spreedly Core is a cloud service that allows you to store credit cards
   and run transactions against them, enabling you to accept payments on your website
   while avoiding all liability and PCI compliance requirements.