poundpay 0.2.2 → 0.2.3

data/README.rdoc

@@ -7,16 +7,13 @@ Poundpay is a payments platform for marketplaces
 
 1. Add the following to your Gemfile
 
-    gem 'poundpay', '~> 0.2.1'
+    gem 'poundpay', '~> 0.2.3'
 
 2. At the command prompt, install the gem with bundler
 
     bundle install
 
-3. Create the file config/poundpay.yml and add your configurations
-
-Note: Make sure your YAML file ends with a blank line; otherwise, Ruby
-will give you a completely unintelligible error message
+3. Create the file config/poundpay.yml and add your configurations. Note: Make sure your YAML file ends with a blank line; otherwise, Ruby will give you a completely unintelligible error message
 
     development:
       developer_sid: DV0383d447360511e0bbac00264a09ff3c
@@ -38,47 +35,55 @@ will give you a completely unintelligible error message
 
 
 == Creating a payment
-Adding the payer_sid (from a previous payment), will cause the payer to see
-the repeat flow when they are not prompted to reenter their credit card information
 
-    @payment = Poundpay::Payment.create(
-      :amount                  => 20000,
-      :payer_fee_amount        => 0,
-      :payer_email_address     => "fred@example.com",
-      :payer_sid               => "97f51e5c38e211e08625e7af17bae06a",  # Optional
-      :recipient_fee_amount    => 500,
-      :recipient_email_address => "david@example.com",
-      :description             => "Beats by Dr. Dre",
-    )
+  @payment = Poundpay::Payment.create(
+    :amount                  => 20000,
+    :payer_fee_amount        => 0,
+    :payer_email_address     => "fred@example.com",
+    :recipient_fee_amount    => 500,
+    :recipient_email_address => "david@example.com",
+    :description             => "Beats by Dr. Dre")
 
 
 == Serving IFRAME
 
-    <script src="https://www.poundpay.com/js/poundpay.js"></script>
+  <script src="https://www.poundpay.com/js/poundpay.js"></script>
 
-    <div id="pound-root"></div>
+  <div id="pound-root"></div>
 
-    <script>
-      function handlePaymentSuccess() {
-        // do something
-      }
+  <script>
+    function handlePaymentSuccess() {
+      // do something
+    }
 
-      function handlePaymentError() {
-        // handle error
-      }
+    function handlePaymentError() {
+      // handle error
+    }
 
-      PoundPay.init({
-        payment_sid: <%= @payment.sid %>,
-        success: handlePaymentSuccess,
-        error: handlePaymentError,
-        cardholder_name: "Fred Nietzsche", // Optional
-        phone_number: "4085551234", // Optional
-        server: "#{Poundpay.www_url}"
-      });
-    </script>
+    PoundPay.init({
+      payment_sid: "<%= @payment.sid %>",
+      success: handlePaymentSuccess,
+      error: handlePaymentError,
+      cardholder_name: "Fred Nietzsche", // Optional
+      server: "<%= Poundpay.www_url %>"
+    });
+  </script>
 
 
 == Releasing a payment
 
-    payment = Payment.find(payment_sid)
-    payment.release
+  payment = Poundpay::Payment.find(payment_sid)
+  payment.release
+
+
+== Cancel a payment
+
+  payment = Poundpay::Payment.find(payment_sid)
+  payment.cancel
+
+
+== Setting callback url
+
+  me = Poundpay::Developer.me
+  me.callback_url = "http://awesomemarketplace.com/poundpay/callback"
+  me.save!

data/lib/poundpay/elements.rb

@@ -5,6 +5,9 @@ require 'poundpay/resource'
 class PaymentReleaseException < Exception
 end
 
+class PaymentCancelException < Exception
+end
+
 module Poundpay
   class Developer < Resource
     def self.me
@@ -41,5 +44,14 @@ module Poundpay
       attributes['status'] = 'RELEASED'
       save
     end
+
+    def cancel
+      unless status == 'ESCROWED'
+        raise PaymentCancelException.new "Payment status is #{status}.  Only ESCROWED payments may be canceled"
+      end
+
+      attributes['status'] = 'CANCELED'
+      save
+    end
   end
 end

data/lib/poundpay/version.rb

@@ -1,3 +1,3 @@
 module Poundpay
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

data/spec/fixtures/payments.rb

@@ -33,5 +33,11 @@ module Poundpay
       @attributes["status"] = "RELEASED"
       @attributes
     end
+
+    def canceled_payment_attributes
+      @attributes = staged_payment_attributes
+      @attributes["status"] = "CANCELED"
+      @attributes
+    end
   end
 end

data/spec/poundpay/elements_spec.rb

@@ -80,4 +80,19 @@ describe Payment do
       @escrowed_payment.status.should == 'RELEASED'
     end
   end
+
+  describe "#cancel" do
+    it "should not be able to cancel a STAGED payment" do
+      @staged_payment = Payment.new staged_payment_attributes
+      expect {@staged_payment.cancel}.to raise_error(PaymentCancelException)
+    end
+
+    it "should release an ESCROWED payment" do
+      @escrowed_payment = Payment.new escrowed_payment_attributes
+      @escrowed_payment.should_receive(:save).and_return(Payment.new canceled_payment_attributes)
+
+      @escrowed_payment.cancel
+      @escrowed_payment.status.should == 'CANCELED'
+    end
+  end
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 2
-  - 2
-  version: 0.2.2
+  - 3
+  version: 0.2.3
 platform: ruby
 authors: 
 - Matin Tamizi
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-20 00:00:00 -08:00
+date: 2011-03-31 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency