Download the PHP package flaviomoreir4/laravel-transfeera without Composer
On this page you can find all versions of the php package flaviomoreir4/laravel-transfeera. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download flaviomoreir4/laravel-transfeera
More information about flaviomoreir4/laravel-transfeera
Files in flaviomoreir4/laravel-transfeera
Package laravel-transfeera
Short Description SDK Laravel para integração completa com a API Transfeera — Pagamentos, Recebimentos, Pix Automático, Conta Certa e mais.
License MIT
Informations about the package laravel-transfeera
Pagamentos • Recebimentos • Pix Automático • Conta Certa • Hub de Contas • MED [](https://php.net) [](https://laravel.com) [](LICENSE) [](https://github.com/flaviomoreir4/laravel-transfeera/actions/workflows/ci.yml) [](https://github.com/flaviomoreir4/laravel-transfeera/actions/workflows/ci.yml) [](phpstan.neon) [](rector.php) [](pint.json)
Índice
- Visão Geral
- Instalação
- Configuração
- Uso Rápido
- Recursos por Domínio
- Pagamentos
- Recebimentos
- Pix Automático
- Conta Certa / Validações
- Hub de Contas
- MED / Infrações
- Webhooks
- Tratamento de Erros
- Autenticação & mTLS
- Multi-tenancy (Hub de Contas)
- Comandos Artisan
- Testes
- Documentação
- Contribuição
- Licença
Visão Geral
O Laravel Transfeera SDK é um pacote Laravel nativo que encapsula toda a API da Transfeera — plataforma de pagamentos e recebimentos via Pix, boletos e transferências.
Diferenciais:
- 🪶 Zero dependências externas — usa apenas
illuminate/support,illuminate/httpeilluminate/contracts - 🏗️ Arquitetura por domínios — 24 Resources organizados em 7 domínios de negócio
- 🧱 DTOs tipados —
readonly classpara requests e responses, sem bibliotecas externas - 🔐 mTLS automático — certificação mútua TLS em produção sem configuração manual extra
- 🪝 Webhooks completos — validação HMAC-SHA256, eventos Laravel, controllers pré-registrados
- 🧪 Testado em CI — matrix PHP 8.3/8.4 × Laravel 12/13, PHPStan level 8, Rector
- 🔄 Multi-tenancy — suporte a múltiplas contas digitais via
accountId
Instalação
O Service Provider é registrado automaticamente via auto-discovery do Laravel.
Publique a configuração (opcional):
Configuração
Adicione ao seu .env:
Todas as chaves têm defaults seguros (sandbox, sem credenciais). O SDK valida a configuração no boot e emite warnings no log se algo estiver inconsistente.
⚠️ Produção: O mTLS é obrigatório para as APIs de Pagamentos e Conta Certa em produção. Configure
TRANSFEERA_MTLS_CERT_PATHeTRANSFEERA_MTLS_KEY_PATHapontando para seus certificados.pem.
Uso Rápido
Via Facade
Via Injeção de Dependência
Recursos por Domínio
Pagamentos
| Resource | Métodos | Response DTO |
|---|---|---|
batches() |
create(), list(), get(), update(), delete() |
BatchResponseDTO |
transfers() |
create(), get(), update(), delete() |
TransferResponseDTO |
billets() |
create(), get(), list(), update(), delete() |
BilletResponseDTO |
banks() |
list() |
BankResponseDTO[] |
statement() |
getBalance(), getTransactions() |
StatementResponseDTO / array |
recurrences() |
create(), get(), list(), update(), delete() |
RecurrenceResponseDTO |
pix() |
consultKey(), parseEMV() |
PixResponseDTO / array |
Recebimentos
| Resource | Métodos | Response DTO |
|---|---|---|
pixKeys() |
create(), list(), get(), update(), delete() |
PixKeyResponseDTO[] |
pixQrCodes() |
create(), list(), get() |
PixQrCodeResponseDTO |
pixCashIn() |
list(), get() |
PixCashInResponseDTO[] |
charges() |
create(), list(), get(), update(), delete(), downloadPdfByChargeId() |
ChargeResponseDTO |
paymentLinks() |
create(), list(), get(), delete() |
PaymentLinkResponseDTO |
Pix Automático
| Resource | Métodos | Response DTO |
|---|---|---|
pixAutomaticoAuthorizations() |
create(), list(), get(), revoke() |
AuthorizationResponseDTO |
pixAutomaticoPaymentIntents() |
create(), list(), get(), cancel() |
PaymentIntentResponseDTO |
Conta Certa / Validações
| Resource | Métodos | Response DTO |
|---|---|---|
contaCertaValidations() |
validate(), get(), list(), listBanks() |
ValidationResponseDTO / array |
contaCertaBanks() |
list() |
BankResponseDTO[] |
Hub de Contas
| Resource | Métodos | Response DTO |
|---|---|---|
accounts() |
create(), list(), get(), update(), delete() |
AccountResponseDTO |
MED / Infrações
| Resource | Métodos | Response DTO |
|---|---|---|
infractions() |
analyze(), analyzeBatch(), list(), get(), return(), returnBatch() |
InfractionResponseDTO / array |
Webhooks
O SDK expõe 3 endpoints para receber notificações da Transfeera:
| Rota | Domínio | Controller |
|---|---|---|
POST /webhooks/transfeera/payments |
Pagamentos | WebhookController@payments |
POST /webhooks/transfeera/receivables |
Recebimentos | WebhookController@receivables |
POST /webhooks/transfeera/conta-certa |
Conta Certa | WebhookController@contaCerta |
Validação de assinatura: HMAC-SHA256, automática. Configure os secrets no .env.
Publicar rotas (opcional):
📖 Consulte docs/webhooks.md para detalhes completos.
Tratamento de Erros
Todas as exceptions estendem TransfeeraException:
📖 Consulte docs/exceptions.md para a hierarquia completa.
Autenticação & mTLS
O SDK gerencia o ciclo de vida do token OAuth2 client_credentials automaticamente:
- Cache — token armazenado no cache do Laravel (store configurável)
- Renovação antecipada — renova 60s antes do
expires_inreal - Concorrência — lock de cache evita múltiplas renovações simultâneas
- Multi-tenancy — tokens separados por
accountId
mTLS em produção é aplicado automaticamente nas APIs de Pagamentos e Conta Certa. Configure:
Multi-tenancy (Hub de Contas)
Todos os Resources aceitam $accountId opcional:
O TokenManager adiciona scope=account_id:{accountId} ao token, garantindo escopo correto.
Comandos Artisan
| Comando | Descrição |
|---|---|
php artisan transfeera:install |
Publica configuração e exibe instruções |
php artisan transfeera:check |
Valida credenciais, conectividade e mTLS |
php artisan transfeera:check --silent |
Retorna apenas o código de saída (CI/CD) |
php artisan transfeera:debug |
Diagnóstico completo do SDK |
php artisan transfeera:cache-warm |
Pré-aquece o cache do token OAuth |
Mais detalhes em docs/comandos-artisan.md.
Testes
O CI roda em matrix PHP 8.3/8.4 × Laravel 12/13.
Documentação
| Documento | Conteúdo |
|---|---|
| Pagamentos | Lotes, transferências, boletos, saldo, recorrências |
| Recebimentos | Chaves Pix, QR Codes, Cash-in, cobranças, links |
| Pix Automático | Autorizações, Payment Intents, fluxo completo |
| Conta Certa | Validações, bancos suportados |
| Hub de Contas | Contas digitais, onboarding, tenancy |
| MED / Infrações | Infrações, análise individual/lote, devolução |
| Webhooks | Rotas, secrets, validação HMAC, listeners |
| Exceptions | Hierarquia completa, catch, métodos úteis |
| Middlewares | Config, logging, métricas, Prometheus |
| Erros | Códigos HTTP, handlers, retry |
| Fila | Jobs base, backoff inteligente, Horizon/Pulse |
| Comandos Artisan | Instalação, check, debug, cache-warm |
| Primeiro Pagamento | Passo a passo inicial |
| Primeiro Recebimento | Passo a passo inicial |
| Changelog | Histórico de versões (Keep a Changelog) |
| Roadmap | Planejamento de versões futuras |
Links oficiais da Transfeera:
Contribuição
Veja CONTRIBUTING.md para detalhes.
Licença
MIT © LICENSE para detalhes.
All versions of laravel-transfeera with dependencies
illuminate/support Version ^12.0 || ^13.0
illuminate/http Version ^12.0 || ^13.0
illuminate/contracts Version ^12.0 || ^13.0