Spree Paypal REST

This is a Paypal REST SDK extension for Spree.

Behind the scenes, this extension uses Paypal Ruby SDK.

Why?

• The Official Spree Paypal Express extension for Spree latest update was a year ago.
• Braintree is not available in some countries.
• Support for Spree latest stable release 3.1

Features

• Paypal Express Checkout/Payment Experience API integration.
• Support for Promotions and Adjustments.
• Let Spree handle Orders and Payments flow.

Fixes

• Paypal not trigger submit coupon code.
• NotImplementedError (You must implement cancel method for this payment method.)
• Customer Reimburse fails
• Undefined method credit
• Error When Trying to Cancel Order in Dev Mode
• "Save and continue" does nothing useful when PayPal method is selected

Installation

Before installing this extension please follow Spree installation Guide.

cd my_project
echo "gem 'spree_paypal_rest', '1.0.2'" >> Gemfile
bundle
rails g spree_paypal_rest:install
rails server

Sandbox Setup

Paypal

Go to PayPal's Developer Website, sign in with your PayPal account, click "Sandbox -> Accounts" and create a new "Business" account. Once the account is created, click on "My Apps & Credentials" scroll down to REST API apps and create a new app, select your app's name and sandbox business account.

Click on your app to access Sandbox API Credentials.

You will also need a "Personal" account to test the transactions on your site. Create this in the same way, finding the account information under "Profile" as well. You may need to set a password in order to be able to log in to PayPal's sandbox for this user. (There is no need to create a REST API App for this account)

Spree Backend

In Spree, go to the admin backend, click "Configuration -> General Settings" and add the Site URL.

Then go to the admin backend, click "Configuration -> Payment Methods" and create a new payment method. Select "Spree::Gateway::PaypalExpress" as the provider, and click "Create".

Then enter the following information for your paypal Business Account:

• Brand Name
• Address Override
• Landing Page Type
• Temporary
• Locale Code
• Profile Name
• Logo URL
• Server
• Client ID
• Client Secret
• Test Mode
• Auto Capture

For information on this fields and Paypal REST API in general, please take a look at the paypal REST API documentation

• REST API reference
• Payment Experience API
• Payments API

TO-DO

• Internationalization.
• More testing.
• Follow Spree versioning style.

Contributing

In the spirit of free software, everyone is encouraged to help improve this project.

Here are some ways you can contribute:

• by using prerelease versions
• by reporting bugs
• by suggesting new features
• by writing or editing documentation
• by writing specifications
• by writing code (no patch is too small: fix typos, add comments, clean up inconsistent whitespace)
• by refactoring code
• by resolving issues
• by reviewing patches

Starting point:

• Fork the repo
• Clone your repo
• Run bundle install
• Make your changes
• Ensure specs pass by running bundle exec rspec spec
• Submit your pull request

License

Licensed under the MIT license. Full details can be found in the MIT-LICENSE file in the root of the repository.