Project

duke-moip

0.05
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Gem para utilização da API MoIP
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 2.1.0

Runtime

~> 0.12.0
>= 1.5.0
 Project Readme

MoIP

Esta Gem permite utilizar a API do MoIP, gateway de pagamentos do IG.

Pagamento direto

O Pagamento Direto é um recurso que a MoIP disponibiliza para aqueles clientes que necessitam de uma flexibilidade maior do que a Integração HTML pode oferecer.

Diferentemente de como é feito com a Integração HTML, seu cliente não precisa ser redirecionado para o site da MoIP para concluir a compra: tudo é feito dentro do ambiente do seu site, dando ao cliente uma maior segurança e confiança no processo.

As formas de pagamento disponibilizadas pela Gem são:

  • Boleto
  • Débito
  • Cartão de Crédito

Instalação

Instale a Gem gem install moip

Adicione a Gem ao Gemfile gem "moip"

Utilização

O MoIP possui uma SandBox de testes que permite a simulação de pagamentos. Para utilizar a Gem com o SandBox, adicione a seguinte configuração no arquivo do environment que deseja utilizar.

config/environments/development.rb

MoIP.setup do |config|
  config.uri = "https://desenvolvedor.moip.com.br/sandbox"
  config.token = SEU_TOKEN
  config.key = SUA_KEY
end

Após realizar os testes na SandBox, você poderá fazer a mudança para o ambiente de produção do MoIP de maneira simples. Basta inserir no arquivo de environment de produção o token e chave que serão utilizados. Por padrão a gem já utiliza a URI de produção do MoIP.

###Crie os dados do pagador

pagador = { :nome => "Luiz Inácio Lula da Silva",
            :login_moip => "lula",
            :email => "presidente@planalto.gov.br",
            :tel_cel => "(61)9999-9999",
            :apelido => "Lula",
            :identidade => "111.111.111-11",
            :logradouro => "Praça dos Três Poderes",
            :numero => "0",
            :complemento => "Palácio do Planalto",
            :bairro => "Zona Cívico-Administrativa",
            :cidade => "Brasília",
            :estado => "DF",
            :pais => "BRA",
            :cep => "70100-000",
            :tel_fixo => "(61)3211-1221" }

###Dados do boleto

boleto = { :valor => "50",
           :id_proprio => "Pag#{rand(1000)}",
           :forma => "BoletoBancario",
           :dias_expiracao => 5,
           :pagador => pagador }

###Checkout

def checkout
  response = MoIP::Client.checkout(boleto)

  # exibe o boleto para impressão
  redirect_to MoIP::Client.moip_page(response["Token"])
end

###Erros

  • MoIP::MissingPaymentTypeError - Quando falta a razão do pagamento na requisição.
  • MoIP::MissingPayerError - Quando falta as informações do pagador na requisição.
  • MoIP::WebServerResponseError - Quando há algum erro ao se enviar a solicitação ao servidor. Normalmente a razão do erro vem como resposta da mensagem.

Futuras implementações

  • Pagamento Simples
  • Pagamento Recorrente

Baseado no projeto do Daniel Lopes.