PHPackages                             eloca/iugu-php - 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. [Payment Processing](/categories/payments)
4. /
5. eloca/iugu-php

ActiveLibrary[Payment Processing](/categories/payments)

eloca/iugu-php
==============

Package PHP para integração com a API Iugu (Clean Architecture, PSR-4, PHP 8.1)

v2(1y ago)12MITPHPPHP >=8.1CI failing

Since Jun 23Pushed 1y agoCompare

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

READMEChangelogDependencies (4)Versions (3)Used By (0)

Iugu PHP SDK
============

[](#iugu-php-sdk)

Package PHP 8.1+ para integração com a API da Iugu, seguindo Clean Architecture, PSR-4, tipagem estrita e compatível com Laravel e outros frameworks.

Instalação
----------

[](#instalação)

```
composer require eloca/iugu-php
```

Configuração
------------

[](#configuração)

1. **Copie o arquivo de configuração:**

    - Copie `config/iugu.php` para o diretório `config/` do seu projeto (se não estiver lá).
2. **Defina as variáveis de ambiente:**

    - No Laravel, adicione ao seu `.env`: ```
        IUGU_API_TOKEN=seu_token_aqui
        IUGU_API_BASE_URL=https://api.iugu.com/v1/
        IUGU_API_TIMEOUT=10
        ```
    - Fora do Laravel, defina as variáveis de ambiente no seu sistema ou use um arquivo `.env` e [vlucas/phpdotenv](https://github.com/vlucas/phpdotenv): ```
        // No seu bootstrap.php
        if (file_exists(__DIR__ . '/.env')) {
            $dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
            $dotenv->load();
        }
        ```
3. **Helpers globais:**

    - As funções `env()` e `config()` já estão disponíveis globalmente via autoload do Composer.

Instanciação do Client
----------------------

[](#instanciação-do-client)

**Não é mais necessário passar parâmetros para o client.**

```
use Iugu\Infrastructure\Http\IuguHttpClient;
$client = new IuguHttpClient();
```

A configuração é lida automaticamente de `config/iugu.php` e das variáveis de ambiente.

Exemplos de Uso
---------------

[](#exemplos-de-uso)

Veja a pasta [`examples/`](examples/README.md) para exemplos práticos de todos os casos de uso:

- Faturas (Invoices)
- Clientes (Customers)
- Carnês (Bills)
- Assinaturas (Subscriptions)
- Formas de Pagamento
- Planos
- Multi Split
- Transferências
- Webhooks
- Tokens de Pagamento, API Tokens, Cobrança Direta com 2 Cartões, Zero Auth

Execute qualquer exemplo via terminal:

```
php examples/invoices/create_invoice.php
```

Observações
-----------

[](#observações)

- Helpers `env()` e `config()` disponíveis globalmente via autoload do Composer.
- Consulte a documentação oficial da Iugu para detalhes de cada campo e resposta da API.
- Exemplos práticos em [`examples/`](examples/README.md).

---

Dúvidas ou sugestões? Abra uma issue ou contribua!

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance49

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~0 days

Total

2

Last Release

373d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/19dd6eac301ef02f42f873ab84c1790891be85bd9e2b5256672509460c3a5830?d=identicon)[macielcr7](/maintainers/macielcr7)

---

Top Contributors

[![macielcr7](https://avatars.githubusercontent.com/u/2429749?v=4)](https://github.com/macielcr7 "macielcr7 (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M736](/packages/sylius-sylius)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35789.4k2](/packages/telnyx-telnyx-php)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)

PHPackages © 2026

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