stateless-systems-paypal 2.1.3

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+#--
+# Copyright (c) 2005 Tobias Luetke
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++

data/README

@@ -0,0 +1,151 @@
+== Welcome to Paypal/ruby
+
+This library is here to aid with integrating Paypal payments into ruby on rails 
+applications or similar. To set this up you will need to log into your paypal 
+business account and tell paypal where to send the IPN ( Instant payment notifications ). 
+
+== Download
+
+* Preferred method of installation is using rubygems. gem install paypal --source http://dist.leetsoft.com
+* Alternatively you can get the library packaged at http://dist.leetsoft.com/pkg/
+
+== Requirements
+
+* Ruby 1.8.2 (may work with previous versions) With OpenSSL support compiled in. 
+* Valid paypal business account. 
+* (optional) The money library from http://dist.leetsoft.com/api/money 
+
+== Installation 
+
+1) Install the plugin using ./script/plugin install svn://vault.jadedpixel.com/paypal/trunk/paypal
+
+
+2) Create a paypal_ipn ( or similar ) action like the one in the "Example rails controller" appendix. 
+
+Within the new payment controller you can now create pages from which users can be sent to paypal. You always 
+have to sent users to paypal using a HTTP Post so a standard link won't work (well OK but you need some javascript for that). The +Paypal::Helper+ namespace has some examples of how such a forward page may look. 
+
+== Testing the integration
+
+Under https://developer.paypal.com/ you can signup for a paypal developer account.
+This allows you to set up "sandboxed" accounts which work and act like real accounts 
+with the difference that no money is exchanged. Its a good idea to sign up for a 
+sandbox account to use while the application is running in development mode. 
+
+
+== Example rails controller
+
+    class BackendController < ApplicationController
+
+      # Simplification, please write better code then this...
+      def paypal_ipn
+       notify = Paypal::Notification.new(request.raw_post)
+
+       if notify.acknowledge 
+         order = Order.find(notify.item_id)
+         order.success = (notify.complete? and order.total == notify.amount) ? 'success' : 'failure'
+         order.save
+       end
+
+       render :nothing => true
+      end
+    end
+
+== Example paypal forward page
+
+   <%= paypal_form_tag %>
+     <%= paypal_setup "Item 500", Money.us_dollar(50000), "bob@bigbusiness.com", :notify_url => url_for(:only_path => false, :action => 'paypal_ipn') %>  
+
+     Please press here to pay $500US using paypal. <br/>
+     <%= submit_tag "Go to paypal >>" %>
+
+   </form>
+   
+   or, with the same results, the block version:
+
+   <% paypal_form_tag do %>
+     <%= paypal_setup "Item 500", Money.us_dollar(50000), "bob@bigbusiness.com", :notify_url => url_for(:only_path => false, :action => 'paypal_ipn') %>  
+
+     Please press here to pay $500US using paypal. <br/>
+     <%= submit_tag "Go to paypal >>" %>
+
+   <% end %>
+
+== Using encrypted form data
+
+Paypal supports encrypted form data to prevent tampering by third parties.
+You must have a verified paypal account to use this functionality.
+
+1) Create a private key for yourself
+
+    openssl genrsa -out business_key.pem 1024
+
+2) Create a public certificate to share with Paypal
+
+    openssl req -new -key business_key.pem -x509 -days 3650 -out business_cert.pem
+
+3) Upload the public certificate to Paypal (under Profile -> Encrypted Payment Settings -> Your Public Certificates -> Add),
+and note the "Cert ID" that Paypal shows for the certificate.
+
+4) Update your controller to include the details for your key and certificate.
+
+    @business_key = File::read("business_key.pem")
+    @business_cert = File::read("business_cert.pem")
+    @business_certid = "certid from paypal"
+
+5) Update your views to populate the :business_key, :business_cert and :business_certid options in 'paypal_setup' - the rest of the signature is the same.
+
+6) When you're ready to go live, download the production Paypal certificate and override the default certificate.
+
+    Paypal::Notification.paypal_cert = File::read("paypal_cert.pem")
+
+== Troubleshooting
+
+uninitalized constant Paypal - Make sure your ruby has openssl support
+
+== Changelog
+
+2008-10-16 -- 2.0.2
+    NEW: Added block style support for paypal_form_tag (paypal_form_tag do blah.. blah... end)
+    DEL: Removed patch for 2.0.0, no longer seems suitable.
+    NEW: Added testing for the paypal_form_tag block style.
+    NEW: Added a sample (actual from paypal sandbox) PayPal server response for IPN, to aid in testing.
+
+2008-10-15 -- 2.0.1
+    CHG: Modified README.
+    FIX: Moved patch to own directory, was being caught by git-hub as gem's README
+    NEW: Added patch for currently installed paypal-2.0.0 gem to apply directly on gems directory.
+    NEW: Added relevant test statements.
+    FIX: removed duplicate 'invoice' method in lib/notification.rb
+    NEW: added correct 'custom' method to lib/notification.rb
+    NEW: added pending_reason, reason_code, memo, payment_type, exchange_rate methods to lib/notification.rb
+
+2006-04-20 -- 2.0.0 
+* Uses paypal extended syntax. The plugin can now submit shipping and billing addresses using the paypal_address helper.
+
+2006-04-20 -- 1.7.0 
+* Now a rails plugin
+
+2006-02-10 -- 1.5.1
+* added complete list of valid paypal options (Paul Hart)
+
+2006-02-02 -- 1.5.0
+* Now report an error when invalid option is passed to paypal_setup
+* Had to rename parameters cancel_url to cancel_return and return_url to return, please update your app
+* Improved the test coverage strategy for helper tests
+* Added support for encrypted form data (Paul Hart)
+
+2005-09-16 -- 0.9.6
+* Added readme note about the openssl requirement
+
+2005-07-26 -- 0.9.5
+* Added tax to the helper parameters
+* fixed bug when money class was used to pass in amount. Cents were always 00 (doh!)
+* Added invoice and custom optional parameters
+* Added charset = utf-8 to all paypal posts
+* Wrongly used undefined_quanitity parameter in 0.9.1, this caused users to be prompted for the quanitity on the paypal checkout page... fixed
+
+2005-07-22 -- 0.9.1
+* support for cancel_url as well as notify_url. This means you can now set the IPN callback address from the paypal_setup method and 
+  you don't have to do that in the paypal admin interface!
+* Removed the actual form tag from the paypal_setup generated code to conform better with docs 

