/solidus_braintree

Braintree v.zero support for solidus

Primary LanguageRubyMIT LicenseMIT

solidus_braintree

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

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.