Download the PHP package matfatjoe/api-santander without Composer
On this page you can find all versions of the php package matfatjoe/api-santander. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download matfatjoe/api-santander
More information about matfatjoe/api-santander
Files in matfatjoe/api-santander
Package api-santander
Short Description Library for Santander Boleto Emission
License MIT
Informations about the package api-santander
Santander Boleto API - PHP Library
Biblioteca PHP para integração com a API de Cobrança do Santander, permitindo o gerenciamento completo de boletos bancários e workspaces.
📋 Índice
- Características
- Requisitos
- Instalação
- Configuração
- Uso Básico
- Módulos
- Exemplos
- Testes
- Documentação da API
- Contribuindo
- Licença
✨ Características
- ✅ Autenticação mTLS - Suporte completo a certificados digitais
- ✅ Gerenciamento de Workspaces - CRUD completo de workspaces
- ✅ Registro de Boletos - Emissão de boletos com todos os campos suportados
- ✅ Consultas Avançadas - Múltiplos métodos de consulta (SONDA, por nosso número, por seu número, lista)
- ✅ Instruções de Boleto - Envio de comandos (descontos, multas, baixas, etc.)
- ✅ Testes Unitários - 17 testes, 46 asserções
- ✅ PSR-4 Autoloading - Estrutura moderna e organizada
- ✅ Type Hints - Código fortemente tipado para PHP 7.4+
📦 Requisitos
- PHP >= 7.4
- Composer
- Extensões PHP:
ext-jsonext-opensslext-curl
- Certificado digital PFX do Santander
- Credenciais da API (Client ID e Client Secret)
🚀 Instalação
Ou clone o repositório:
⚙️ Configuração
1. Certificado Digital
Coloque seu certificado .pfx no diretório do projeto e configure as credenciais:
2. Ambiente
💡 Uso Básico
Autenticação
Criar Workspace
Registrar Boleto
Consultar Boleto
📚 Módulos
🔐 Auth Module
Authenticator- Autenticação mTLSTokenRequest/TokenResponse- Gerenciamento de tokensHttpClientFactory- Cliente HTTP configurado
🏢 Workspace Module
WorkspaceService- CRUD de workspacesCreateWorkspaceRequest/UpdateWorkspaceRequest- RequestsWorkspace/Covenant- Models
📄 Boleto Module
BoletoService- Registro e instruçõesRegisterBoletoRequest/InstructionRequest- RequestsBoleto/Payer/Beneficiary/Discount/Fine/Interest- Models
🔍 Query Module
QueryService- Consultas de boletosQueryFilter- Filtros de consulta- Métodos: SONDA, por nosso número, por seu número, lista
📖 Exemplos
Veja a pasta examples/ para exemplos completos:
example-auth.php- Autenticaçãoexample-workspace.php- Gerenciamento de workspacesexample-boleto.php- Registro de boletosexample-query.php- Consultas
🧪 Testes
Execute os testes unitários:
Ou com Docker:
Cobertura atual: 17 testes, 46 asserções ✅
📘 Documentação da API
🤝 Contribuindo
Contribuições são bem-vindas! Por favor:
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/MinhaFeature) - Commit suas mudanças (
git commit -m 'Add: Minha nova feature') - Push para a branch (
git push origin feature/MinhaFeature) - Abra um Pull Request
📝 Licença
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
🆘 Suporte
- 🐛 Issues: GitHub Issues
Desenvolvido por Matheus Furquim de Camargo