data/Rakefile

@@ -0,0 +1,126 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+
+PKG_VERSION = "2.1.3"
+PKG_NAME = "stateless-systems-paypal"
+PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
+
+PKG_FILES = FileList[
+    "lib/**/*", 
+    "test/*", 
+    "misc/*", 
+    "[A-Z]*", 
+    "MIT-LICENSE",
+    "Rakefile"
+].exclude(/\bCVS\b|~$/)
+
+desc "Default Task"
+task :default => [ :test, :test_remote ]
+
+desc "Delete tar.gz / zip / rdoc"
+task :cleanup => [ :rm_packages, :clobber_rdoc ]
+
+# Run the unit tests
+Rake::TestTask.new :test do |t|
+  t.libs << "test"
+  t.pattern = 'test/*_test.rb'
+  t.ruby_opts << '-rubygems'
+  t.verbose = false
+end
+
+Rake::TestTask.new :test_remote do |t|
+  t.libs << "test"
+  t.pattern = 'test/remote/*_test.rb'
+  t.ruby_opts << '-rubygems'
+  t.verbose = false
+end
+
+desc "Create a rubygem and install it. Might need root rights"
+task :install => [:package] do
+  `gem install pkg/#{PKG_FILE_NAME}.gem`
+end
+
+# Genereate the RDoc documentation
+
+Rake::RDocTask.new { |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = "Paypal library"
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+}
+
+task :lines do
+  lines = 0
+  codelines = 0
+  Dir.foreach("lib") { |file_name| 
+    next unless file_name =~ /.*rb/
+
+    f = File.open("lib/" + file_name)
+
+    while line = f.gets
+      lines += 1
+      next if line =~ /^\s*$/
+      next if line =~ /^\s*#/
+      codelines += 1
+    end
+  }
+  puts "Lines #{lines}, LOC #{codelines}"
+end
+
+
+desc "Publish the gem on leetsoft"
+task :publish => [:rdoc, :package] do
+ Rake::SshFilePublisher.new("leetsoft.com", "dist/pkg", "pkg", "#{PKG_FILE_NAME}.zip").upload
+ Rake::SshFilePublisher.new("leetsoft.com", "dist/pkg", "pkg", "#{PKG_FILE_NAME}.tgz").upload
+ Rake::SshFilePublisher.new("leetsoft.com", "dist/gems", "pkg", "#{PKG_FILE_NAME}.gem").upload
+ `ssh tobi@leetsoft.com "mkdir -p dist/api/#{PKG_NAME}"`
+ Rake::SshDirPublisher.new("leetsoft.com", "dist/api/#{PKG_NAME}", "doc").upload
+ `ssh tobi@leetsoft.com './gemupdate'`
+end
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME
+  s.version = PKG_VERSION  
+  s.description = s.summary = "Paypal IPN integration library for rails and other web applications"
+  s.has_rdoc = true
+
+  s.files = %w(init.rb README Rakefile MIT-LICENSE) + Dir['lib/**/*'] + Dir['misc/**/*'] + Dir['test/**/*']
+  s.files.reject! { |f| /\/\.\_/ }
+  s.require_path = 'lib'
+  s.autorequire  = 'paypal'
+  s.author = "Tobias Luetke"
+  s.email = "tobi@leetsoft.com"
+  s.homepage = "http://dist.leetsoft.com/api/paypal"  
+  
+  s.add_dependency('money')
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+
+# --- Ruby forge release manager by florian gross -------------------------------------------------
+
+RUBY_FORGE_PROJECT = 'paypal'
+RUBY_FORGE_USER = 'xal'
+RELEASE_NAME  = "REL #{PKG_VERSION}"
+
+desc "Publish the release files to RubyForge."
+task :release => [:publish] do
+  `rubyforge login`
+  release_command = "rubyforge add_release #{PKG_NAME} #{PKG_NAME} 'REL #{PKG_VERSION}' pkg/#{PKG_NAME}-#{PKG_VERSION}.gem"
+  puts release_command
+  system(release_command)
+
+  release_command = "rubyforge add_release #{PKG_NAME} #{PKG_NAME} 'REL #{PKG_VERSION}' pkg/#{PKG_NAME}-#{PKG_VERSION}.zip"
+  puts release_command
+  system(release_command)
+
+end

data/init.rb

@@ -0,0 +1,29 @@
+#--
+# Copyright (c) 2005 Tobias Luetke
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+
+
+# Please note: Paypal is by default in *production* mode. 
+# During development you will want to add 
+#
+
+ActionView::Base.send(:include, Paypal::Helpers)

data/lib/helper.rb

@@ -0,0 +1,315 @@
+module Paypal 
+  # This is a collection of helpers which aid in the creation of paypal buttons 
+  # 
+  # Example:
+  #
+  #    <%= form_tag Paypal::Notification.ipn_url %>
+  #    
+  #      <%= paypal_setup "Item 500", Money.us_dollar(50000), "bob@bigbusiness.com" %>  
+  #      Please press here to pay $500US using paypal. <%= submit_tag %>
+  #    
+  #    <% end_form_tag %> 
+  #
+  # For this to work you have to include these methods as helpers in your rails application.
+  # One way is to add "include Paypal::Helpers" in your application_helper.rb
+  # See Paypal::Notification for information on how to catch payment events. 
+  module Helpers
+    
+    # Convenience helper. Can replace <%= form_tag Paypal::Notification.ipn_url %>
+    # takes optional url parameter, default is Paypal::Notification.ipn_url
+    def paypal_form_tag(url = Paypal::Notification.ipn_url, options = {})
+      form_tag(url, options)
+    end
+
+    def paypal_form_tag(url = Paypal::Notification.ipn_url, options = {}, &block)
+      if block
+        concat(form_tag(url, options)+capture(&block)+"</form>", block.binding)
+      else
+        form_tag(url, options)
+      end
+    end
+
+    # This helper creates the hidden form data which is needed for a paypal purchase. 
+    # 
+    # * <tt>item_number</tt> -- The first parameter is the item number. This is for your personal organization and can 
+    #   be arbitrary. Paypal will sent the item number back with the IPN so its a great place to 
+    #   store a user ID or a order ID or something like  this. 
+    #
+    # * <tt>amount</tt> -- should be a parameter of type Money ( see http://leetsoft.com/api/money ) but can also 
+    #   be a string of type "50.00" for 50$. If you use the string syntax make sure you set the current 
+    #   currency as part of the options hash. The default is USD
+    #
+    # * <tt>business</tt> -- This is your paypal account name ( a email ). This needs to be a valid paypal business account.
+    #
+    # The last parameter is a options hash. You can set or override any Paypal-recognized parameter, including:
+    #
+    # * <tt>:cmd</tt> -- default is '_xclick' or '_xclick-subscriptions' when you use :subscription.
+    # * <tt>:quantity</tt> -- default is '1'.
+    # * <tt>:no_note</tt> -- default is '1'.
+    # * <tt>:item_name</tt> -- default is 'Store purchase'. This is the name of the purchase which will be displayed
+    #   on the paypal page. 
+    # * <tt>:no_shipping</tt> -- default is '1'. By default we tell paypal that no shipping is required. Usually
+    #   the shipping address should be collected in our application, not by paypal. 
+    # * <tt>:currency</tt> -- default is 'USD'. If you provide a Money object, that will automatically override
+    #   the value.
+    # * <tt>:charset</tt> -- default is 'utf-8'.
+    # * <tt>:notify_url</tt> -- If provided paypal will send its IPN notification once a 
+    #   purchase is made, canceled or any other status changes occur.
+    # * <tt>:return</tt> -- If provided paypal will redirect a user back to this url after a 
+    #   successful purchase. Useful for a kind of thankyou page. 
+    # * <tt>:cancel_return</tt> -- If provided paypal will redirect a user back to this url when
+    #   the user cancels the purchase.
+    # * <tt>:tax</tt> -- the tax for the store purchase. Same format as the amount parameter but optional
+    # * <tt>:invoice</tt> -- Unique invoice number. User will never see this. optional
+    # * <tt>:custom</tt> -- Custom field. User will never see this. optional
+    #
+    # Dealing with subscriptions
+    #
+    # * <tt>:subscription</tt> -- Hash containing the subscription options. optional
+    #   * <tt>:period</tt> -- One of :monthly, :yearly, :weekly or :daily
+    #   * <tt>:length</tt> -- How often, based on :period. E.g. 6 :monthly?
+    #   * <tt>:retry</tt> -- Default is false. Boolean for if paypal should retry failed payments.
+    #   * <tt>:recurring</tt> -- Default is false. Boolean for if paypal should recur payment and end of period.
+    #
+    # Generating encrypted form data
+    #
+    # The helper also supports the generation of encrypted button data. Please see the README for more information
+    # on the setup and prerequisite steps for using encrypted forms.
+    #
+    # The following options must all be provided (as strings) to encrypt the data:
+    #
+    # * <tt>:business_key</tt> -- The private key you have generated
+    # * <tt>:business_cert</tt> -- The public certificate you have also uploaded to Paypal
+    # * <tt>:business_certid</tt> -- The certificate ID that Paypal has assigned to your certificate.
+    # 
+    # Examples:
+    #   
+    #   <%= paypal_setup @order.id, Money.us_dollar(50000), "bob@bigbusiness.com" %>  
+    #   <%= paypal_setup @order.id, '50.00', "bob@bigbusiness.com", :currency => 'USD' %>  
+    #   <%= paypal_setup @order.id, '50.00', "bob@bigbusiness.com", :currency => 'USD', :notify_url => url_for(:only_path => false, :action => 'paypal_ipn') %>  
+    #   <%= paypal_setup @order.id, Money.ca_dollar(50000), "bob@bigbusiness.com", :item_name => 'Snowdevil shop purchase', :return_url => paypal_return_url, :cancel_url => paypal_cancel_url, :notify_url => paypal_ipn_url  %>  
+    #   <%= paypal_setup @order.id, Money.ca_dollar(50000), "bob@bigbusiness.com", :item_name => 'Snowdevil shop purchase', :return_url => paypal_return_url, :cancel_url => paypal_cancel_url, :business_key => @business_key, :business_cert => @business_cert, :business_certid => @business_certid  %>  
+    # 
+    def paypal_setup(item_number, amount, business, options = {})
+
+      subscription = options.delete(:subscription)
+
+      misses = (options.keys - valid_setup_options)
+      raise ArgumentError, "Unknown option #{misses.inspect}" if not misses.empty?
+
+      params = {
+        :cmd => subscription ? '_ext-enter' : '_xclick',
+        :redirect_cmd => subscription ? '_xclick-subscriptions' : nil,
+        :quantity => 1,
+        :business => business,
+        :item_number => item_number,
+        :item_name => 'Store purchase',
+        :no_shipping => '1',
+        :no_note => '1',
+        :charset => 'utf-8'
+      }.reject{|k,v| v.nil?}.merge(options)
+
+      params[:currency_code] = amount.currency if amount.respond_to?(:currency)
+      params[:currency_code] = params.delete(:currency) if params[:currency]
+      params[:currency_code] ||= 'USD'
+
+      # We accept both strings and money objects as amount    
+      amount = amount.cents.to_f / 100.0 if amount.respond_to?(:cents)
+      amount = sprintf('%.2f', amount)
+
+      if subscription.nil?
+        params[:amount] = amount
+      else
+        params[:a3]  = amount
+        params[:p3]  = subscription[:length]
+        params[:sra] = subscription[:retry] == true ? 1 : 0
+        params[:src] = subscription[:recurring] == true ? 1 : 0
+        params[:t3]  = case subscription[:period]
+          when :monthly; 'M'
+          when :yearly;  'Y'
+          when :weekly;  'W'
+          when :daily;   'D'
+        end
+      end
+
+      # same for tax
+      tax = params[:tax]
+      unless tax.nil?
+        tax = tax.cents.to_f / 100.0 if tax.respond_to?(:cents)
+        params[:tax] = sprintf("%.2f", tax)
+      end
+
+      # look for encryption parameters, save them outsite the parameter hash.
+      business_key = params.delete(:business_key)
+      business_cert = params.delete(:business_cert)
+      business_certid = params.delete(:business_certid)
+
+      # Build the form 
+      returning button = [] do
+        # Only attempt an encrypted form if we have all the required fields.
+        if business_key and business_cert and business_certid
+          require 'openssl'
+
+          # Convert the key and certificates into OpenSSL-friendly objects.
+          paypal_cert = OpenSSL::X509::Certificate.new(Paypal::Notification.paypal_cert)
+          business_key = OpenSSL::PKey::RSA.new(business_key)
+          business_cert = OpenSSL::X509::Certificate.new(business_cert)
+          # Put the certificate ID back into the parameter hash the way Paypal wants it.
+          params[:cert_id] = business_certid
+
+          # Prepare a string of data for encryption
+          data = ""
+          params.each_pair {|k,v| data << "#{k}=#{v}\n"}
+
+          # Sign the data with our key/certificate pair
+          signed = OpenSSL::PKCS7::sign(business_cert, business_key, data, [], OpenSSL::PKCS7::BINARY)
+          # Encrypt the signed data with Paypal's public certificate.
+          encrypted = OpenSSL::PKCS7::encrypt([paypal_cert], signed.to_der, OpenSSL::Cipher::Cipher::new("DES3"), OpenSSL::PKCS7::BINARY)
+
+          # The command for encrypted forms is always '_s-xclick'; the real command is in the encrypted data.
+          button << tag(:input, :type => 'hidden', :name => 'cmd', :value => "_s-xclick")
+          button << tag(:input, :type => 'hidden', :name => 'encrypted', :value => encrypted)
+        else
+          # Just emit all the parameters that we have as hidden fields.
+          # Note that the sorting isn't really needed, but it makes testing a lot easier for now.
+          params.each do |key, value|
+            button << tag(:input, :type => 'hidden', :name => key, :value => value) unless value.nil?
+          end
+        end
+      end.join("\n")
+    end
+    
+    
+    # Pass an address to paypal so that all singup forms can be prefilled
+    #
+    # * <tt>email</tt> --	Customer's email address
+    # * <tt>first_name</tt> --	Customer's first name. Must be alpha-numeric, with a 32 character limit
+    # * <tt>last_name</tt> --	Customer's last name. Must be alpha-numeric, with a 64 character limit
+    # * <tt>address1</tt> --	First line of customer's address. Must be alpha-numeric, with a 100 character limit
+    # * <tt>address2</tt> --	Second line of customer's address. Must be alpha-numeric, with a 100 character limit
+    # * <tt>city</tt> --	City of customer's address. Must be alpha-numeric, with a 100 character limit
+    # * <tt>state</tt> --	State of customer's address. Must be official 2 letter abbreviation
+    # * <tt>zip</tt> --	Zip code of customer's address
+    # * <tt>night_phone_a</tt> --	Area code of customer's night telephone number
+    # * <tt>night_phone_b</tt> --	First three digits of customer's night telephone number
+    # * <tt>day_phone_a</tt> --	Area code of customer's daytime telephone number
+    # * <tt>day_phone_b</tt> --	First three digits of customer's daytime telephon
+    def paypal_address(options = {})
+      options.collect do |key, value|
+        tag(:input, :type => 'hidden', :name => key, :value => value)
+      end.join("\n")
+    end
+    
+    private
+    
+    # See https://www.paypal.com/IntegrationCenter/ic_std-variable-reference.html for details on the following options.
+    def valid_setup_options
+      [
+      # Generic Options
+      :cmd,
+      # IPN Support
+      :notify_url,
+      # Item Information
+      :item_name,
+      :quantity,
+      :undefined_quantity,
+      :on0,
+      :os0,
+      :on1,
+      :os1,
+      # Display Information
+      :add,
+      :cancel_return,
+      :cbt,
+      :cn,
+      :cpp_header_image,
+      :cpp_headerback_color,
+      :cpp_headerborder_color,
+      :cpp_payflow_color,
+      :cs,
+      :display,
+      :image_url,
+      :no_note,
+      :no_shipping,
+      :page_style,
+      :return,
+      :rm,
+      # Transaction Information
+      :address_override,
+      :currency,
+      :currency_code,
+      :custom,
+      :handling,
+      :invoice,
+      :redirect_cmd,
+      :shipping,
+      :tax,
+      :tax_cart,
+      # Shopping Cart Options
+      :amount,
+      :business,
+      :handling_cart,
+      :paymentaction,
+      :rupload,
+      :charset,
+      :upload,
+      # Prepopulating PayPal FORMs or Address Overriding
+      :address1,
+      :address2,
+      :city,
+      :country,
+      :email,
+      :first_name,
+      :last_name,
+      :lc,
+      :night_phone_a,
+      :night_phone_b,
+      :night_phone_c,
+      :state,
+      :zip,
+      # Prepopulating Business Account Sign-up
+      :business_address1,
+      :business_address2,
+      :business_city,
+      :business_state,
+      :business_country,
+      :business_cs_email,
+      :business_cs_phone_a,
+      :business_cs_phone_b,
+      :business_cs_phone_c,
+      :business_url,
+      :business_night_phone_a,
+      :business_night_phone_b,
+      :business_night_phone_c,
+      # End of list from https://www.paypal.com/IntegrationCenter/ic_std-variable-reference.html
+      # The following items are known to exist but are not yet on the above page.
+      :business_zip,
+      :day_phone_a,
+      :day_phone_b,
+      :day_phone_c,
+      # Subscription Options
+      :a1, # Trial Amount 1
+      :p1, # Trial Period 1
+      :t1, # Trial Period 1 Units (D=days, W=weeks, M=months, Y=years)
+      :a2, # Trial Amount 2
+      :p2, # Trial Period 2
+      :t2, # Trial Period 2 Units
+      :a3, # Regular Subscription Amount
+      :p3, # Regular Subscription Period
+      :t3, # Regular Subscription Period Units
+      :src, # Recurring Payments? (1=yes, default=0)
+      :sra, # Reattempt Transaction on Failure? (1=yes, default=0)
+      :srt, # Recurring Times (number of renewals before auto-cancel, default=forever)
+      :usr_manage, # Username and Password Generator? (1=yes, default=0)
+      :modify, # Modification Behaviour (0=new subs only, 1=new or modify, 2=modify existing only, default=0)
+      # Encryption Options - used internally only.
+      :business_key, # Your private key
+      :business_cert, # Your public certificate
+      :business_certid, # Your public certificate ID (from Paypal)
+      # Other
+      :bn
+      ]
+    end
+    
+  end
+end