PHPackages                             acaodireta-php/iugu - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. acaodireta-php/iugu

ActiveLibrary[API Development](/categories/api)

acaodireta-php/iugu
===================

Biblioteca não oficial de integração com a API da Iugu

v1.2.0(11mo ago)0402MITPHPPHP ^7.3|^8.0

Since Jun 2Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/acaodireta-php/iugu)[ Packagist](https://packagist.org/packages/acaodireta-php/iugu)[ RSS](/packages/acaodireta-php-iugu/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (6)Versions (5)Used By (0)

iugu-php-sdk
============

[](#iugu-php-sdk)

Biblioteca que realiza integração com a API da [Iugu](http://www.iugu.com)

[![StyleCI](https://camo.githubusercontent.com/0b0fe1d2a74d634444c26f4147182f3f5623c41fda60dab3fa2aae815c2c741a/68747470733a2f2f7374796c6563692e696f2f7265706f732f3134303930323034302f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/140902040)[![Maintainability](https://camo.githubusercontent.com/eb8f7fb22b8758040c4cf59785d78dc7c787b13a5e5d82229ee1cdf1f16189fc/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f64346536366639386164303533396530623635642f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/bubbstore/iugu-php-sdk/maintainability)

Instalação via composer
-----------------------

[](#instalação-via-composer)

```
$ composer require acaodireta-php/iugu
```

Serviços
--------

[](#serviços)

Este SDK suporta os seguintes serviços:

- [Clientes](https://dev.iugu.com/reference#testinput-2)
- [Cobrança direta](https://dev.iugu.com/reference#cobranca-direta)
- [Faturas](https://dev.iugu.com/reference#criar-fatura)
- [Métodos de pagamento](https://dev.iugu.com/reference#testinput-3)

[Referência da API](https://dev.iugu.com/reference)

### Configuração

[](#configuração)

Para utilizar este SDK, será necessário utilizar seu token de acesso de sua conta Iugu.

```
use bubbstore\Iugu;
use bubbstore\Iugu\Exceptions\IuguException;
use bubbstore\Iugu\Exceptions\IuguValidationException;

$iugu = new Iugu('SEU_TOKEN');
```

### Clientes

[](#clientes)

#### Criar cliente

[](#criar-cliente)

```
$customer = $iugu->customer()->create([
    'name' => 'Lucas Colette',
    'email' => 'lucas@bubb.com.br',
]);

// Imprime o ID do cliente
echo $customer['id'];
```

#### Atualizar cliente

[](#atualizar-cliente)

```
$customer = $iugu->customer()->update('ID_CLIENTE', [
    'name' => 'John'
]);
```

#### Buscar cliente

[](#buscar-cliente)

```
$customer = $iugu->customer()->find('ID_CLIENTE');

var_dump($customer);
```

#### Excluir cliente

[](#excluir-cliente)

```
$iugu->customer()->delete('ID_CLIENTE');
```

### Cobranças diretas

[](#cobranças-diretas)

#### Criar cobrança com boleto bancário

[](#criar-cobrança-com-boleto-bancário)

```
$charge = $iugu->charge()->create([
            'method' => 'bank_slip',
            'email' => 'lucas@bubb.com.br',
            'order_id' => uniqid(),
            'payer' => [
                'cpf_cnpj' => '65634052076',
                'name' => 'Lucas Colette',
                'phone_prefix' => '11',
                'phone' => '11111111',
                'email' => 'lucas@bubb.com.br',
                'address' => [
                    'street' => 'Foo Bar',
                    'number' => '123',
                    'district' => 'Foo',
                    'city' => 'Foo',
                    'state' => 'SP',
                    'zip_code' => '14940000',
                ],
            ],
            'items' => [
                [
                    'description' => 'Item 1',
                    'quantity' => 1,
                    'price_cents' => 1000
                ],
                [
                    'description' => 'Item 2',
                    'quantity' => 2,
                    'price_cents' => 2000
                ],
            ],
        ]);
```

#### Realizar pagamento de uma fatura com cartão

[](#realizar-pagamento-de-uma-fatura-com-cartão)

```
$charge = $iugu->charge()->create([
    'invoice_id' => '12345678',
    'token' => '0000000000000000' // Token gerado através da lib iugu.js
]);
```

Faturas
-------

[](#faturas)

#### Criar fatura

[](#criar-fatura)

```
$invoice = $iugu->invoice()->create([
    'order_id' => uniqid(),
    'email' => 'lucas@bubb.com.br',
    'due_date' => '2018-07-14',
    'notification_url' => 'https://webhook.site/08703bf2-d408-4f4c-b91c-0bc8e14352b2',
    'fines' => false,
    'per_day_interest' => false,
    'discount_cents' => 500,
    'ignore_due_email' => true,
    'payable_with' => 'bank_slip',
    'items' => [
        [
            'description' => 'Item 1',
            'quantity' => 1,
            'price_cents' => 1000
        ],
        [
            'description' => 'Item 2',
            'quantity' => 2,
            'price_cents' => 2000
        ],
        [
            'description' => 'Frete',
            'quantity' => 1,
            'price_cents' => 1000
        ],
    ],
    'payer' => [
        'cpf_cnpj' => '65634052076',
        'name' => 'Lucas Colette',
        'phone_prefix' => '11',
        'phone' => '11111111',
        'email' => 'lucas@bubb.com.br',
        'address' => [
            'street' => 'Foo Bar',
            'number' => '123',
            'district' => 'Foo',
            'city' => 'Foo',
            'state' => 'SP',
            'zip_code' => '14940000',
        ],
    ],
]);

// Imprime o ID da fatura
echo $invoice['id'];
```

#### Capturar fatura

[](#capturar-fatura)

```
$iugu->invoice()->capture('ID_FATURA');
```

#### Buscar fatura

[](#buscar-fatura)

```
$iugu->invoice()->find('ID_FATURA');
```

#### Reembolsar fatura

[](#reembolsar-fatura)

```
$iugu->invoice()->refund('ID_FATURA');
```

#### Cancelar fatura

[](#cancelar-fatura)

```
$iugu->invoice()->cancel('ID_FATURA');
```

Métodos de pagamento
--------------------

[](#métodos-de-pagamento)

#### Criar método de pagamento

[](#criar-método-de-pagamento)

```
$payment = $iugu->paymentMethod()->create('ID_CLIENTE', [
    'description' => 'Cartão de Crédito',
    'token' => '123456',
]);

// Imprime o ID do pagamento
echo $payment['id'];
```

#### Atualizar método de pagamento

[](#atualizar-método-de-pagamento)

```
$iugu->paymentMethod()->update('ID_CLIENTE', 'ID_METODO_PAGAMENTO', [
    'description' => 'Outra description',
]);
```

#### Buscar método de pagamento

[](#buscar-método-de-pagamento)

```
$iugu->paymentMethod()->find('ID_CLIENTE', 'ID_METODO_PAGAMENTO');
```

#### Excluir método de pagamento

[](#excluir-método-de-pagamento)

```
$iugu->paymentMethod()->delete('ID_CLIENTE', 'ID_METODO_PAGAMENTO');
```

Testando
--------

[](#testando)

```
$ composer test
```

Change log
----------

[](#change-log)

Consulte [CHANGELOG](.github/CHANGELOG.md) para obter mais informações sobre o que mudou recentemente.

Contribuindo
------------

[](#contribuindo)

Consulte [CONTRIBUTING](.github/CONTRIBUTING.md) para obter mais detalhes.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance52

Moderate activity, may be stable

Popularity12

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~369 days

Total

4

Last Release

331d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4f5608bd2848d58a6e268852649c305e7c70191b93ca93c4bd64476c5328e7e7?d=identicon)[acaodireta](/maintainers/acaodireta)

---

Top Contributors

[![lucascolette](https://avatars.githubusercontent.com/u/829381?v=4)](https://github.com/lucascolette "lucascolette (20 commits)")[![acaodireta-php](https://avatars.githubusercontent.com/u/79456160?v=4)](https://github.com/acaodireta-php "acaodireta-php (17 commits)")[![gfucci](https://avatars.githubusercontent.com/u/101299313?v=4)](https://github.com/gfucci "gfucci (2 commits)")[![acaodireta](https://avatars.githubusercontent.com/u/20048916?v=4)](https://github.com/acaodireta "acaodireta (1 commits)")[![danfsd](https://avatars.githubusercontent.com/u/4552181?v=4)](https://github.com/danfsd "danfsd (1 commits)")

---

Tags

iuguinboud

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/acaodireta-php-iugu/health.svg)

```
[![Health](https://phpackages.com/badges/acaodireta-php-iugu/health.svg)](https://phpackages.com/packages/acaodireta-php-iugu)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[bubbstore/iugu-php-sdk

Biblioteca não oficial de integração com a API da Iugu

18123.2k](/packages/bubbstore-iugu-php-sdk)[iugu/iugu

iugu PHP Library

92327.8k4](/packages/iugu-iugu)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)