iugu - Biblioteca para Ruby
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
.rspec
.travis.yml
CHANGELOG.md
Gemfile
LICENSE.txt
README.md
Rakefile
iugu.gemspec

README.md

Iugu

Build status Gem version Downloads

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.