locomotivapro/spree_pagseguro_simple

View on GitHub
README.md

Summary

Maintainability
Test Coverage
# Spree PagSeguroSimple

[![Code Climate](https://codeclimate.com/github/locomotivapro/spree_pagseguro_simple/badges/gpa.svg)](https://codeclimate.com/github/locomotivapro/spree_pagseguro_simple)
[![Gem Version](https://badge.fury.io/rb/spree_pagseguro_simple.svg)](http://badge.fury.io/rb/spree_pagseguro_simple)

Add support for Pagseguro checkout as a payment method.
__Only tested on Spree 3.0__

This gem approach takes in consideration that a incomplete order with an approved PagSeguro transaction is unacceptable. So the user will complete the order process and then will be guided to PagSeguro to pay.

## Installation

1. Add the following to your Gemfile

    gem 'spree_pagseguro_simple'

2. Run `bundle install`

3. To copy and apply migrations run: `rails g spree_pagseguro_simple:install`

## Configuring

1. Add a new Payment Method, using: `Spree::PaymentMethod::PagSeguro` as the `Provider`

2. Click `Create`, and enter your Store's Pagseguro Email and Token in the fields provided.

3. By default sandbox env is activated. To allow production env you
   shoud define ENV['PAGSEGURO_ENV'].

4. `Save` and enjoy!

4. Is important to go to general settings in spree and configure the store url for redirects and notifications

## To-Do

  - Need to add test coverage to gem
  - Configure enviroment to use payment method preference
  - Work in notification controller action
  - Improve view in order#show

Testing
-------

To make real tests register in PagSeguro sandbox and configure the payment method as test.

Be sure to add the rspec-rails gem to your Gemfile and then create a dummy test app for the specs to run against.

    $ bundle exec rake test app
    $ bundle exec rspec spec

Disclaimer
----------

This gem is inspired by [João Netto gem](https://github.com/jnettome/spree_pagseguro) but updated to spree 3 and using a new approach to checkout flow.

Copyright (c) 2013-2015 [Locomotiva.pro](http://locomotiva.pro), released under the New BSD License