Download the PHP package delfinance/delfinance-api-sdk without Composer
On this page you can find all versions of the php package delfinance/delfinance-api-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download delfinance/delfinance-api-sdk
More information about delfinance/delfinance-api-sdk
Files in delfinance/delfinance-api-sdk
Package delfinance-api-sdk
Short Description SDK oficial da Delfinance para PHP
License
Informations about the package delfinance-api-sdk
Delfinance SDK (PHP)
SDK oficial da Delfinance para PHP, fornecendo uma interface simplificada para integração com os serviços PIX, Transferências, Cobranças e Webhooks da Delfinance.
Índice
- Estrutura do Repositório
- Requisitos
- Instalação
- Início Rápido
- Configuração mTLS
- Funcionalidades
- Exemplos de Uso
- Contribuindo
- Documentação Técnica
Estrutura do Repositório
Requisitos
- PHP 7.4+
- Composer para gerenciamento de dependências
- Extensões PHP:
curl,json
Instalação
Instale via Composer:
Início Rápido
Configuração mTLS
Para ambientes de produção, a autenticação via mTLS (Mutual TLS) é obrigatória em algumas operações. Você deve fornecer os caminhos absolutos para o seu certificado público (.pem) e chave privada (.key ou .pem).
Certifique-se de que os arquivos de certificado sejam legíveis pelo processo do PHP.
Funcionalidades
QR Code Estático (Módulo QR Code)
Classe: Delfinance\QrCode\Services\QrCodeService
| Funcionalidade | Método | Descrição |
|---|---|---|
| Criar QR Code | createStaticQrCode(StaticQrCodeRequest $request) |
Cria um QR Code PIX estático com ou sem valor fixo |
| Consultar QR Code | getStaticQrCode($transactionIdentifier) |
Busca informações de um QR Code estático por identificador |
| Listar Pagamentos | getStaticQrCodePayments($identifier) |
Lista todos os pagamentos recebidos de um QR Code estático |
| Cancelar QR Code | cancelStaticQrCode($transactionIdentifier) |
Cancela um QR Code estático previamente criado |
QR Code Dinâmico Imediato (Módulo QR Code)
Classe: Delfinance\QrCode\Services\QrCodeService
| Funcionalidade | Método | Descrição |
|---|---|---|
| Criar QR Code | createImmediateQrCode(ImmediateQrCodeRequest $request) |
Cria um QR Code dinâmico para pagamento imediato com expiração |
| Consultar QR Code | getImmediateQrCode($id) |
Busca informações de um QR Code dinâmico por ID |
| Cancelar QR Code | cancelImmediateQrCode($id) |
Cancela um QR Code dinâmico imediato |
QR Code Dinâmico com Vencimento (Módulo QR Code)
Classe: Delfinance\QrCode\Services\QrCodeService
| Funcionalidade | Método | Descrição |
|---|---|---|
| Criar QR Code | createDueDateQrCode(DueDateQrCodeRequest $request) |
Cria um QR Code dinâmico com data de vencimento e encargos |
| Consultar QR Code | getDueDateQrCode($id) |
Busca informações de um QR Code com vencimento por ID |
| Cancelar QR Code | cancelDueDateQrCode($id) |
Cancela um QR Code dinâmico com vencimento |
Transferências e Pagamentos (Módulo Transfers)
Classes: Delfinance\Transfers\Services\PixService e Delfinance\Transfers\Services\TransfersService
| Funcionalidade | Método | Serviço | Descrição |
|---|---|---|---|
| Inicializar Pagamento (DICT) | paymentInitialization(PaymentInitializationRequest $request) |
PixService |
Inicializa pagamento via chave PIX (CPF, e-mail, etc.) |
| Inicializar Pagamento (QR Code) | decodeQrCode(DecodeQrCodeRequest $request) |
PixService |
Decodifica/Inicializa pagamento via payload de QR Code |
| Criar Transferência PIX | createTransfer(CreateTransferRequest $request, $idempotencyKey) |
TransfersService |
Executa transferência PIX após inicialização |
| Criar Transferência TED | createTedTransfer(CreateTedTransferRequest $request, $idempotencyKey) |
TransfersService |
Executa transferência TED |
| Consultar Transferência | getTransfer($transferIdentifier) |
TransfersService |
Consulta detalhes de uma transferência por ID |
| Consultar Transferência ted | getTedTransfer($transferIdentifier) |
TransfersService |
Consulta detalhes de uma transferência por ID |
Gerenciamento de Chaves PIX (Módulo Transfers)
Classe: Delfinance\Transfers\Services\PixService
| Funcionalidade | Método | Descrição |
|---|---|---|
| Gerar Código de Autenticação | generateAuthCode(GenerateAuthCodeRequest $request) |
Gera código para vincular chave PIX (e-mail/telefone) |
| Criar Chave PIX | createPixKey(CreatePixKeyRequest $request, $idempotencyKey) |
Cria/vincula uma nova chave PIX à conta |
| Listar Chaves PIX | getPixKeys() |
Lista todas as chaves PIX vinculadas à conta |
| Deletar Chave PIX | deletePixKey(DeletePixKeyRequest $request, $idempotencyKey) |
Remove uma chave PIX vinculada à conta |
Webhooks (Módulo Webhooks)
Classe: Delfinance\Webhooks\Services\WebhookService
| Funcionalidade | Método | Descrição |
|---|---|---|
| Criar Webhook | createWebhook(CreateWebhookRequest $request) |
Registra um novo webhook |
| Listar Webhooks | getAllWebhooks() |
Lista todos os webhooks registrados |
| Consultar Webhook | getWebhookById($id) |
Consulta detalhes de um webhook por ID |
| Atualizar Webhook | updateWebhook(UpdateWebhookRequest $request) |
Atualiza configuração de um webhook |
| Deletar Webhook | deleteWebhook($id) |
Remove um webhook registrado |
Tipos de Eventos Suportados:
CHARGE_PAID- Boleto pagoPIX_RECEIVED- PIX recebido (novo fluxo)PIX_PAYMENT_UPDATED- Atualização de status de pagamento PIXPIX_REFUNDED- Reembolso recebidoPIX_REFUND_PAYMENT_UPDATED- Erro em reembolsoTRANSFER_INTERNAL_CREDITED- Transferência interna recebidaTRANSFER_INTERNAL_DEBITED- Transferência interna enviadaTRANSFER_EXTERNAL_CREDITED- TED recebidaTRANSFER_EXTERNAL_DEBITED- TED enviadaINFRACTION_NOTIFICATION_CREATED- Notificação de infraçãoWHITELABEL_CUSTOMER_DOCUMENTATION_REJECTED- Documentos rejeitadosWHITELABEL_CUSTOMER_APPROVED- Cliente aprovado
Esquemas de Autorização:
NONE- Sem autenticaçãoBASIC- Basic Authentication (username:password base64)BEARER- Bearer Token (JWT ou API Key)HEADER- Header customizado
Cobranças (Módulo Charges)
Classe: Delfinance\Charges\Services\ChargesService
| Funcionalidade | Método | Descrição |
|---|---|---|
| Criar Cobrança | createCharge(CreateChargeRequest $request) |
Cria uma cobrança (Boleto, Boleto+PIX, etc.) |
| Consultar Cobrança | getCharge($correlationId) |
Busca detalhes de uma cobrança por ID de correlação |
| Listar Cobranças | getCharges($startDate, $endDate, $page, $limit) |
Lista cobranças com filtros |
| Atualizar Cobrança | updateCharge($correlationId, UpdateChargeRequest $request) |
Atualiza dados (ex: vencimento) de uma cobrança |
| Cancelar Cobrança | voidCharge($correlationId) |
Cancela uma cobrança pendente |
Pagamentos de Contas (Módulo Charges)
Classe: Delfinance\Charges\Services\ChargesService
| Funcionalidade | Método | Descrição |
|---|---|---|
| Consultar Boleto | getPaymentInfo($paymentIdentifier) |
Consulta informações de boleto por código de barras/linha digitável |
| Pagar Boleto | makePayment(MakePaymentRequest $request, $idempotencyKey) |
Realiza o pagamento de um boleto |
Tipos de Cobrança Suportados:
BANKSLIP- Boleto bancário tradicionalBANKSLIP_PIX- Boleto com opção de pagamento via PIXPIX_STATIC- Cobrança PIX estáticaPIX_DYNAMIC- Cobrança PIX dinâmicaPIX_DYNAMIC_DUEDATE- Cobrança PIX dinâmica com vencimento
Recursos:
- Multa e juros configuráveis (fixo ou percentual)
- Descontos e abatimentos
- Dados completos do pagador e endereço
- Geração automática de código de barras e linha digitável
- QR Code PIX integrado (para tipos BANKSLIPPIX e PIX*)
- Notificação automática ao pagador
Status de Pagamento:
PAID- Pago com sucessoSCHEDULED- Agendado para data futuraCHARGEBACKED- EstornadoPENDING_APPROVAL- Pendente de aprovaçãoSCHEDULE_FAILURE- Falha no agendamento
Exemplos de Uso
Criar QR Code Estático
Criar Cobrança (Boleto + PIX)
Inicializar e Realizar Transferência PIX
Criar Webhook
Consultar e Pagar Boleto
Contribuindo
Para contribuir com o projeto:
- Faça um Fork do projeto
- Crie uma branch para sua feature (
git checkout -b feature/MinhaFeature) - Commit suas mudanças (
git commit -m 'Adiciona MinhaFeature') - Push para a branch (
git push origin feature/MinhaFeature) - Abra um Pull Request
Documentação Técnica
Para mais detalhes sobre os endpoints e parâmetros, consulte a Documentação da API Delfinance.
All versions of delfinance-api-sdk with dependencies
ext-json Version *
ext-curl Version *
ext-mbstring Version *