PHPackages                             cassone200/wscaixa - 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. cassone200/wscaixa

ActiveLibrary[Payment Processing](/categories/payments)

cassone200/wscaixa
==================

Script para integração com a caixa economica , para criação e gestão de boletos registrados.

1.2.1(1mo ago)3115ISCPHPPHP &gt;5.4CI passing

Since Sep 17Pushed 6mo ago1 watchersCompare

[ Source](https://github.com/thiagoedson/wscaixa)[ Packagist](https://packagist.org/packages/cassone200/wscaixa)[ RSS](/packages/cassone200-wscaixa/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)DependenciesVersions (10)Used By (0)

WSCaixa
=======

[](#wscaixa)

[![Codacy Badge](https://camo.githubusercontent.com/880ffbd2a90779b8d80ccbd9d15f94b0d213044b8c18ea80955fd74e269dc359/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f6163376632663964383231623435363961303964616533666365333861323361)](https://www.codacy.com/manual/thiagoedson/wscaixa?utm_source=github.com&utm_medium=referral&utm_content=thiagoedson/wscaixa&utm_campaign=Badge_Grade)[![Code Quality](https://camo.githubusercontent.com/78416f21cf3174320ae272dd99051ee7c051a7df5829dc1dc84d64faced85f45/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652532307175616c6974792d412b2d737563636573732e737667)](https://github.com/thiagoedson/wscaixa)[![Maintained](https://camo.githubusercontent.com/36f1e45079c8a4187cee4a840f9bd220810bef279ce99b87bdb14ff4d4a68569/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61696e7461696e65642d7965732d627269676874677265656e2e737667)](https://github.com/thiagoedson/wscaixa/graphs/commit-activity)[![Security](https://camo.githubusercontent.com/2f32c65c8f5856d638049d8e1ded0b367eb7c6524ed4e048d377a1e3e0416575/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73656375726974792d68617264656e65642d627269676874677265656e2e737667)](docs/SECURITY.md)

[![Version](https://camo.githubusercontent.com/76a77d503967953c558d41fca7ab85c9230c376588808ba2a5c0dd3e01a821a5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e322e302d626c75652e737667)](https://github.com/cassone200/wscaixa)[![Packagist Version](https://camo.githubusercontent.com/adcf06d8ea1a9f6374ec12eff352fe7d74d3b3fe53a9b5fa55059e46d3441c09/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636173736f6e653230302f77736361697861)](https://packagist.org/packages/cassone200/wscaixa)[![Packagist Downloads](https://camo.githubusercontent.com/7df17c290c8a165bf0143c17aa23a377176946cf76538a8bec54860571d2fc28/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636173736f6e653230302f77736361697861)](https://packagist.org/packages/cassone200/wscaixa)[![PHP Version](https://camo.githubusercontent.com/a5356ed586dcf48bfc012c342ea66eb6baeb23190123cc48aa5b443281ed06f7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345352e342d3838393242462e737667)](https://php.net)[![PHP Tested](https://camo.githubusercontent.com/4cf1838a4a7c24ae8aa4bbc3441e61cd30178ef9faf2e6bdf585029a04623489/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702532307465737465642d352e34253230253743253230352e36253230253743253230372e78253230253743253230382e782d3838393242462e737667)](https://php.net)[![Stable](https://camo.githubusercontent.com/1a956613eeacedff433002d943b21af7782c547c24933d5647943c553beaada5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73746162696c6974792d737461626c652d677265656e2e737667)](https://github.com/thiagoedson/wscaixa)

[![License](https://camo.githubusercontent.com/36fe1fc89680fad11617e1322b6b7511ffe059a0e33d56151d02a968c202c013/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4953432d677265656e2e737667)](LICENSE)[![Documentation](https://camo.githubusercontent.com/77510a886b891139ce3f498850cb6515187c2ab3238e3297ed78179905e0faad/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d636f6d706c6574652d626c75652e737667)](docs/)[![API Docs](https://camo.githubusercontent.com/c15ca01946fa57679cfc21c4142a9f41b1f1cb9617e4076e0d332b1d4383fa36/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6170692d646f63756d656e7465642d626c75652e737667)](docs/API.md)

[![SOAP](https://camo.githubusercontent.com/93ad0bc49c0c690049564ddba86ce326d742f39fc43866bc0c9a4bc927b80807/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70726f746f636f6c2d534f41502d6f72616e67652e737667)](https://www.w3.org/TR/soap/)[![XML](https://camo.githubusercontent.com/fb861d6984359f7f0397c23439e7414f35abb2f528be2323fb9f2bfff67c4885/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666f726d61742d584d4c2d6f72616e67652e737667)](https://www.w3.org/XML/)[![Caixa API](https://camo.githubusercontent.com/41d280ea999e2d7a0bcc5bce161ccb42cc13ef752330929c27ad7020a71bf808/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4150492d436169786125323045636f6e2543332542346d6963612d3030363663632e737667)](https://github.com/thiagoedson/wscaixa)[![No Dependencies](https://camo.githubusercontent.com/8e959898650b78b52e7dc5795143b6cc8bd12d748402806d7590b9b742a57ba7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646570656e64656e636965732d7a65726f2d737563636573732e737667)](composer.json)

[![SSL/TLS](https://camo.githubusercontent.com/f74e8a1c76e7566976edd2050424bea27a9bc5d1b32aa148ec70732b9d61610c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53534c253246544c532d76657269666965642d737563636573732e737667)](docs/SECURITY.md)[![Input Validation](https://camo.githubusercontent.com/a853f21d4981f41f10517bf8aa559fb08b0e812738bdeb49d425a197e099cf85/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f696e7075742d76616c6964617465642d737563636573732e737667)](docs/SECURITY.md)[![XML Injection](https://camo.githubusercontent.com/7b0fe0c30acb1ecfd55234e447adedc5d2911a0fe1866378012646e2e561a291/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f584d4c253230696e6a656374696f6e2d70726f7465637465642d737563636573732e737667)](docs/SECURITY.md)[![Security Hardened](https://camo.githubusercontent.com/b835509d4f208ec8b5406a2d95152836851c40f51670518dacae95b3aaf99209/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73656375726974792d68617264656e656425323076312e322e302d627269676874677265656e2e737667)](CHANGELOG.md)

[![PRs Welcome](https://camo.githubusercontent.com/dd0b24c1e6776719edb2c273548a510d6490d8d25269a043dfabbd38419905da/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e737667)](https://github.com/thiagoedson/wscaixa/pulls)[![Made with PHP](https://camo.githubusercontent.com/d78e5f6a542411372d8e550bfe2e0822d6b3b03d8943ec70d29a41f5bfa5c473/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d616465253230776974682d5048502d3838393242462e737667)](https://php.net)[![Last Commit](https://camo.githubusercontent.com/78436ec7dc11f30f8d207eb172fae62261be57f5598f0e2b04df33a6e8da3d31/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f74686961676f6564736f6e2f77736361697861)](https://github.com/thiagoedson/wscaixa/commits)[![Issues](https://camo.githubusercontent.com/3a50dc65b865ecf4d908f653cf10acc169f079a72c3b77972c7a5b2508071433/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f74686961676f6564736f6e2f77736361697861)](https://github.com/thiagoedson/wscaixa/issues)[![GitHub Stars](https://camo.githubusercontent.com/1b455f9f8975369fad351a1d8d17f112ade1b9fdf660ec329cd6f88b9b562f20/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f74686961676f6564736f6e2f777363616978613f7374796c653d736f6369616c)](https://github.com/thiagoedson/wscaixa/stargazers)[![GitHub Forks](https://camo.githubusercontent.com/d0645d039a512fdcaba948d3d94c58dd970bd91472cfa8891f9219f152c9b007/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f74686961676f6564736f6e2f777363616978613f7374796c653d736f6369616c)](https://github.com/thiagoedson/wscaixa/network/members)

Biblioteca PHP para integração com o webservice da Caixa Econômica Federal para criação, registro e consulta de boletos bancários.

🔒 Segurança - Versão 1.2.0
--------------------------

[](#-segurança---versão-120)

**Todas as vulnerabilidades críticas foram corrigidas!**

✅ Verificação SSL/TLS habilitada ✅ Validação robusta de entrada de dados ✅ Proteção contra XML Injection ✅ Tratamento seguro de erros ✅ Timeouts configurados

[Ver detalhes completos de segurança](docs/SECURITY.md) | [Ver changelog](CHANGELOG.md)

📋 Índice
--------

[](#-índice)

- [Sobre](#sobre)
- [Características](#caracter%C3%ADsticas)
- [Requisitos](#requisitos)
- [Instalação](#instala%C3%A7%C3%A3o)
- [Uso Rápido](#uso-r%C3%A1pido)
- [Documentação](#documenta%C3%A7%C3%A3o)
- [Exemplos](#exemplos)
- [Contribuindo](#contribuindo)
- [Autor](#autor)
- [Licença](#licen%C3%A7a)

🔍 Sobre
-------

[](#-sobre)

WSCaixa é uma biblioteca PHP leve (sem dependências externas) que facilita a integração com o webservice SOAP da Caixa Econômica Federal para gestão de boletos bancários registrados. Ideal para sistemas de e-commerce, ERPs e aplicações que necessitam emitir boletos bancários.

**Baseado no código original de:** [wagnermengue](https://github.com/wagnermengue)

✨ Características
-----------------

[](#-características)

- ✅ **Inclusão de Boletos:** Registro de novos boletos na Caixa
- ✅ **Consulta de Boletos:** Consulta de boletos já registrados
- ✅ **Sem Dependências:** Usa apenas bibliotecas nativas do PHP
- ✅ **Autenticação SHA256:** Geração automática de hash de autenticação
- ✅ **Suporte a Descontos:** Configuração de descontos no boleto
- ✅ **Juros e Multa:** Configuração de juros e multa por atraso
- ✅ **SOAP XML:** Construção automática de requisições SOAP
- ✅ **Ambiente Produção/Homologação:** Suporte a ambos ambientes
- 🔒 **Segurança Hardened:** Verificação SSL, validação de dados e proteção contra injeções
- 🔒 **Validação Automática:** CPF, CNPJ, valores e formatos validados automaticamente
- 🔒 **Sanitização XML:** Proteção contra XML Injection attacks

📦 Requisitos
------------

[](#-requisitos)

- PHP &gt;= 5.4
- Extensões PHP:
    - `php-curl` - Para requisições HTTP
    - `php-xml` - Para manipulação de XML
    - `php-soap` - Para comunicação SOAP
    - `php-json` - Para manipulação JSON

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

[](#-instalação)

### Via Composer

[](#via-composer)

```
composer require cassone200/wscaixa
```

### Instalação Manual

[](#instalação-manual)

```
git clone https://github.com/cassone200/wscaixa.git
cd wscaixa
composer install
```

🎯 Uso Rápido
------------

[](#-uso-rápido)

```
