eloca/iugu-php

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

v2 2025-06-24 17:36 UTC

Requires

• php: >=8.1
• guzzlehttp/guzzle: ^7.0
• psr/http-client: ^1.0
• psr/http-message: ^1.0

Requires (Dev)

• phpunit/phpunit: ^9.5

MIT

• Maciel Sousa

README

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

composer require eloca/iugu-php

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:

     // 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

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

Veja a pasta examples/ 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

• 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/.

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