rails-paypal-gem 0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MzUzODUzODRiNmIzYmNhZWE2NmZhZWE4ODZmZTY3NjNlMzA0NTg2YQ==
+  data.tar.gz: !binary |-
+    ODZhZjY2YmMzZGRkNTVlZTIxYzg5ZDRiYjNkNjRkMTMxMTRlMDUwZA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    YTQzODYzM2JkYzY0ZjgzZWI1M2UwMTYxZDZkOGY0YzI4Y2E5ZTllYmIyMzlj
+    NGFhYTczMWRkNWQ1ZWUxODIyZmVmMTc4MmJmNDQzYWZmOWMyM2VkNTIyNTc1
+    NGU3ZDk3YmYxMmRlMGY2YTAzZDFlOGYzYjUxNzJjYmIxMzM0MDc=
+  data.tar.gz: !binary |-
+    YTE3NzRhNzUwNzliYWJlYTY5OWRjMzczODMzZDFlNTg2NzI2YmQ2NGNkZTYw
+    YzNmYWFjZGVjZThlODNjNTlkMjJiZGM1ODQ1NmVjYTVhNWFmOTZkYzRiMDc3
+    Y2I4ZjQ5ZWUwMjkwMmIxMGM1M2RhNzFjNDU0MTJlOTYwNmYwMjE=

data/README.md

@@ -0,0 +1,86 @@
+rails-paypal
+============
+
+A simple paypal client for *rails lovers* and *paypal haters*!
+
+
+Install
+-------
+Since this is pre-alpha right now, I did not updage the builded gem, so just add it your Gemfile and point to github here.
+
+    gem 'rails-paypal', :git => 'git://github.com/aliciatang/rails-paypal.git'
+    bundle update
+
+Call Paypal
+-----------
+Make a call the paypal endpoint with what every parameters you need.
+
+    RailsPaypal.call({ :METHOD => 'SetExpressCheckout', :PAYMENTREQUEST_0_AMT=>'300.0'})
+
+The above call will return
+
+    {"TOKEN"=>"EC-41U99669P1884934P", "TIMESTAMP"=>"2012-09-03T04:59:14Z", "CORRELATIONID"=>"5d061f72f2cd4", "ACK"=>"Success", "VERSION"=>"92.0", "BUILD"=>"3622349"}
+
+Express Checkout
+----------------
+I am working on express checkout now. Due the urgliness of paypay documentations, I will try to write a little bit more and summarize them.
+
+Step One: get token
+
+     # create the express checkout service instance with a list of line-item details
+     ec =  RailsPaypal::ExpressCheckout.new([{:name=>'item 1',:price=>'5.0',:quantity=> 4, :description => "This is optional"}])
+     # call paypal for a toke
+     ec.set
+
+Step Two: rediret the end user to paypal
+     
+     # you can call this directly without calling set first since it will check for the token
+     # But you do need to pass the list of line items to the construtor, since we need to call paypal for the token
+     ec.redirect_url
+
+Step Tree: hope your user finish the payment on paypal site.
+
+If they do, they will be redirected to the return_url you specified in step one with two parameters: token and PayerID
+
+    your_return_url/?token=EC-3EC18176EP034311U&PayerID=TPCS2TXJU979S
+
+In the controller for the above url, now is the time for you to capture the $$. That's all it is about, isn't it?
+
+    ec.do
+    # or use the static method
+    RailsPaypal::ExpressCheckout.do("YOURTOKEN","TPCS2TXJU979S","20.00")
+    
+
+Step Four: There is no step 4! How nice is that!
+
+----------
+Hand on there, you cautch me! Yes, in step 3 I have an if condition but no else. Which is pretty bad!
+If you only care about the case you got the money, there is nothing you need to do. 
+No action is not a bad action to take.
+In case you do wanna be noticed when the user abandon the cart or at lease log it. There another url you passed to paypay in step 1 when setting up express checkout.
+And we could do something about it.
+
+A little bit more accurate.
+Verify payment info by calling the get method to get what the actual amount was paid.
+And of course you can get invoice id you specified in step one as well so you know which order you should mark as paid and deliver just in case you did not pass the order id in the return_url already.
+
+    ec.get
+    # or use the static method
+    RailsPaypal::ExpressCheckout.get("YOURTOKEN")
+
+
+#  TODO move thise to a config file
+  URLS = {
+    :sandbox => 'https://api-3t.sandbox.paypal.com/nvp',
+    :production =>'https://api-3t.paypal.com/nvp',
+    :checkout => 'https://www.sandbox.paypal.com/cgi-bin/webscr'
+  }
+  # wish httparty have something similar for default_params for body data
+  PARAMS = {:USER      => 'alicia_1345427347_biz_api1.gmail.com' ,
+            :PWD       => '1345427370',
+            :SIGNATURE => 'AndYn9Gde1bznDG3gf7QHBhnXR5-A4Xl8tLjtE.ZHgc49RBCg5Yo4RhN',
+            :VERSION   => '92.0', # this is the latest version as of Sep 2nd, 2012
+            :RETURNURL => 'http://return.com',
+            :CANCELURL => 'http://cancel.com'
+  }
+

