README

Bradesco SDK é uma biblioteca PHP para integração com os serviços do Banco Bradesco, oferecendo suporte a transações como emissão de boletos bancários, geração de PIX e consulta de pedidos e pagamentos.

🚀 Funcionalidades

Emissão de boletos bancários
Geração de cobranças via PIX
Consulta de pedidos por data, status e ID
Listagem de pagamentos
Criptografia e descriptografia de notificações (SPS Notifica)
Configuração simplificada via config/bradesco.php

📦 Instalação

Use o Composer para instalar:

composer require jamesdevbr/bradesco-sdk

Se estiver usando Laravel, adicione o provider (caso não use auto-discovery):

JamesDevBR\BradescoSDK\Providers\BradescoServiceProvider::class,

Publique o arquivo de configuração:

php artisan vendor:publish --provider="JamesDevBR\BradescoSDK\Providers\BradescoServiceProvider"

⚙️ Configuração

O arquivo config/bradesco.php permite definir:

merchant_id
client_id e client_secret
env (sandbox ou production)
encryption_key (para SPS Notifica)
URLs de callback

🧱 Estrutura do SDK

Services\DTOs – DTOs como Buyer, Order, BankSlip, Address
Services\Resources – Recursos para PIX, boletos e pedidos (PixResource, OrderResource)
Services\Traits – Tratamento de erros
Bradesco – Classe principal para autenticação e requisições

✅ Exemplo de uso

use JamesDevBR\BradescoSDK\Services\Bradesco;

$bradesco = new Bradesco();
$order = $bradesco->order()->getById('123456');

if (!$order) {
    echo $bradesco->getErrorMessage();
} else {
    print_r($order);
}

🔐 Notificações criptografadas

Utilize os métodos de Bradesco::encrypt() e Bradesco::decrypt() para lidar com SPS Notifica.

🛠 Requisitos

PHP 7.4 ou superior
Extensões openssl e curl habilitadas

jamesdevbr / bradesco-sdk

Maintainers

Details