PHPackages                             celiovmjr/itauboletopix - 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. celiovmjr/itauboletopix

ActiveLibrary[Payment Processing](/categories/payments)

celiovmjr/itauboletopix
=======================

Componente PHP de alto nível para geração de Boletos PIX no Itaú

1.0.5(3mo ago)06MITPHPPHP ^8.3

Since Jan 5Pushed 3mo agoCompare

[ Source](https://github.com/celiovmjr/ItauBoletoPix)[ Packagist](https://packagist.org/packages/celiovmjr/itauboletopix)[ RSS](/packages/celiovmjr-itauboletopix/feed)WikiDiscussions main Synced 1mo ago

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

Itaú Boleto PIX - Biblioteca PHP
================================

[](#itaú-boleto-pix---biblioteca-php)

[![PHP Version](https://camo.githubusercontent.com/e69fc10ad0d3845d44d08b0eeedd6dd7a5bfa4ab872e68e26b131554122d35d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e332d626c75652e737667)](https://php.net/)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Version](https://camo.githubusercontent.com/f83530e81d82db85857033ac2b33bb020f3817c059a08e7010ea8264d4e8e885/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d6f72616e67652e737667)](composer.json)

Biblioteca PHP de alto nível para geração de Boletos PIX no Itaú. Oferece uma interface simples e robusta para integração com a API do Itaú, permitindo criar boletos com PIX de forma rápida e segura.

🚀 Características
-----------------

[](#-características)

- ✅ **Geração de Boletos PIX** - Crie boletos com PIX integrado
- ✅ **Arquitetura Limpa** - Baseada em contratos e DTOs
- ✅ **Validações Automáticas** - CPF, CNPJ e dados obrigatórios
- ✅ **Tratamento de Erros** - Exceções específicas e contextualizadas
- ✅ **Webhooks** - Sistema completo de notificações
- ✅ **Utilitários** - Helpers para datas, documentos e valores
- ✅ **Sandbox/Produção** - Suporte completo aos dois ambientes
- ✅ **PSR-4** - Autoload compatível com Composer
- ✅ **PHP 8.3+** - Aproveita recursos modernos do PHP

📋 Requisitos
------------

[](#-requisitos)

- PHP 8.3 ou superior
- Extensões: `curl`, `json`
- Certificado digital do Itaú (.crt e .key)
- Credenciais da API Itaú (Client ID e Secret)

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

[](#-instalação)

```
composer require celiovmjr/itauboletopix
```

⚙️ Configuração
---------------

[](#️-configuração)

### 1. Variáveis de Ambiente

[](#1-variáveis-de-ambiente)

Copie o arquivo `.env.example` para `.env` e configure:

```
cp .env.example .env
```

```
# Credenciais da API
ITAU_CLIENT_ID=seu-client-id-aqui
ITAU_CLIENT_SECRET=seu-client-secret-aqui

# Certificados
ITAU_CERTIFICATE_PATH=/path/to/certificado.crt
ITAU_CERTIFICATE_KEY_PATH=/path/to/chave.key

# Ambiente
ITAU_SANDBOX=true

# Dados do Beneficiário
ITAU_BENEFICIARY_AGENCY=1111
ITAU_BENEFICIARY_ACCOUNT=0022222
ITAU_BENEFICIARY_ACCOUNT_DIGIT=3
ITAU_PIX_KEY=sua-chave@pix.com.br
```

### 2. Certificados

[](#2-certificados)

Coloque os certificados fornecidos pelo Itaú na pasta `certificates/`:

- `certificado.crt` - Certificado público
- `chave.key` - Chave privada

🎯 Uso Básico
------------

[](#-uso-básico)

### Exemplo Simples

[](#exemplo-simples)

```