data/lib/rails-paypal.rb

@@ -0,0 +1,22 @@
+require 'httparty'
+require 'rails-paypal/nvp-parser'
+class RailsPaypal
+  include HTTParty
+  if Rails.env == "development"
+    base_uri "https://api-3t.sandbox.paypal.com/nvp"
+  else
+    base_uri "https://api-3t.paypal.com/nvp"
+  end
+  # custom parser must be signed before set the format
+  parser NvpParsingIncluded
+  # the response format
+  format :nvp
+  #  debug_output # turn on httparty debuy
+  #  default_timeout 100
+
+  def self.call(data)
+    ret = post('/', :body => PARAMS.merge(data))
+    ret.parsed_response
+  end
+end
+require 'services/express_checkout'

data/lib/rails-paypal/nvp-parser.rb

@@ -0,0 +1,12 @@
+# parse nave value pair
+require 'uri'
+require 'httparty/parser'
+class NvpParsingIncluded < HTTParty::Parser
+    SupportedFormats.merge!({"text/plain" => :nvp})
+    protected
+    # perform atom parsing on body
+    def nvp
+      ret = body.split('&').map { |e| e.split('=').map { |v| URI::decode v  }  }
+      Hash[*ret.flatten]
+    end
+end

data/lib/rails-paypal/version.rb

@@ -0,0 +1,3 @@
+module RailsPaypal
+  VERSION = '0.1'
+end

data/lib/services/express_checkout.rb

@@ -0,0 +1,50 @@
+class RailsPaypal::ExpressCheckout < RailsPaypal
+  attr_accessor :params
+  attr_accessor :token
+  attr_accessor :line_items
+
+  def initialize(line_items)
+    self.line_items = line_items
+    self.params = {}
+    total = 0.0
+    line_items.each_with_index do |li, i|
+      self.params["L_PAYMENTREQUEST_0_NAME#{i}"] = li[:name] if li.has_key?(:name)
+      self.params["L_PAYMENTREQUEST_0_QTY#{i}"] = li[:quantity] if li.has_key?(:quantity)
+      self.params["L_PAYMENTREQUEST_0_AMT#{i}"] = li[:price]
+      self.params["L_PAYMENTREQUEST_0_DESC#{i}"] = li[:description] if li.has_key?(:description)
+      total += (li[:price].to_f * li[:quantity].to_i)
+    end
+    params["PAYMENTREQUEST_0_AMT"] = total.to_s
+  end
+
+  def set(action = 'Sale')
+    self.params["PAYMENTREQUEST_0_CURRENCYCODE"] = "EUR"
+    self.params["PAYMENTREQUEST_0_PAYMENTACTION"] = action
+    self.params["METHOD"] = 'SetExpressCheckout'
+    response = self.class.call(self.params)
+    if response["ACK"] == 'Success'
+      self.token = response["TOKEN"]
+    else
+      raise response["L_ERRORCODE0"]+":"+response["L_LONGMESSAGE0"]
+    end
+  end
+
+  def get
+    set if self.token.nil?
+    self.class.get(self.token)
+  end
+
+  def redirect_url
+    set if self.token.nil?
+    if Rails.env == "development"
+      "https://www.sandbox.paypal.com/webscr?cmd=_express-checkout&token=" + self.token
+    elsif Rails.env == "production"
+      "https://www.paypal.com/webscr?cmd=_express-checkout&token=" + self.token
+    end
+  end
+
+  def self.get(token)
+    call({"TOKEN" => token, "METHOD" => "GetExpressCheckoutDetails"})
+  end
+
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: rails-paypal-gem
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Jan Jezek
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A simple paypal client for rails lovers and paypal haters!
+email: mail@mediatainment-productions.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/rails-paypal/nvp-parser.rb
+- lib/rails-paypal/version.rb
+- lib/rails-paypal.rb
+- lib/services/express_checkout.rb
+- README.md
+homepage: https://github.com/mediatainment/rails-paypal
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Paypal for rails
+test_files: []
+has_rdoc: