paypal-permissions 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,15 @@
+source :rubygems
+
+gem 'httpclient'
+
+group :development do
+  gem "jeweler", "~> 1.6.4"
+end
+
+group :test do
+  gem "rspec", ">= 2.0.0"
+
+  # testing help
+  gem "webmock"
+  gem "vcr"
+end

data/Gemfile.lock

@@ -0,0 +1,35 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.6)
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    httpclient (2.2.1)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    vcr (1.10.3)
+    webmock (1.6.4)
+      addressable (~> 2.2, > 2.2.5)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  httpclient
+  jeweler (~> 1.6.4)
+  rspec (>= 2.0.0)
+  vcr
+  webmock

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2011 Recurly, Inc.
+
+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.rdoc

@@ -0,0 +1,72 @@
+# Paypal Permissions
+
+Ruby implementation of the [PayPal Permissions API](https://www.x.com/community/ppx/permissions).
+
+Please visit PayPal's [Permissions Service API developer forums](https://www.x.com/community/ppx/permissions?view=discussions) for questions about the Permissions API.
+
+## Example
+
+### Step 1: Direct the user to the "Grant Permissions" on PayPal
+    
+    paypal = PaypalPermissions::Paypal.new( userid, password, signature, application_id, :production )
+    request_data = paypal.request_permissions(
+      [:express_checkout, :direct_payment, :auth_capture, :refund, :transaction_details],
+      'http://localhost/callback_url'
+    )
+    
+    # Send the browser to :permissions_url to grant permission to your application
+    redirect_to request_data[:permissions_url]
+
+### Step 2: Lookup result to get the final permission token
+
+    paypal = PaypalPermissions::Paypal.new( userid, password, signature, application_id, :production )
+    token_data = paypal.get_access_token( params['token'], params['verifier'] )
+    
+    # Save token_data[:token] and token_data[:token_secret]
+
+### Step 3: Make API calls with the `X-PP-AUTHORIZATION` header
+
+Use the `:token` and `:token_secret`, along with your own API credentials, to create the `X-PP-AUTHORIZATION` header.
+
+    signature = paypal.generate_signature(api_key, secret, token, token_secret, 'POST', 'https://api.paypal.com/nvp')
+    header = { 'X-PP-AUTHORIZATION' => signature }
+
+### Lookup granted permissions
+
+    scopes = paypal.lookup_permissions paypal_token
+
+### Cancel granted permissions
+
+    paypal.cancel_permissions paypal_token
+
+## Available Permissions
+
+    :express_checkout
+    :direct_payment
+    :settlement_consolidation
+    :settlement_reporting
+    :auth_capture
+    :mobile_checkout
+    :billing_agreement
+    :reference_transaction
+    :air_travel
+    :mass_pay
+    :transaction_details
+    :transaction_search
+    :recurring_payments
+    :account_balance
+    :encrypted_website_payments
+    :refund
+    :non_referenced_credit
+    :button_manager
+    :manage_pending_transaction_status
+    :recurring_payment_report
+    :extended_pro_processing_report
+    :exception_processing_report
+    :account_management_permission
+
+## Copyright
+
+Copyright (c) 2011 Recurly. MIT License
+
+Original version by Isaac Hall.

data/Rakefile

@@ -0,0 +1,44 @@
+require 'rubygems'
+require 'rake'
+require 'bundler'
+begin
+  Bundler.setup(:default, :test)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "paypal-permissions"
+  gem.homepage = "http://github.com/isaachall/paypal-permissions"
+  gem.license = "MIT"
+  gem.summary = %Q{Ruby implementation of the PayPal Permissions API.}
+  gem.description = %Q{Ruby implementation of the PayPal Permissions API.}
+  gem.email = "isaac@isaachall.com"
+  gem.authors = ["Isaac Hall"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  gem.add_runtime_dependency 'httpclient'
+  gem.add_development_dependency 'rspec', '> 2.0.0'
+  gem.add_development_dependency 'vcr'
+  gem.add_development_dependency 'webmock'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "paypal-permissions #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/paypal-permissions.rb

@@ -0,0 +1,9 @@
+require 'paypal-permissions/version'
+require 'paypal-permissions/fault_message'
+require 'paypal-permissions/oauth'
+require 'paypal-permissions/paypal'
+
+# configuration
+module PaypalPermissions
+  
+end

data/lib/paypal-permissions/fault_message.rb

@@ -0,0 +1,58 @@
+module PaypalPermissions
+  # Base error class
+  class Error < Exception; end
+
+  # PayPal returned a 500 Internal Server Error. Retry?
+  class InternalServerError < PaypalPermissions::Error; end
+
+  # PayPal returned an unexpected error message
+  class UnknownResponse < PaypalPermissions::Error
+    attr_accessor :response_code
+
+    def initialize(response_code, message)
+      @response_code = response_code
+      @message = message
+    end
+  end
+
+  # PayPal returned a well formatted error message
+  class FaultMessage < Error
+    attr_accessor :timestamp, :ack, :correlation_id, :build, :errors
+
+    class ErrorInformation
+      attr_accessor :category, :domain, :subdomain, :error_id, :message, :parameter, :severity
+
+      def initialize(options = {}, error_number = 0)
+        @category  = options["error(#{error_number}).category"]
+        @domain    = options["error(#{error_number}).domain"]
+        @subdomain = options["error(#{error_number}).subdomain"]
+        @error_id  = options["error(#{error_number}).errorId"]
+        @message   = options["error(#{error_number}).message"]
+        @parameter = options["error(#{error_number}).parameter"]
+        @severity  = options["error(#{error_number}).severity"]
+      end
+    end
+
+    def initialize(options = {})
+      @timestamp      = options['timestamp']
+      @ack            = options['ack'].to_s.downcase.to_sym
+      @correlation_id = options['correlationId']
+      @build          = options['build']
+      @errors         = collect_errors(options)
+      
+      @message = @ack
+    end
+
+    private
+    def collect_errors(options={})
+      errors = []
+      error_number = 0
+      
+      while options["error(#{error_number}).errorId"]
+        errors << PaypalPermissions::FaultMessage::ErrorInformation.new(options, error_number)
+        error_number = error_number + 1
+      end
+      errors
+    end
+  end
+end

data/lib/paypal-permissions/paypal.rb

@@ -0,0 +1,174 @@
+require 'net/http'
+require 'net/https'
+require 'uri'
+require 'cgi'
+
+module PaypalPermissions
+  class Paypal
+    include Oauth
+
+    attr_accessor :userid, :password, :signature, :application_id, :mode
+
+    SANDBOX_SERVER = 'https://svcs.sandbox.paypal.com/Permissions/'
+    PRODUCTION_SERVER = 'https://svcs.paypal.com/Permissions/'
+    API_VERSION = '74.0'
+
+    SANDBOX_GRANT_PERMISSION_URL = 'https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_grant-permission&request_token='
+    PRODUCTION_GRANT_PERMISSION_URL = 'https://www.paypal.com/cgi-bin/webscr?cmd=_grant-permission&request_token='
+
+    PERMISSIONS = {
+      :express_checkout => 'EXPRESS_CHECKOUT',
+      :direct_payment => 'DIRECT_PAYMENT',
+      :settlement_consolidation => 'SETTLEMENT_CONSOLIDATION',
+      :settlement_reporting => 'SETTLEMENT_REPORTING',
+      :auth_capture => 'AUTH_CAPTURE',
+      :mobile_checkout => 'MOBILE_CHECKOUT',
+      :billing_agreement => 'BILLING_AGREEMENT',
+      :reference_transaction => 'REFERENCE_TRANSACTION',
+      :air_travel => 'AIR_TRAVEL',
+      :mass_pay => 'MASS_PAY',
+      :transaction_details => 'TRANSACTION_DETAILS',
+      :transaction_search => 'TRANSACTION_SEARCH',
+      :recurring_payments => 'RECURRING_PAYMENTS',
+      :account_balance => 'ACCOUNT_BALANCE',
+      :encrypted_website_payments => 'ENCRYPTED_WEBSITE_PAYMENTS',
+      :refund => 'REFUND',
+      :non_referenced_credit => 'NON_REFERENCED_CREDIT',
+      :button_manager => 'BUTTON_MANAGER',
+      :manage_pending_transaction_status => 'MANAGE_PENDING_TRANSACTION_STATUS',
+      :recurring_payment_report => 'RECURRING_PAYMENT_REPORT',
+      :extended_pro_processing_report => 'EXTENDED_PRO_PROCESSING_REPORT',
+      :exception_processing_report => 'EXCEPTION_PROCESSING_REPORT',
+      :account_management_permission => 'ACCOUNT_MANAGEMENT_PERMISSION',
+    }
+
+    # Credentials: UserID, Password, Signature, Application ID
+    def initialize(userid, password, signature, application_id, mode = :production)
+      raise "Mode must be :sandbox or :production" unless [:sandbox, :production].include? mode
+      @userid = userid
+      @password = password
+      @signature = signature
+      @application_id = application_id
+      @mode = mode
+    end
+
+    # Create a "Request Permissions" URL. After requesting permissions, send the user to the URL
+    # so they can grant permissions. The user will be redirected back to the :callback_url.
+    def request_permissions(permissions_scopes, callback_url, language = 'en')
+      url = create_url('RequestPermissions')
+
+      request_data = {'callback' => callback_url, 'language' => language }
+      permissions_scopes.each_with_index { |ps,index| request_data["scope(#{index})"] = PERMISSIONS[ps] }
+      data = call(url, request_data)
+
+      raise PaypalPermissions::FaultMessage.new(data) unless data['token']
+
+      # Redirect URL:
+      # https://www.paypal.com/cgi-bin/webscr?cmd=_grant-permission&request_token= + token
+      {
+        permissions_url: (mode == :production ? PRODUCTION_GRANT_PERMISSION_URL : SANDBOX_GRANT_PERMISSION_URL) + data['token'],
+        token: data['token'],
+      }
+    end
+
+    # After a callback, lookup the access token and token secret using the :token and :verification from
+    # the callback URL.
+    def get_access_token(token, verifier)
+      url = create_url('GetAccessToken')
+      data = call(url, { 'token' => token, 'verifier' => verifier })
+
+      raise PaypalPermissions::FaultMessage.new(data) unless (data['token'] && data['tokenSecret'])
+
+      {
+        token:        data['token'],
+        token_secret: data['tokenSecret'],
+        scopes:       parse_scopes(data),
+      }
+    end
+
+    # Lookup the permissions granted to a given token.
+    def lookup_permissions(token)
+      url = create_url('GetPermissions')
+      data = call(url, { 'token' => token })
+
+      paypal_scopes = parse_scopes(data)
+      raise PaypalPermissions::FaultMessage.new(data) if paypal_scopes.empty?
+
+      { scopes: paypal_scopes }
+    end
+
+    # Cancel the permissions granted to the given token
+    def cancel_permissions(token)
+      url = create_url('CancelPermissions')
+      data = call(url, { 'token' => token })
+      true
+    end
+
+    protected
+
+    def create_url(endpoint)
+      (mode == :production ? PRODUCTION_SERVER : SANDBOX_SERVER) + endpoint
+    end
+
+    def call(url, params={})
+      headers = {
+        'X-PAYPAL-SECURITY-USERID' => @userid,
+        'X-PAYPAL-SECURITY-PASSWORD' => @password,
+        'X-PAYPAL-SECURITY-SIGNATURE' => @signature,
+        'X-PAYPAL-REQUEST-DATA-FORMAT' => 'NV',
+        'X-PAYPAL-RESPONSE-DATA-FORMAT'=> 'NV',
+        'X-PAYPAL-APPLICATION-ID' => @application_id,
+        'Content-Type' => 'application/x-www-form-urlencoded',
+      }
+      params['requestEnvelope.errorLanguage'] = 'en_US'
+      data = params.map{ |k,v| "#{CGI.escape(k)}=#{CGI.escape(v)}" }.join('&')
+      data = URI.encode_www_form(params)
+
+      endpoint = URI(url)
+      timeout(30) do
+        http = Net::HTTP.new(endpoint.host, endpoint.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE if mode == :sandbox
+        response = http.post(endpoint.request_uri, data, headers)
+        code = response.code
+
+        case code.to_i
+        when 200
+          data = get_hash(response.body)
+          raise PaypalPermissions::FaultMessage.new(data) if data['responseEnvelope.ack'] == 'Failure'
+          return data
+        when 500
+          raise PaypalPermissions::InternalServerError.new(response.body)
+        else
+          raise PaypalPermissions::UnknownResponse.new(code.to_i, response.body)
+        end
+      end
+    end
+
+    private
+
+    # Gets a hash from a string, with a set of name value pairs joined by '='
+    # and concatenated with '&'
+    def get_hash(string)
+      hash = {}
+      string.split('&').collect { |pair| pair.split('=') }.each { |a|
+        hash[a[0]] = URI.unescape(a[1])
+      }
+      return hash
+    end
+
+    # Parse out the scopes from the PayPal response
+    def parse_scopes(data)
+      scopes = []
+      scopes << data['scope'] if data['scope'] # If there is only one scope
+
+      i = 0
+      while (data["scope(#{i})"]) do
+        scopes << data["scope(#{i})"]; i = i + 1
+      end # For multiple scopes
+
+      # Convert to symbols
+      scopes.collect { |paypal_scope| PERMISSIONS.select { |k,val| val == paypal_scope }.keys.first }
+    end
+  end
+end

data/lib/paypal-permissions/version.rb

@@ -0,0 +1,3 @@
+module PaypalPermissions #:nodoc
+  VERSION = "0.1.0"
+end

data/spec/paypal_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+module PaypalPermissions
+  describe Paypal do
+    it "should request permissions with multiple scopes" do
+      VCR.use_cassette("request_permissions_multiple") do
+        permission_data = @paypal.request_permissions(
+          [:express_checkout, :direct_payment, :auth_capture, :refund, :transaction_details], 
+          'http://localhost/')
+
+        permission_data[:token].should == 'AAAAAAATmjdbA3ADelJ6'
+        permission_data[:permissions_url].should == 'https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_grant-permission&request_token=' + permission_data[:token]
+      end
+    end
+    
+    it "should request permissions with a single scopes" do
+      VCR.use_cassette("request_permissions_single") do
+        permission_data = @paypal.request_permissions(
+          [:express_checkout], 
+          'http://localhost/')
+          
+        permission_data[:token].should == 'AAAAAAATmnP2wcRCp7Mc'
+        permission_data[:permissions_url].should == 'https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_grant-permission&request_token=' + permission_data[:token]
+      end
+    end
+    
+    it "should get an access token" do
+      VCR.use_cassette("get_access_token_valid") do
+        access_data = @paypal.get_access_token('AAAAAAATmjdbA3ADelJ6','KVTI4zbTe.QW07vOqPpqYg')
+        access_data[:token].should == 'M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA'
+        access_data[:token_secret].should == 'l1.rjYM659iL92IwDmnPFeDWUnU'
+        access_data[:scopes].should == [:express_checkout, :refund, :direct_payment, :auth_capture, :transaction_details]
+      end
+    end
+
+    describe "#lookup_permissions" do
+      it "should lookup permissions" do
+        VCR.use_cassette("lookup_permissions_multiple") do
+          lookup_data = @paypal.lookup_permissions('M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA')
+          lookup_data[:scopes].should == [:express_checkout, :refund, :direct_payment, :auth_capture, :transaction_details]
+        end
+      end
+    end
+
+    describe "#cancel_permission" do
+      it "should cancel permmission successfully" do
+        VCR.use_cassette("cancel_permission") do
+          cancel_data = @paypal.cancel_permissions('M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA')
+          cancel_data.should be_true
+        end
+      end
+
+      it "should raise a FaultMessage when canceling an invalid permmission" do
+        lambda {
+          VCR.use_cassette("cancel_permission_invalid") do
+            @paypal.cancel_permissions('M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA')
+          end
+        }.should raise_error(PaypalPermissions::FaultMessage)
+      end
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,34 @@
+require 'test/unit'
+require 'rubygems'
+require "bundler"
+require 'yaml'
+require 'vcr'
+Bundler.setup
+
+$LOAD_PATH.unshift "#{File.dirname(__FILE__)}/../lib"
+require 'paypal-permissions'
+
+module SpecHelper
+  # add helper methods here
+end
+
+RSpec.configure do |config|
+  config.include SpecHelper
+  config.extend VCR::RSpec::Macros
+  config.mock_with :rspec
+
+  config.before(:all) do
+    credentials = YAML.load(File.read(File.join(File.dirname(__FILE__), 'sandbox_credentials.yml')))
+    @paypal = PaypalPermissions::Paypal.new(
+      credentials['userid'], credentials['password'],credentials['signature'],credentials['application_id'],credentials['mode']
+    )
+  end
+end
+
+VCR.config do |c|
+  c.cassette_library_dir = 'spec/vcr'
+  c.stub_with :webmock
+
+  # Uncomment to allow VCR to record new cassettes
+  #c.default_cassette_options = { :record => :new_episodes }
+end

data/spec/vcr/cancel_permission.yml

@@ -0,0 +1,53 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :post
+    uri: https://svcs.sandbox.paypal.com:443/Permissions/CancelPermissions
+    body: token=M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA&requestEnvelope.errorLanguage=en_US
+    headers:
+      x-paypal-security-userid:
+      - test_user_api1.recurly.com
+      x-paypal-security-password:
+      - '1234567890'
+      x-paypal-security-signature:
+      - AW123412341234123412341234123412341234123412341234123412
+      x-paypal-request-data-format:
+      - NV
+      x-paypal-response-data-format:
+      - NV
+      x-paypal-application-id:
+      - APP-80W284485P519543T
+      content-type:
+      - application/x-www-form-urlencoded
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      date:
+      - Thu, 28 Jul 2011 03:07:42 GMT
+      server:
+      - Apache-Coyote/1.1
+      x-paypal-message-protocol:
+      - NONE
+      x-paypal-response-data-format:
+      - NV
+      x-ebay-soa-request-id:
+      - 1316eb62-ec10-a486-d666-6636ffffffba!Permissions!10.72.109.102![]
+      x-paypal-operation-name:
+      - CancelPermissions
+      x-paypal-service-name:
+      - ! '{http://svcs.paypal.com/types/perm}Permissions'
+      x-paypal-service-version:
+      - 1.0.0
+      content-type:
+      - text/plain;charset=UTF-8
+      set-cookie:
+      - Apache=10.72.109.11.1311822458368813; path=/; expires=Sat, 20-Jul-41 03:07:38
+        GMT
+      vary:
+      - Accept-Encoding
+      transfer-encoding:
+      - chunked
+    body: responseEnvelope.timestamp=2011-07-27T20%3A07%3A42.513-07%3A00&responseEnvelope.ack=Success&responseEnvelope.correlationId=ca9bd9ab62f06&responseEnvelope.build=1860631
+    http_version: '1.1'

data/spec/vcr/cancel_permission_invalid.yml

@@ -0,0 +1,55 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :post
+    uri: https://svcs.sandbox.paypal.com:443/Permissions/CancelPermissions
+    body: token=M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA&requestEnvelope.errorLanguage=en_US
+    headers:
+      x-paypal-security-userid:
+      - test_user_api1.recurly.com
+      x-paypal-security-password:
+      - '1234567890'
+      x-paypal-security-signature:
+      - AW123412341234123412341234123412341234123412341234123412
+      x-paypal-request-data-format:
+      - NV
+      x-paypal-response-data-format:
+      - NV
+      x-paypal-application-id:
+      - APP-80W284485P519543T
+      content-type:
+      - application/x-www-form-urlencoded
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      date:
+      - Thu, 28 Jul 2011 03:08:17 GMT
+      server:
+      - Apache-Coyote/1.1
+      x-paypal-message-protocol:
+      - NONE
+      x-paypal-response-data-format:
+      - NV
+      x-ebay-soa-request-id:
+      - 1316eb6c-1390-a486-d647-d8d7ffffffb8!Permissions!10.72.109.100![]
+      x-paypal-operation-name:
+      - CancelPermissions
+      x-paypal-service-name:
+      - ! '{http://svcs.paypal.com/types/perm}Permissions'
+      x-paypal-service-version:
+      - 1.0.0
+      x-paypal-error-response:
+      - 'TRUE'
+      content-type:
+      - text/plain;charset=UTF-8
+      set-cookie:
+      - Apache=10.72.109.11.1311822495864392; path=/; expires=Sat, 20-Jul-41 03:08:15
+        GMT
+      vary:
+      - Accept-Encoding
+      transfer-encoding:
+      - chunked
+    body: responseEnvelope.timestamp=2011-07-27T20%3A08%3A17.026-07%3A00&responseEnvelope.ack=Failure&responseEnvelope.correlationId=c8981c666c180&responseEnvelope.build=1860631&error(0).errorId=520002&error(0).domain=PLATFORM&error(0).subdomain=Application&error(0).severity=Error&error(0).category=Application&error(0).message=Internal+Error
+    http_version: '1.1'

data/spec/vcr/get_access_token_valid.yml

@@ -0,0 +1,53 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :post
+    uri: https://svcs.sandbox.paypal.com:443/Permissions/GetAccessToken
+    body: token=AAAAAAATmjdbA3ADelJ6&verifier=KVTI4zbTe.QW07vOqPpqYg&requestEnvelope.errorLanguage=en_US
+    headers:
+      x-paypal-security-userid:
+      - test_user_api1.recurly.com
+      x-paypal-security-password:
+      - '1234567890'
+      x-paypal-security-signature:
+      - AW123412341234123412341234123412341234123412341234123412
+      x-paypal-request-data-format:
+      - NV
+      x-paypal-response-data-format:
+      - NV
+      x-paypal-application-id:
+      - APP-80W284485P519543T
+      content-type:
+      - application/x-www-form-urlencoded
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      date:
+      - Thu, 28 Jul 2011 03:05:56 GMT
+      server:
+      - Apache-Coyote/1.1
+      x-paypal-message-protocol:
+      - NONE
+      x-paypal-response-data-format:
+      - NV
+      x-ebay-soa-request-id:
+      - 1316eb49-a450-a486-d637-e8f7fffffd10!Permissions!10.72.109.99![]
+      x-paypal-operation-name:
+      - GetAccessToken
+      x-paypal-service-name:
+      - ! '{http://svcs.paypal.com/types/perm}Permissions'
+      x-paypal-service-version:
+      - 1.0.0
+      content-type:
+      - text/plain;charset=UTF-8
+      set-cookie:
+      - Apache=10.72.109.11.1311822354823084; path=/; expires=Sat, 20-Jul-41 03:05:54
+        GMT
+      vary:
+      - Accept-Encoding
+      transfer-encoding:
+      - chunked
+    body: responseEnvelope.timestamp=2011-07-27T20%3A05%3A56.696-07%3A00&responseEnvelope.ack=Success&responseEnvelope.correlationId=35d2810849d35&responseEnvelope.build=1860631&scope(0)=EXPRESS_CHECKOUT&scope(1)=REFUND&scope(2)=DIRECT_PAYMENT&scope(3)=AUTH_CAPTURE&scope(4)=TRANSACTION_DETAILS&token=M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA&tokenSecret=l1.rjYM659iL92IwDmnPFeDWUnU
+    http_version: '1.1'

data/spec/vcr/lookup_permissions_multiple.yml

@@ -0,0 +1,53 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :post
+    uri: https://svcs.sandbox.paypal.com:443/Permissions/GetPermissions
+    body: token=M-RTGNyaZP5OMNIUxkH29I53eFvQhTJk3UfByH4pWfjSQHlj5csUVA&requestEnvelope.errorLanguage=en_US
+    headers:
+      x-paypal-security-userid:
+      - test_user_api1.recurly.com
+      x-paypal-security-password:
+      - '1234567890'
+      x-paypal-security-signature:
+      - AW123412341234123412341234123412341234123412341234123412
+      x-paypal-request-data-format:
+      - NV
+      x-paypal-response-data-format:
+      - NV
+      x-paypal-application-id:
+      - APP-80W284485P519543T
+      content-type:
+      - application/x-www-form-urlencoded
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      date:
+      - Thu, 28 Jul 2011 03:06:49 GMT
+      server:
+      - Apache-Coyote/1.1
+      x-paypal-message-protocol:
+      - NONE
+      x-paypal-response-data-format:
+      - NV
+      x-ebay-soa-request-id:
+      - 1316eb56-55c0-a486-d647-d8d7ffffffb9!Permissions!10.72.109.100![]
+      x-paypal-operation-name:
+      - GetPermissions
+      x-paypal-service-name:
+      - ! '{http://svcs.paypal.com/types/perm}Permissions'
+      x-paypal-service-version:
+      - 1.0.0
+      content-type:
+      - text/plain;charset=UTF-8
+      set-cookie:
+      - Apache=10.72.109.11.1311822406811670; path=/; expires=Sat, 20-Jul-41 03:06:46
+        GMT
+      vary:
+      - Accept-Encoding
+      transfer-encoding:
+      - chunked
+    body: responseEnvelope.timestamp=2011-07-27T20%3A06%3A49.264-07%3A00&responseEnvelope.ack=Success&responseEnvelope.correlationId=783aab5a565a2&responseEnvelope.build=1860631&scope(0)=EXPRESS_CHECKOUT&scope(1)=REFUND&scope(2)=DIRECT_PAYMENT&scope(3)=AUTH_CAPTURE&scope(4)=TRANSACTION_DETAILS
+    http_version: '1.1'

data/spec/vcr/request_permissions_multiple.yml

@@ -0,0 +1,53 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :post
+    uri: https://svcs.sandbox.paypal.com:443/Permissions/RequestPermissions
+    body: callback=http%3A%2F%2Flocalhost%2F&language=en&scope%280%29=EXPRESS_CHECKOUT&scope%281%29=DIRECT_PAYMENT&scope%282%29=AUTH_CAPTURE&scope%283%29=REFUND&scope%284%29=TRANSACTION_DETAILS&requestEnvelope.errorLanguage=en_US
+    headers:
+      x-paypal-security-userid:
+      - test_user_api1.recurly.com
+      x-paypal-security-password:
+      - '1234567890'
+      x-paypal-security-signature:
+      - AW123412341234123412341234123412341234123412341234123412
+      x-paypal-request-data-format:
+      - NV
+      x-paypal-response-data-format:
+      - NV
+      x-paypal-application-id:
+      - APP-80W284485P519543T
+      content-type:
+      - application/x-www-form-urlencoded
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      date:
+      - Thu, 28 Jul 2011 02:56:56 GMT
+      server:
+      - Apache-Coyote/1.1
+      x-paypal-message-protocol:
+      - NONE
+      x-paypal-response-data-format:
+      - NV
+      x-ebay-soa-request-id:
+      - 1316eac5-f8b0-a486-d637-e8f7fffffd11!Permissions!10.72.109.99![]
+      x-paypal-operation-name:
+      - RequestPermissions
+      x-paypal-service-name:
+      - ! '{http://svcs.paypal.com/types/perm}Permissions'
+      x-paypal-service-version:
+      - 1.0.0
+      content-type:
+      - text/plain;charset=UTF-8
+      set-cookie:
+      - Apache=10.72.109.11.1311821815501667; path=/; expires=Sat, 20-Jul-41 02:56:55
+        GMT
+      vary:
+      - Accept-Encoding
+      transfer-encoding:
+      - chunked
+    body: responseEnvelope.timestamp=2011-07-27T19%3A56%3A56.696-07%3A00&responseEnvelope.ack=Success&responseEnvelope.correlationId=5ddfdbf7c627a&responseEnvelope.build=1860631&token=AAAAAAATmjdbA3ADelJ6
+    http_version: '1.1'

data/spec/vcr/request_permissions_single.yml

@@ -0,0 +1,53 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :post
+    uri: https://svcs.sandbox.paypal.com:443/Permissions/RequestPermissions
+    body: callback=http%3A%2F%2Flocalhost%2F&language=en&scope%280%29=EXPRESS_CHECKOUT&requestEnvelope.errorLanguage=en_US
+    headers:
+      x-paypal-security-userid:
+      - test_user_api1.recurly.com
+      x-paypal-security-password:
+      - '1234567890'
+      x-paypal-security-signature:
+      - AW123412341234123412341234123412341234123412341234123412
+      x-paypal-request-data-format:
+      - NV
+      x-paypal-response-data-format:
+      - NV
+      x-paypal-application-id:
+      - APP-80W284485P519543T
+      content-type:
+      - application/x-www-form-urlencoded
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      date:
+      - Thu, 28 Jul 2011 03:19:29 GMT
+      server:
+      - Apache-Coyote/1.1
+      x-paypal-message-protocol:
+      - NONE
+      x-paypal-response-data-format:
+      - NV
+      x-ebay-soa-request-id:
+      - 1316ec10-5a50-a486-d666-6636ffffffb9!Permissions!10.72.109.102![]
+      x-paypal-operation-name:
+      - RequestPermissions
+      x-paypal-service-name:
+      - ! '{http://svcs.paypal.com/types/perm}Permissions'
+      x-paypal-service-version:
+      - 1.0.0
+      content-type:
+      - text/plain;charset=UTF-8
+      set-cookie:
+      - Apache=10.72.109.11.1311823168735914; path=/; expires=Sat, 20-Jul-41 03:19:28
+        GMT
+      vary:
+      - Accept-Encoding
+      transfer-encoding:
+      - chunked
+    body: responseEnvelope.timestamp=2011-07-27T20%3A19%3A29.943-07%3A00&responseEnvelope.ack=Success&responseEnvelope.correlationId=eecf5f55105eb&responseEnvelope.build=1860631&token=AAAAAAATmnP2wcRCp7Mc
+    http_version: '1.1'

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: paypal-permissions
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Isaac Hall
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-30 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: &70250705306740 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70250705306740
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &70250705305760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.4
+  type: :development
+  prerelease: false
+  version_requirements: *70250705305760
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: &70250705304580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70250705304580
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70250705302480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>'
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *70250705302480
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: &70250705300380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70250705300380
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &70250705299180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70250705299180
+description: Ruby implementation of the PayPal Permissions API.
+email: isaac@isaachall.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/paypal-permissions/fault_message.rb
+- lib/paypal-permissions/paypal.rb
+- lib/paypal-permissions/version.rb
+- lib/paypal-permissions.rb
+- spec/paypal_spec.rb
+- spec/spec_helper.rb
+- spec/vcr/cancel_permission.yml
+- spec/vcr/cancel_permission_invalid.yml
+- spec/vcr/get_access_token_valid.yml
+- spec/vcr/lookup_permissions_multiple.yml
+- spec/vcr/request_permissions_multiple.yml
+- spec/vcr/request_permissions_single.yml
+homepage: http://github.com/isaachall/paypal-permissions
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Ruby implementation of the PayPal Permissions API.
+test_files: []
+has_rdoc: