/spree_cielo

Primary LanguageRubyBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Spree Cielo

Uma estensão do Spree para permitir pagamentos utilizando a Cielo.

Atenção

Esta gem não foi desenvolvida pensando na utilização genérica. Foi um esforço empregado para um projeto específico e atrelada à uma versão específica do Spree (1.0-stable). É um reaproveitamento de outras gems do gênero(pagseguro), que não tem nenhum teste na própria gem. Todos os testes estão na aplicação-alvo. Use esse código como referência ao invés de aplicá-lo diretamente em seu projeto.

Não há implementação completa do método de comunicação direto da Cielo(captura do cartão de crédito na loja). O fluxo regular é de criação de chamada via API e redirecionamento para a URL fornecida pela Cielo.

Instalação

Adicione spree ao gemfile da sua aplicação, e também:

gem "spree_cielo"

Rode a task de instalação:

rails generate spree_cielo:install

Configuração

Após feita a instalação e migração, acesse a administração do spree, vá em Configuração -> Métodos de Pagamento e adicione um novo método selecionando Spree::PaymentMethod::CieloRegularMethod ou Spree::PaymentMethod::CieloDebitMethod.

Adaptação

Caso queira enviar um e-mail ao usuário quando a compra for aprovada pelo cielo, sobrescreva a máquina de estados do Spree::Payment em sua aplicação para fazer o envio do e-mail (a classe PaymentMailer não existe, e precisa ser criada por você):

Spree::Payment.class_eval do
  state_machine do
    after_transition :to => 'completed', :do => :send_confirmation!
  end

  def send_confirmation!
    PaymentMailer.confirm_email(self.order).deliver
  end
end

TODO

  • Adicionar Testes

Contribuindo

Caso queira contribuir, faça um fork desta gem no github, corriga o bug/ adicione a feature desejada e faça um merge request.

Sobre

Desenvolvida por Alexandre Angelim