Solidus Braintree

Build Status

solidus_braintree is a gem that adds Braintree v.zero support to the solidus E-commerce platform.

It provides support for credit card and Paypal payment methods via the Spree::CreditCard

It will add the braintree-drop-in form for payment methods in the payment form of spree/backend. Spree front-end is currently unsupported.

Installation

Add this line to your solidus application's Gemfile:

gem "solidus_braintree"

And then execute:

$ bundle
$ bundle exec rails g solidus_braintree:install

Fraud detection

This gem has support for the advanced fraud tools flow from Braintree, to activate fully the associated Braintree account must enable advanced fraud tools in the Control Panel.

Usage

This gem extends your solidus application by adding a POST /api/payment_client_token endpoint to you application to generate Braintree payment client token. This endpoint requires an authentication token in your request header.

It creates a new PaymentMethod class called Solidus::Gateway::BraintreeGateway. You can configure this payment method in the admin and add your Braintree public/private keys and merchant id. The admin will render a Braintree dropin container when prompting you to create an order payment.

It adds a json or text data field on Spree::CreditCard for storing additional information received from Braintree for addtional payment methods.

Development

After checking out the repo, run bin/setup to install dependencies. To run tests, first generate a test app by running rake test_app. Then, run rake rspec which will run the test suite. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/solidusio/solidus_braintree.

License

The gem is available as open source under the terms of the MIT License.