You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Holger Hans Peter Freyther 4883afb265 paypal: Add hack to accept paypal from US and Germany... 10 years ago
app paypal: Add hack to accept paypal from US and Germany... 9 years ago
config Add german translation. 9 years ago
db/migrate address: Do not use the paypal shipping address to override things 9 years ago
lib [Fixes #81] - changes the way we initialize payment methods 9 years ago
spec Fix calls for spree root url. [fix #102] 9 years ago
.gitignore Add simplecov for test coverage. 9 years ago
.travis.yml Only test 1-2-stable branch 9 years ago
Gemfile Remove spree_auth_devise dependency 9 years ago
LICENSE Modified to work with Spree 0.30.1. 11 years ago README markup fix [ci skip] 9 years ago
Rakefile Updated to work with 1-1 proper 10 years ago
Versionfile Add 1-2-stable to Versionfile [ci skip] 9 years ago
capture-notes Significant changes: add missing AM libs, adapt to spree 0.8.4+, 13 years ago
response-example-one included, for reference later 12 years ago
response-xml-one included, for reference later 12 years ago
spree_paypal_express.gemspec Lock capybara at 1.1.3 9 years ago

Official PayPal Express for Spree

Build Status

This is the official PayPal Express extension for Spree, based on the extension by PaulCC it has been extended to support Spree's Billing Integrations which allows users to configure the PayPal Express gateway including API login / password and signatures fields via the Admin UI.

This extension allows the store to use PayPal Express from two locations:

  1. Checkout Payment - When configured the PayPal Express checkout button will appear alongside the standard credit card payment options on the payment stage of the standard checkout. The selected shipping address and shipping method / costs are automatically sent to the PayPal review page (along with detailed order information).

  2. Cart Checkout* - Presents the PayPal checkout button on the users Cart page and redirects the user to complete all shipping / addressing information on PaypPal's site. This also supports PayPal's Instant Update feature to retrieve shipping options live from Spree when the user selects / changes their shipping address on PayPal's site.

  • Check "Checkout from cart" in admin for feature to work

This extension follows the documented flow for a PayPal Express Checkout, where a user is forwarded to PayPal to allow them to login and review the order (possibly select / change shipping address and method), then the user is redirected back to Spree to confirm the order. The user MUST confirm the order on the Spree site before the payment is authorized / captured from PayPal (and the order is transitioned to the New state).


  1. Add the following line to your application's Gemfile

     gem 'spree_paypal_express', :git => 'git://', :branch => '1-2-stable'
  2. Install the gem using Bundler:

     bundle install
  3. Copy & run migrations

     bundle exec rails g spree_paypal_express:install


To determine the correct version of this extension, please refer to the Versionfile.

IPN & eCheck Support

eCheck payments are now fully supported and PayPal's Instant Payment Notification service is also supported for receiving updates relating to eCheck payments only. To configure eCheck payments you'll need to:

  1. Configure your PayPal account to accept eCheck payments (under Profile on PayPal's website).

  2. Set the IPN URL on your PayPal account (under Profile on PayPal's website) to:
  3. Enable auto_capture within Spree (as eCheck payments are only supported for purchase and not authorize requests).

     Spree::Config.set(:auto_capture => true)

    Please note if you accept foreign currency:

    Auto Capture will only work if you configure your Paypal Store like so:

     Profile > My Selling Tools > Payment Receiving Preferences >
     (this workflow may vary as Paypal updates their UI from time to time)
     Block payments sent to me in a currency I do not hold:
      [ ] Yes
      [x] No, accept them and convert them to [Your Default Currency]
      [ ] Ask Me


  1. Before you begin

You'll need to have a Paypal developer account ( and both buyer and seller test accounts.

Tip: these are sandbox only, so use email addresses and passwords that are easy to remember, e.g. and

Your sandbox credentials are available from the API Credentials link.

  1. Setup the Payment Method

Log in as an admin and add a new Payment Method (under Configuration), using following details:

Name: Paypal Express

Environment: Development (or what ever environment you prefer)

Active: Yes

Provider: Spree::BillingIntegration::PaypalExpress

Click *Create , and now add your credentials in the screen that follows:

Review: unchecked [1]

Signature: API signature from your paypal seller test account

Server: test (for Development or live for Production)

Test Mode: checked (or unchecked for Production)

Password: API Password from your paypal seller test account

Login: API Username from your paypal seller test account (care to use the API Username and not the Test Account address)

Click Update

Test Drive

While testing PayPal Express checkout locally make sure you're logged into your PayPal developer account in another browser window before attempting a PayPal payment, as you'll be redirected and forced to sign in to your developer account.

  1. Add an item to cart

  2. Check out

  3. Address step: complete it using a valid US address.

  4. Delivery step: pick anything

  5. On the Payment Step, you should see a PayPal button. You can select it directly or just click "Continue"

  6. You will get redirected to PayPals sandbox site, be sure to log in as a Buyer / Personal test account and not the account you use to configure the Payment Method with.

  7. You should now see the paypal order details screen with a Pay Now button.

  8. Click Pay Now, and you should now be redirected back to Spree's order thank you page.

  9. Log into the Admin UI and review the Order and Payment details to confirm the successful checkout.

Running Specs

  1. Create Test App

     rake test_app
  2. Run Specs

     rake spec


To automatically capture funds or enable accepting eCheck payments, add this to you site extension's activate method:

if Spree::Config.instance
  Spree::Config[:auto_capture] = true

[1] If you check the review checkbox in the admin section for Payment Methods/Paypal Express, the flow is slightly different. Instead of Pay Now on Paypal's order details page, it now says Continue. And the user is directed back to the spree app's Confirmation page showing a place order button. Use whichever suits your needs best. Personally, I leave review unchecked to cut down on the steps in the checkout flow.