{"_id":"@delbank/delfinance-api-sdk","_rev":"8-81294f52d9cd81d8c4a05e532e9d27fb","name":"@delbank/delfinance-api-sdk","dist-tags":{"latest":"0.6.5"},"versions":{"0.5.1":{"name":"@delbank/delfinance-api-sdk","version":"0.5.1","_id":"@delbank/delfinance-api-sdk@0.5.1","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"dist":{"shasum":"c9559ab0a5952297432f98c2e3a318ea370b475c","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.5.1.tgz","fileCount":78,"integrity":"sha512-FEzn1GNPyYERcCWyiSdr+kaOXXP+Me3xgQfygoMLuTxBRUwnfOexmfGzhR07Tc4bsvZEvYEeB4SBuXBOJI34mA==","signatures":[{"sig":"MEUCIHNsPHOaGxLO9NaLQLZJYKMvaAZjRdCsuLeFr8Bah6C2AiEA++l0HAj4pcCqkqpepme8I0OFMhC87rlnFR2yecMxC1A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154682},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"d1fd8ecf22cf5fd7f401931599d06bd668cd4d0f","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk.samples/sample.ts"},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"_npmVersion":"10.8.2","description":"SDK oficial para integração com os serviços financeiros da Delbank, desenvolvido em TypeScript para Node.js 14+.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^14.18.63"},"_npmOperationalInternal":{"tmp":"tmp/delfinance-api-sdk_0.5.1_1773844143612_0.2625236724412545","host":"s3://npm-registry-packages-npm-production"}},"0.5.3":{"name":"@delbank/delfinance-api-sdk","version":"0.5.3","_id":"@delbank/delfinance-api-sdk@0.5.3","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"dist":{"shasum":"dc8de9172057832482bd5a6f2ba57db29e99cb2e","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.5.3.tgz","fileCount":78,"integrity":"sha512-Zttc2r8LJrKj11pcY42cBqw9Qlwfxzn/jICFsVZ+ddml+PL+tJ4TrncbQ8CsxX0H1L4PAh//AOs8WDJX6vMeOQ==","signatures":[{"sig":"MEUCIQDHVRUfrlsSADHPPHrtuRC89Z/Weqj4mGFkNG0M1x1e7AIgAOLj190v4xjNVBzo2M9ZsAsGWfSZvTwrPrvTrwvsKI8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154712},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"f162e0ece28890d8c8756fdd986105d872d98ac4","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk.samples/sample.ts"},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"_npmVersion":"10.8.2","description":"SDK oficial para integração com os serviços financeiros da Delbank, desenvolvido em TypeScript para Node.js 14+.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^14.18.63"},"_npmOperationalInternal":{"tmp":"tmp/delfinance-api-sdk_0.5.3_1773853367552_0.3835217387369141","host":"s3://npm-registry-packages-npm-production"}},"0.5.4":{"name":"@delbank/delfinance-api-sdk","version":"0.5.4","_id":"@delbank/delfinance-api-sdk@0.5.4","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"dist":{"shasum":"83da99c7e206069f697ff113b3f3caa72f1bd3f2","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.5.4.tgz","fileCount":78,"integrity":"sha512-5sT5Wjw+rHfSmAo3wMqQwXnu07G+sxVYG/dZ829du7NIKqNTSXI2iSfaaIVJTsl40vBavFeoxMFSFOnTPO2mPg==","signatures":[{"sig":"MEUCIAYznZ63E+XhiU2/symPQ9MxYi1uYGgF778Cszar3jwsAiEAlEpThTQ6jJN37jgFwfl3o8D6z5qlN3ZnqTRFAP8cwKE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":156669},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"fc097e2119590ae7e04913541fa419af6c79367d","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk.samples/sample.ts"},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"_npmVersion":"10.8.2","description":"SDK oficial para integração com os serviços financeiros da Delbank, desenvolvido em TypeScript para Node.js 14+.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^14.18.63"},"_npmOperationalInternal":{"tmp":"tmp/delfinance-api-sdk_0.5.4_1773952674092_0.7355688578139117","host":"s3://npm-registry-packages-npm-production"}},"0.5.5":{"name":"@delbank/delfinance-api-sdk","version":"0.5.5","_id":"@delbank/delfinance-api-sdk@0.5.5","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"dist":{"shasum":"41e6694ec97dca58788186c800eb752970e96a65","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.5.5.tgz","fileCount":78,"integrity":"sha512-un4slK9dhBAE6RzdZT0V3j/RKCNFtsicDtxAE58zsKwtHV9Cm6xYbOdx85c6UkIRHRz6pWdgT1PiOHYCrTk5Xw==","signatures":[{"sig":"MEUCIQCwUeREfb50kW4nU5+gEgOqC6ypwGsYvnOIMi/2bqISZgIgObQ3vdx+OtAxUf6BwK//b6HFI817aKlvhYb/0MDgUbw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":156669},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"0d6638c845effbd0fc7d73c971d9493a78cc0fdd","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk.samples/sample.ts"},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"_npmVersion":"10.8.2","description":"SDK oficial para integração com os serviços financeiros da Delbank, desenvolvido em TypeScript para Node.js 14+.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^14.18.63"},"_npmOperationalInternal":{"tmp":"tmp/delfinance-api-sdk_0.5.5_1773953426563_0.39493271828080445","host":"s3://npm-registry-packages-npm-production"}},"0.6.1":{"name":"@delbank/delfinance-api-sdk","version":"0.6.1","_id":"@delbank/delfinance-api-sdk@0.6.1","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"dist":{"shasum":"b1e9c402df5c5a75e5ee4d343b4906facba8b0d2","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.6.1.tgz","fileCount":78,"integrity":"sha512-/lADvm6X2Mv+7LN7FkUsVhV8HTNIbiFUwZF6r0xleoaQjN67kIuFDxMEFBbYDP6W16WecoYBKRLIy1zX1oCRPw==","signatures":[{"sig":"MEYCIQC2Npa+07wLT4IPQAtEwWYxvsrHOWKzF4XqztPYiInFHgIhAKUCTtVqjVQH8bt0Uo7Tpa9Mhzd5fyvHrS9LmUPIfs/b","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":163187},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"b2a586ad29260e85f7f2438384d02b8245aff47c","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk/sample.ts"},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"_npmVersion":"10.8.2","description":"SDK oficial para integração com os serviços financeiros da Delbank, desenvolvido em TypeScript para Node.js 14+.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^14.18.63"},"_npmOperationalInternal":{"tmp":"tmp/delfinance-api-sdk_0.6.1_1774375649122_0.44597818044688275","host":"s3://npm-registry-packages-npm-production"}},"0.6.3":{"name":"@delbank/delfinance-api-sdk","version":"0.6.3","_id":"@delbank/delfinance-api-sdk@0.6.3","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"dist":{"shasum":"96247c10f4575f0aae84e81fe8dd3be886e60cc7","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.6.3.tgz","fileCount":78,"integrity":"sha512-UB2w+TfbkLQivv6SDRyo7Y7MGNYBj7lSp7K2HYXXmrBUsNS4XVAfYH0QfngkiKJisWNE1aRr4F9UOlUP5NBc8A==","signatures":[{"sig":"MEUCIAqio+kbUNfxPIT4pHtv6JSRvN2wpvpDzV312TGTARp2AiEAuR4EPhJoMtLmtvN4OPEboJYMnfMUw7Eoh6mm51Y50DU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":167643},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"d6b6fe7ee1c70c2d5211ca3ff10dc36c26f9d38f","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk/sample.ts"},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"_npmVersion":"10.8.2","description":"SDK oficial para integração com os serviços financeiros da Delfinance, desenvolvido em TypeScript para Node.js 14+.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^14.18.63"},"_npmOperationalInternal":{"tmp":"tmp/delfinance-api-sdk_0.6.3_1774462607279_0.5419555880083231","host":"s3://npm-registry-packages-npm-production"}},"0.6.4":{"name":"@delbank/delfinance-api-sdk","version":"0.6.4","_id":"@delbank/delfinance-api-sdk@0.6.4","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"dist":{"shasum":"5ab62203f8714d5babb36cf70de7e04a6d58227c","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.6.4.tgz","fileCount":78,"integrity":"sha512-xZTcl67+IduSywBZOzAEUnL36z0MCfH/XHtvSI0wLC6m4WUTL5c94iaChFQCzCfe6RwDAOh2vEygg/rN3YrnQA==","signatures":[{"sig":"MEYCIQCzB/62NknJJgwbNa60UtoL7bm1EbnL6rVxUUfftU54/wIhAMWHZXf+JV9jIE8fuszgrNrBdOJH9rl52dbAdoFpFrEQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":168637},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"bd8367d8ba9178a7793e85e7f25b7ed8737c2451","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk/sample.ts"},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"_npmVersion":"10.8.2","description":"SDK oficial para integração com os serviços financeiros da Delfinance, desenvolvido em TypeScript para Node.js 14+.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^14.18.63"},"_npmOperationalInternal":{"tmp":"tmp/delfinance-api-sdk_0.6.4_1774463909099_0.060497858102356306","host":"s3://npm-registry-packages-npm-production"}},"0.6.5":{"name":"@delbank/delfinance-api-sdk","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","test:sample":"ts-node -r dotenv/config src/delSdk/sample.ts"},"devDependencies":{"@types/node":"^14.18.63","dotenv":"^17.2.3","ts-node":"^10.9.2","typescript":"^5.9.3"},"version":"0.6.5","_id":"@delbank/delfinance-api-sdk@0.6.5","gitHead":"0f58a942886e0062ae27ab6f00c5b574a89d22de","description":"SDK oficial para integração com os serviços financeiros da Delfinance, desenvolvido em TypeScript para Node.js 14+.","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-P+cEniYsJZrAXcFWoVN/A3qTPFh/rD9EKOcjk+Lq1PAPi7oeWJlmU2m/AZz7NyhKbDXhMfvJCemBPj3A9Q8GPg==","shasum":"958f99f29fa106bbd9529e9c278e83b44aa7a1b7","tarball":"https://registry.npmjs.org/@delbank/delfinance-api-sdk/-/delfinance-api-sdk-0.6.5.tgz","fileCount":78,"unpackedSize":168985,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDE2upOQpkoASjlLZvBzTKGs5TvpOsVSUmCrRx9Jnl/FQIgXGDc20u6nViIDtWSOtusTNKhl3jAZlR4oFQ6JO20haA="}]},"_npmUser":{"name":"delbank","email":"desenvolvimento@delbank.com.br"},"directories":{},"maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/delfinance-api-sdk_0.6.5_1775060113565_0.06980689268247287"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T14:29:03.543Z","modified":"2026-04-01T16:15:13.839Z","0.5.1":"2026-03-18T14:29:03.824Z","0.5.3":"2026-03-18T17:02:47.751Z","0.5.4":"2026-03-19T20:37:54.246Z","0.5.5":"2026-03-19T20:50:26.719Z","0.6.1":"2026-03-24T18:07:29.277Z","0.6.3":"2026-03-25T18:16:47.443Z","0.6.4":"2026-03-25T18:38:29.252Z","0.6.5":"2026-04-01T16:15:13.737Z"},"description":"SDK oficial para integração com os serviços financeiros da Delfinance, desenvolvido em TypeScript para Node.js 14+.","maintainers":[{"name":"delbank","email":"desenvolvimento@delbank.com.br"}],"readme":"# Delfinance SDK - Node.js\n\nSDK oficial para integração com os serviços financeiros da Delfinance, desenvolvido em TypeScript para Node.js 14+.\n\n## Índice\n\n> - [Estrutura do Repositório](#estrutura-do-projeto)\n> - [Requisitos](#requisitos)\n> - [Instalação](#instalação)\n> - [Início Rápido](#-início-rápido)\n> - [Funcionalidades](#funcionalidades)\n> - [Exemplos de Uso](#exemplos-de-uso-typescript)\n> - [Desenvolvimento](#instalação-e-desenvolvimento)\n> - [Documentação Técnica](#-requisitos-adicionais-para-typescript)\n\n## Requisitos\n- Node.js + TypeScript\n\n## Instalação\n\n```Bash\nnpm i @delbank/delfinance-api-sdk \n```\n\n## ⚙️ Configuração (mTLS)\nPara o ambiente de Produção, é obrigatório o uso de certificados mTLS. Certifique-se de ter os arquivos .key e .pem/.crt disponíveis.\n\n## 🛠️ Como usar\n\n## 🚀 Início Rápido\n\nAqui está um exemplo básico para começar a usar o SDK:\n\n```ts\nimport { delSdkOptions } from 'delSdk/abstractions/delSdkOptions';\nimport { delEnvironment } from 'delSdk/abstractions/delEnvironment';\nimport { sdkClientFactory } from 'delSdk/abstractions/sdkClientFactory';\n\n// Configurar opções do SDK\nconst options: delSdkOptions = {\n  environment: delEnvironment.Sandbox, // ou delEnvironment.Production\n  accessToken: 'sua-api-key',\n  accountId: 'sua-account-id',\n  \n  mtlsClientCertificate: \"path/to/cert.pem\", # Obrigatório apenas para produção ⚠️\n  mtlsClientKey: \"path/to/key.pem\" # Obrigatório apenas para produção ⚠️\n};\n\n// Criar cliente dos serviços\nconst client = sdkClientFactory.createServicesClient(options);\n\n// Exemplo 1: Consultar Transferência PIX\nconst transferId = 'E00000000000000000000000000000000';\nconst transferInfo = await client.pixService.getTransfer(transferId);\nconsole.log('Informações da Transferência:', transferInfo);\n\n// Exemplo 2: Inicializar Pagamento PIX\nconst initRequest = { key: '11999999999' };\nconst initResponse = await client.pixService.postPaymentInitalization(initRequest);\nconsole.log('EndToEndId:', initResponse.endToEndId);\n```\n\n## Funcionalidades\n\n### QR Code Estático\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Criar QR Code | `postQRCodeStatic()` | Cria um QR Code PIX estático com ou sem valor fixo |\n| Consultar QR Code | `getQRCodeStatic()` | Busca informações de um QR Code estático por `transactionId` |\n| Listar Pagamentos | `getQRCodeStaticPayment()` | Lista todos os pagamentos recebidos de um QR Code estático |\n| Cancelar QR Code | `patchQRCodeCancel()` | Cancela um QR Code estático previamente criado |\n\n### QR Code Dinâmico Imediato\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Criar QR Code | `postQRCodeDynamicImediate()` | Cria um QR Code dinâmico para pagamento imediato com expiração |\n| Consultar QR Code | `getQRCodeDynamicImediate()` | Busca informações de um QR Code dinâmico por `correlationId` |\n\n**Nota:** Ideal para cobranças imediatas com controle de expiração (padrão: 24 horas).\n\n### QR Code Dinâmico com Vencimento\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Criar QR Code | `postQRCodeDynamicDueDate()` | Cria um QR Code dinâmico com data de vencimento e encargos |\n| Consultar QR Code | `getQRCodeDynamicDueDate()` | Busca informações de um QR Code com vencimento por `transactionId` |\n\n**Nota:** Suporta boleto PIX com vencimento, multas, juros, descontos e abatimentos.\n\n### Transferências e Pagamentos PIX\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Consultar Transferência | `getTransfer()` | Consulta detalhes de uma transferência PIX ou interna por identificador |\n| Consultar Transferência TED | `getTEDTransfer()` | Consulta detalhes de uma transferência TED por identificador |\n| Inicializar Pagamento (DICT) | `postPaymentInitalization()` | Inicializa um pagamento via chave PIX (CPF, CNPJ, e-mail, telefone, EVP) |\n| Inicializar Pagamento (QR Code) | `postQRCodePaymentInitalization()` | Inicializa um pagamento via payload EMV de QR Code |\n| Transferência PIX por Chave | `postKeyPixTransfer()` | Executa transferência PIX no endpoint de transferências usando `endToEndId` e `initiationType: KEY` |\n| Criar Transferência PIX | `postInternalTransfer()` | Executa uma transferência PIX após inicialização |\n| Criar Transferência TED | `postTEDTransfer()` | Executa uma transferência TED para outra instituição financeira |\n\n**Nota:** As transferências requerem inicialização prévia para obter o `endToEndId`.\n\n### Gerenciamento de Chaves PIX\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Gerar Código de Autenticação | `postAuthCreateKey()` | Gera código de autenticação para vincular chave PIX (e-mail ou telefone) |\n| Criar Chave PIX | `postCreateKey()` | Cria/vincula uma nova chave PIX à conta |\n| Listar Chaves PIX | `getKeys()` | Lista todas as chaves PIX vinculadas à conta |\n| Deletar Chave PIX | `deleteKey()` | Remove uma chave PIX vinculada à conta |\n\n**Nota:** Chaves do tipo `EMAIL` e `PHONE` requerem validação via código de autenticação.\n\n### Webhooks\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Criar Webhook | `createWebHook()` | Registra um novo webhook para receber notificações de eventos |\n| Listar Webhooks | `getWebHooks()` | Lista todos os webhooks registrados |\n| Consultar Webhook | `getWebHookById()` | Consulta detalhes de um webhook específico por ID |\n| Atualizar Webhook | `updateWebHook()` | Atualiza configuração de um webhook existente |\n| Deletar Webhook | `deleteWebHookById()` | Remove um webhook registrado |\n\n### Cobranças (Boletos)\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Criar Boleto | `createBankSlip()` | Cria uma cobrança (boleto ou boleto + PIX) |\n| Consultar Boleto | `getBankSlipByCorrelationId()` | Busca detalhes de um boleto por `correlationId` |\n| Listar Boletos | `getListBankSlip()` | Lista boletos com filtros de data e paginação |\n| Atualizar Boleto | `updateBankSlip()` | Atualiza a data de vencimento de um boleto |\n| Cancelar Boleto | `postBaiWhenBankSlip()` | Cancela/anula um boleto pendente |\n\n**Tipos suportados:**\n- `BANKSLIP` - Boleto bancário tradicional\n- `BANKSLIP_PIX` - Boleto com opção de pagamento via PIX\n\n### Pagamento de Boletos\n\n| Funcionalidade | Método | Descrição |\n|---|---|---|\n| Consultar Pagamento | `getPaymentBankSlip()` | Consulta um pagamento de boleto realizado |\n| Pagar Boleto | `postPaymentBankSlip()` | Realiza o pagamento de um boleto via código de barras |\n\n## Exemplos de Uso (TypeScript)\n\nOs exemplos abaixo mostram chamadas usando o `sdkClientFactory` e os nomes reais dos métodos expostos pelos serviços (`pixService`, `webHookService`, `bankSlipService`).\n\n### Criar QR Code Estático\n\n```ts\nconst client = sdkClientFactory.createServicesClient(options);\n\nconst staticReq = {\n  correlationId: 'corr-' + Date.now(),\n  pixKey: '11999999999',\n  amount: 50,\n  bankAccount: '123456',\n  beneficiaryName: 'Minha Empresa'\n};\n\nconst staticRes = await client.pixService.postQRCodeStatic(staticReq);\nconsole.log('QR criado:', staticRes);\n```\n\n### Criar QR Code Dinâmico Imediato\n\n```ts\nconst dynReq = { correlationId: 'corr-' + Date.now(), amount: 100, expiresIn: '3600' };\nconst dynRes = await client.pixService.postQRCodeDynamicImediate(dynReq);\nconsole.log('QR dinâmico imediato:', dynRes);\n```\n\n### Criar QR Code com Vencimento e Encargos\n\n```ts\n// dueDate deve ser maior que data atual\nconst dueReq = { \n    correlationId: 'corr-' + Date.now(),\n    amount: 10,\n    dueDate: \"yyyy-mm-dd\",\n    payer:{\n        name:\"\",\n        document:\"\"\n    }};\nconst dueRes = await client.pixService.postQRCodeDynamicDueDate(dueReq);\nconsole.log('QR com vencimento:', dueRes);\n```\n\n### Consultar QR Code com Vencimento\n\n```ts\nconst txId = 'transaction-id';\nconst qrInfo = await client.pixService.getQRCodeDynamicDueDate(txId);\nconsole.log('QR info:', qrInfo);\n```\n\n### Inicializar Pagamento via Chave PIX\n\n```ts\nconst initReq = { key: 'email@exemplo.com' };\nconst initRes = await client.pixService.postPaymentInitalization(initReq);\nconsole.log('EndToEndId:', initRes.endToEndId);\n```\n\n### Criar Transferência PIX\n\n```ts\n// Imports opcionais para tipagem explícita:\n// import { manualPixTransferRequest } from '@delbank/delfinance-api-sdk/dist/delSdk';\n\n// inicialize para obter endToEndId\nconst init = await client.pixService.postPaymentInitalization({ key: '11999999999' });\n\nconst transferReqInternal = {\n    amount: 100,\n    beneficiaryAccount: 'CONTA_DO_BENEFICIARIO',\n    endToEndId: init.endToEndId\n};\n\nconst transferReqPixManual: manualPixTransferRequest = {\n  amount: 1,\n    pixRecipient: {\n    type: 'MANUAL'\n  },\n  beneficiary: {\n    name: 'teste',\n    number: '12345',\n    branch: '12',\n    participantIspb: '32132132',\n        type: 'CURRENT',\n    holder: {\n      document: '30030030030',\n      name: 'Teste Em Hml',\n      type: 'NATURAL'\n    }\n  }\n};\n\nconst transferResInternal = await client.pixService.postInternalTransfer(transferReqInternal);\nconsole.log('Transferência por conta:', transferResInternal);\n\nconst transferResManual = await client.pixService.postManualPixTransfer(transferReqPixManual);\nconsole.log('Transferência PIX manual:', transferResManual);\n```\n\n### Criar Transferência PIX por Chave (com endToEndId)\n\n```ts\n// Import opcional para tipagem explícita:\n// import { keyPixTransferRequest } from '@delbank/delfinance-api-sdk/dist/delSdk';\n\nconst transferReqPixByKey: keyPixTransferRequest = {\n    amount: 1,\n    endToEndId: 'E3822485720260325135417ReDVw2IBc',\n    initiationType: 'KEY'\n};\n\nconst transferResPixByKey = await client.pixService.postKeyPixTransfer(transferReqPixByKey);\nconsole.log('Transferência PIX por chave:', transferResPixByKey);\n```\n\nRetorno esperado no PIX manual:\n- `status`: `PIX_PROCESSING`\n- `type`: `PIX_MANUAL`\n- `paymentChannel`: `API`\n- `payer` e `beneficiary` com dados de conta/holder/participant\n\n### Criar Transferência TED\n\n```ts\n// Imports necessários para tipagem + enum:\n// import { transferTEDRequest, accountType } from '@delbank/delfinance-api-sdk/dist/delSdk';\n\nconst tedReq: transferTEDRequest = {\n                amount: 500,\n                description: 'Pagamento fornecedor',\n                beneficiary: {\n                    participantIspb: '00000000',\n                    branch: '0001',\n                    number: '123456-7',\n                    holder: {\n                        document: '12345678901',\n                        name: 'João da Silva',\n                    },\n                    type: accountType.CURRENT\n                }\n            };\nconst tedRes = await client.pixService.postTEDTransfer(tedReq);\nconsole.log('TED:', tedRes);\n```\n\n### Inicializar Pagamento via QR Code (payload)\n\n```ts\nconst qrInit = await client.pixService.postQRCodePaymentInitalization({ payload: '00020126580014br.gov.bcb.pix...' });\nconsole.log('QR init:', qrInit);\n```\n\n### Gerenciamento de Chaves PIX\n\n```ts\n// gerar código de autenticação import authEntriesType SMS = 'SMS' (SMS, EMAIL), informar por padrão {{code}} no parametro payload\nconst auth = await client.pixService.postAuthCreateKey({ \n    sender: authEntriesType.SMS,\n    receiver: \"+5579999999999\"\n    payload:\"{{code}}\"});\n// criar chave (entryType: 'EMAIL'|'PHONE'|...)\nconst createKey = await client.pixService.postCreateKey('EMAIL');\n// listar chaves\nconst keys = await client.pixService.getKeys();\n// deletar chave (entryType: = DOCUMENT, EVP, PHONE, EMAIL) import entryType\nawait client.pixService.deleteKey({ entryType: entryType.EMAIL, key: 'user@example.com' });\n```\n\n### Webhooks\n\n```ts\nconst webhookReq = { \n    eventType: 'PIX_RECEIVED', \n    url: 'https://meusite.com.br/webhook/pix', \n    authorizationScheme: 'BEARER', \n    authorization: 'seu-token' \n};\nconst webhookRes = await client.webHookService.createWebHook(webhookReq);\nconst webhooks = await client.webHookService.getWebHooks();\nconst webhook = await client.webHookService.getWebHookById(webhookRes.id);\nawait client.webHookService.updateWebHook({ id: webhookRes.id, eventType: 'PIX_REFUNDED', url: 'https://novo.com.br/pix' });\nawait client.webHookService.deleteWebHookById(String(webhookRes.id));\n```\n\n### Cobranças (Bank Slips)\n\n```ts\nconst chargeReq = { \n    type: 'BANKSLIP_PIX', \n    correlationId: 'corr-' + Date.now(), \n    amount: 150, \n    dueDate: new Date().toISOString(), \n    yourNumber: '12345', \n    payer: { \n        name: 'João Silva', \n        document: '12345678901', \n        email: 'joao@example.com',\n        phone:{\n            prefix: '79',\n            number: '999999999'\n        },\n        address:{\n            zipCode: \"49065800\",\n            neighborhood: \"ascasd\",\n            complement: \"asda\",\n            city: \"ARACAJU\",\n            state: \"SE\",\n            publicPlace: \"sadadasd\",\n            number: \"321\"\n        }\n    } \n};\n\nconst chargeRes = await client.bankSlipService.createBankSlip(chargeReq);\nconst chargeInfo = await client.bankSlipService.getBankSlipByCorrelationId(chargeReq.correlationId);\nconst charges = await client.bankSlipService.getListBankSlip();\nawait client.bankSlipService.updateBankSlip({ correlationId: chargeReq.correlationId, dueDate: new Date().toISOString() });\nawait client.bankSlipService.postBaiWhenBankSlip(chargeReq.correlationId); // cancelar\n```\n\n### Pagamento de Boleto\n\n```ts\nconst payReq = { \n    barCode: '12345678901234567890123456789012345678901244', \n    amount: 150\n};\nconst proof = await client.bankSlipService.postPaymentBankSlip(payReq);\nconsole.log('Comprovante:', proof);\nconst paymentInfo = await client.bankSlipService.getPaymentBankSlip(payReq.barCode);\nconsole.log('Info do pagamento:', paymentInfo);\n```\n\n\n## Métodos Obsoletos\n\nAtualmente não há métodos obsoletos no SDK. Todas as funcionalidades estão ativas e mantidas.\n\n## Estrutura do Projeto\n\n```\nsrc/\n├── delSdk/                     # Biblioteca principal do SDK\n│   ├── abstractions/           # Interfaces, DTOs e contratos\n│   │   ├── delEnvironment.ts  # Ambientes suportados (Sandbox, Production)\n│   │   ├── delSdkOptions.ts   # Opções e configuração do SDK\n│   │   ├── baseUrlResolver.ts # Resolução de URLs por ambiente\n│   │   └── sdkClientFactory.ts # Factory para criar clientes de serviços\n│   ├── services/               # Implementações dos serviços\n│   │   ├── pixService.ts      # Operações PIX (QR codes, transferências, chaves)\n│   │   ├── webHookService.ts  # Gerenciamento de webhooks\n│   │   ├── bankSlipService.ts # Boletos e cobranças\n│   │   ├── httpClient.ts      # Cliente HTTP (get, post, patch, delete)\n│   │   └── common/            # Tipos e interfaces compartilhadas\n│   │       ├── enum/          # Enumerações do domínio\n│   │       │   └── enum.ts    # Tipos e enums reutilizáveis\n│   │       └── interfaces/    # Interfaces de tipos\n│   │           ├── pix.ts     # Tipos PIX\n│   │           ├── bankSlip.ts # Tipos de boletos\n│   │           ├── transfer.ts # Tipos de transferências\n│   │           ├── webHook.ts # Tipos de webhooks\n│   │           └── shared.ts  # Tipos compartilhados\n│   └── index.ts               # Exportações principais do SDK\n└── delSdk.samples/             # Projeto de exemplo\n    └── sample.ts              # Exemplos de uso do SDK\n```\n\n## Instalação e Desenvolvimento\n\nInstale as dependências:\n```bash\nnpm install\n```\n\nPara desenvolvimento com TypeScript:\n```bash\nnpm install --save-dev ts-node typescript @types/node\n```\n\nCompile o código TS:\n```bash\nnpx tsc\n```\n\n## 🧩 Requisitos adicionais para TypeScript\n\nSe você estiver usando este SDK em um projeto TypeScript, certifique-se de instalar os tipos do Node.js para evitar erros de compilação relacionados aos módulos nativos (`https`, `crypto` etc):\n\n\n> ⚠️ **Nota:** Este SDK é projetado para ambientes Node.js e pode não funcionar corretamente em projetos frontend (React, Angular, etc.) sem adaptações específicas.\n\n\n# Notas de Versão\n- 0.6.5 - Pilot","readmeFilename":"README.md"}