Project

iugu

0.07
No release in over 3 years
Low commit activity in last 3 years
There's a lot of open issues
Iugu API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.5
>= 0

Runtime

 Project Readme

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.