PHPackages                             marcelo-correa/openboleto - 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. marcelo-correa/openboleto

ActiveLibrary[Payment Processing](/categories/payments)

marcelo-correa/openboleto
=========================

Biblioteca para geração de boletos bancários. Extendendo projeto de Kriansa

041PHP

Since Oct 23Pushed 8y ago1 watchersCompare

[ Source](https://github.com/MarceloSantosCorrea/marcelo-correa-openboleto)[ Packagist](https://packagist.org/packages/marcelo-correa/openboleto)[ RSS](/packages/marcelo-correa-openboleto/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

OpenBoleto [![Stories in Ready](https://camo.githubusercontent.com/7c3f7ee7d749ba3c5640eba4e6f057805a356565afca1aafa2a91bd523e7866c/687474703a2f2f62616467652e776166666c652e696f2f6b7269616e73612f6f70656e626f6c65746f2e706e67)](http://waffle.io/kriansa/openboleto) [![Build Status](https://camo.githubusercontent.com/bf0c1714db58ae0f6eb8982a09e2f00366f3e9eccb43db95c0e4ee702998b789/68747470733a2f2f6170692e7472617669732d63692e6f72672f6b7269616e73612f6f70656e626f6c65746f2e706e67)](https://travis-ci.org/kriansa/openboleto)
=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#openboleto--)

O OpenBoleto é uma biblioteca de código aberto para geração de boletos bancários, um meio de pagamento muito comum no Brasil. O foco é ser simples e ter uma arquitetura compatível com os recursos mais modernos do PHP.

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

[](#instalação)

### Composer

[](#composer)

Se você já conhece o **Composer** (o que é extremamente recomendado), simplesmente adicione a dependência abaixo à diretiva *"require"* seu **composer.json**:

```
"kriansa/openboleto": "dev-master"

```

Ou, caso você deseje usar o release v1.0 (12/08/2013)

```
"kriansa/openboleto": "v1.0"

```

\###PSR-0 autoloader Hoje praticamente qualquer framework utiliza deste padrão, então você deve [baixar](https://github.com/kriansa/openboleto/archive/master.zip) o OpenBoleto, colocar em uma pasta específica (geralmente *lib* ou *vendor*) e procurar na documentação do seu framework para fazer com que o seu autoloader aponte o namespace **OpenBoleto** para a pasta **src** do OpenBoleto.

\###Stand-alone library Se você quer simplesmente baixar e dar um include, também é muito simples. Primeiro [baixe](https://github.com/kriansa/openboleto/archive/master.zip) (ou dê clone no repositório), e coloque em uma pasta específica. Depois, dê um include no arquivo **autoloader.php** e voilá!

Gerando boletos
---------------

[](#gerando-boletos)

Essa é a melhor parte. Não poderia ser mais simples, veja um exemplo básico:

```
use OpenBoleto\Banco\BancoDoBrasil;
use OpenBoleto\Agente;

$sacado = new Agente('Fernando Maia', '023.434.234-34', 'ABC 302 Bloco N', '72000-000', 'Brasília', 'DF');
$cedente = new Agente('Empresa de cosméticos LTDA', '02.123.123/0001-11', 'CLS 403 Lj 23', '71000-000', 'Brasília', 'DF');

$boleto = new BancoDoBrasil(array(
    // Parâmetros obrigatórios
    'dataVencimento' => new DateTime('2013-01-24'),
    'valor' => 23.00,
    'sequencial' => 1234567, // Para gerar o nosso número
    'sacado' => $sacado,
    'cedente' => $cedente,
    'agencia' => 1724, // Até 4 dígitos
    'carteira' => 18,
    'conta' => 10403005, // Até 8 dígitos
    'convenio' => 1234, // 4, 6 ou 7 dígitos
));

echo $boleto->getOutput();
```

Sim, só isso! Lembre-se de que cada banco possui alguma particularidade, mas em geral são estes parâmetros os obrigatórios. Na pasta **samples** possui um exemplo funcional de cada banco, você pode verificar lá quais são os parâmetros necessários para cada banco.

Bancos suportados
-----------------

[](#bancos-suportados)

Atualmente o OpenBoleto funciona com os bancos abaixo:

- Banco de Brasília (BRB)
- Banco do Brasil
- Bradesco
- Caixa (SIGCB)
- Itaú
- Santander
- Unicred

Toda contribuição é bem vinda. Se você deseja adaptar o OpenBoleto a algum outro banco, fique à vontade para explorar o código, veja como é bastante simples integrar qualquer banco à biblioteca.

Licença
-------

[](#licença)

- MIT License

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

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.

### Community

Maintainers

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

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/marcelo-correa-openboleto/health.svg)

```
[![Health](https://phpackages.com/badges/marcelo-correa-openboleto/health.svg)](https://phpackages.com/packages/marcelo-correa-openboleto)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

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