README.md

Iugu

Gem para acesso a API da Iugu

Instalação

Adicione essa linha ao Gemfile de sua aplicação:

gem 'iugu'

Depois execute:

$ bundle

Ou instale você mesmo com:

$ gem install iugu

Exemplos de Uso

# Configure seu api key
Iugu.api_key = SEU_TOKEN_DE_API

Iugu::Charge.create(token: 'TOKEN DO IUGU.JS ou LIB',
                    email: 'endereço do email do cliente',
                    months: 'quantidade de parcelas',
                    items: [
                      {
                        description: 'Item Teste',
                        quantity: '1',
                        price_cents: '1000'
                      }
                    ])

# Exemplo de Gestão de Assinaturas em meia dúzia de linhas.
# Com direito a pagamento recorrente via Cartão ou Boleto.
# No caso de Cartão, recomenda-se vincular um token ao customer (Default Payment Method).
customer = Iugu::Customer.create(email: 'EMAIL DO CLIENTE', name: 'NOME DO CLIENTE')

subscription = Iugu::Subscription.create(plan_identifier: 'basic_plan', customer_id: customer.id)

# Exemplo de Downgrade/Upgrade de Conta
# (Com cálculo automático de diferença de valores entre planos, créditos, etc)
subscription.change_plan('novo_plano')

# Histórico de Pagamentos do Cliente
customer.invoices

Documentação

A API da Iugu tem uma documentação pública e disponível no link.