PHPackages                             fernandocvargas/bradesco-api-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. [API Development](/categories/api)
4. /
5. fernandocvargas/bradesco-api-php

ActiveLibrary[API Development](/categories/api)

fernandocvargas/bradesco-api-php
================================

SDK PHP para a API de Registro de Boletos do Bradesco

0544PHP

Since May 8Pushed 4y ago1 watchersCompare

[ Source](https://github.com/fernandocvargas/bradesco-api-php)[ Packagist](https://packagist.org/packages/fernandocvargas/bradesco-api-php)[ RSS](/packages/fernandocvargas-bradesco-api-php/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (3)Used By (0)

Bradesco API - SDK PHP
======================

[](#bradesco-api---sdk-php)

SDK PHP para a API de Registro On-line de Boletos de Cobrança Bradesco

Descrição
---------

[](#descrição)

SDK em PHP para integração com os serviços de Registro On-line de Boletos de Cobrança Bradesco

[Manual Registro de Boleto Bancario Online Dez17.pdf](https://drive.google.com/file/d/1ybt1Z-C58qoigKe_Ik96h-WDKXOfDjIw/view?usp=sharing)

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

[](#instalação)

Via Composer

```
composer require fernandcvargas/bradesco-api-php
```

Parâmetros
----------

[](#parâmetros)

ParâmetroObrigatórioPadrãoComentárioBRADESCO\_CERT\_PATHSimnullCaminho do certificado PKCS#7 em formato .pfxBRADESCO\_CERT\_PASSWORDSimnullSenha do certificadoBRADESCO\_SANDBOXNãotrueUtilizar ambiente de Homologação (true) ou Produção (false)BRADESCO\_TIMEOUTNão30Timeout em segundos para estabelecer conexão com a APIBRADESCO\_FOLDER\_PATHNão""Caminho para esta biblioteca gerar arquivos temporários, necessários parar realizar a criptografia. Os arquivos são criados com hash randômica e excluídos automaticamente, sem a necessidade de se preocupar em limpá-los periodicamente.Como usar
---------

[](#como-usar)

1. Os parâmetros podem ser definidos por váriaveis de ambiente:

```
putenv('BRADESCO_SANDBOX=true');
putenv('BRADESCO_TIMEOUT=20');
putenv('BRADESCO_CERT_PATH=myCertificate.pfx');
putenv('BRADESCO_CERT_PASSWORD=myPassword');
```

ou passados por `array`:

```
Bradesco::setParams([
    'BRADESCO_SANDBOX' => true,
    'BRADESCO_TIMEOUT' => 20,
    'BRADESCO_CERT_PATH' => 'myCertificate.pfx',
    'BRADESCO_CERT_PASSWORD' => 'myPassword'
]);
```

2. Em seguida, basta utilizar o comando abaixo passando os dados do boleto em formato `array`.

```
$boleto = \BradescoApi\BankSlip::create($data);
```

Normalização de dados
---------------------

[](#normalização-de-dados)

Foram adicionadas diversas funções para normalizar os dados conforme exigido pela API do Bradesco:

- Campos ausentes são inseridos com seus respectivos valores padrão (página 19 do manual).
- Valores em `null` são trocados para vazio "".
- Valores em `integer` ou `float` são convertidos para string.
- Valores com caracteres especiais (ção) são substituídos por caracteres básicos (cao).
- Valores de nome e endereço do pagador são recortados para a quantidade máxima de caracteres.
- Datas no formato "yyyy-mm-dd" ou "dd/mm/yyy" são normalizadas para "dd.mm.yyyy".
- Moedas no formato 14.90 ou "14,90" são normalizadas para "1490".
- Números de CPF e CNPJ "123.456.789-01" são normalizadas para "00012345678901".

Exemplo de implementação
------------------------

[](#exemplo-de-implementação)

```
error_reporting(E_ALL);
ini_set('display_errors', 1);

require __DIR__.'/vendor/autoload.php';

putenv('BRADESCO_SANDBOX=true');
putenv('BRADESCO_TIMEOUT=20');
putenv('BRADESCO_CERT_PATH=myCertificate.pfx');
putenv('BRADESCO_CERT_PASSWORD=myPassword');

use BradescoApi\Exceptions\BradescoApiException;
use BradescoApi\Exceptions\BradescoRequestException;

$data = [
  "nuCPFCNPJ" => "123456789",
  "filialCPFCNPJ" => "0001",
  "ctrlCPFCNPJ" => "39",
  "idProduto" => "09",
  "nuNegociacao" => "123400000001234567",
  "nuCliente" => "123456",
  "dtEmissaoTitulo" => "25/05/2017",
  "dtVencimentoTitulo" => "2017-06-20",
  "vlNominalTitulo" => 100.00,
  "cdEspecieTitulo" => "04",
  "nomePagador" => "Cliente Teste",
  "logradouroPagador" => "Rua Teste",
  "nuLogradouroPagador" => "90",
  "complementoLogradouroPagador" => null,
  "cepPagador" => "12345",
  "complementoCepPagador" => "500",
  "bairroPagador" => "Bairro Teste",
  "municipioPagador" => "Cidade Teste",
  "ufPagador" => "SP",
  "nuCpfcnpjPagador" => "549.435.260-98",
];

try {
    $bankSlip = \BradescoApi\BankSlip::create($data);
    print_r($bankSlip);
} catch (BradescoApiException $e) { // erros retornados pela API Bradesco
    echo sprintf("%s (%s)", $e->getMessage(), $e->getErrorCode());
} catch (BradescoRequestException $e) { // erros de servidor (erros HTTP 4xx e 5xx)
    eecho sprintf("%s (%s)", $e->getMessage(), $e->getErrorCode());
} catch (\Exception $e) { // demais erros
    echo $e->getMessage();
}
```

Testes
------

[](#testes)

Caso queira contribuir, por favor, implementar testes de unidade em PHPUnit.

Para executar:

1. Faça uma cópia de phpunit.xml.dist em phpunit.xml na raíz do projeto
2. Altere os parâmtros ENV com os dados de seu acesso
3. Execute o comando abaixo no terminal dentro da pasta deste projeto:

```
composer test
```

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 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/04d9597bf79dd1b57654ea048e5d4ab77ef6f0b8a1d49d82214148e9cd70f2f7?d=identicon)[fernandocvargas](/maintainers/fernandocvargas)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/fernandocvargas-bradesco-api-php/health.svg)

```
[![Health](https://phpackages.com/badges/fernandocvargas-bradesco-api-php/health.svg)](https://phpackages.com/packages/fernandocvargas-bradesco-api-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M478](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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