# solidus_braintree

`solidus_braintree` is a gem that adds [Braintree v.zero](https://www.braintreepayments.com/v.zero) support to the [solidus](http://solidus.io/) 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:

```ruby
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](https://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](http://opensource.org/licenses/MIT).