Para desenvolvedores

Integre Pix, TED e boletos com exemplos prontos para sua stack.

Use a API Delfinance para gerar QR Codes, disparar transferências Pix e TED, emitir boletos e acompanhar tudo por IDs de correlação e webhooks.

Ver documentação Ver exemplos

Node.js

const response = await fetch('https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/dynamic/', {
  method: 'POST',
  headers: {
    'x-delbank-api-key': process.env.DELBANK_API_KEY,
    'x-delfinance-account-id': process.env.DELFINANCE_ACCOUNT_ID,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    correlationId: crypto.randomUUID(),
    amount: 0.1,
    expiresIn: 1800,
    formatResponse: 'PAYLOAD_AND_QRCODE'
  })
})

const qrCode = await response.json()
console.log(qrCode.payloadPix, qrCode.qrCodeImageBase64)

RESTHTTP simplesContratos JSON para integrar com qualquer backend, worker ou ERP.

WEBHOOKEventos rastreáveisAtualize pedidos, faturas e repasses quando uma transação mudar de estado.

IDEMPCorrelação por operaçãoUse IDs próprios para conciliar seu sistema com os retornos bancários.

Implementações

Copie a ideia, troque as credenciais e conecte sua operação.

Os exemplos abaixo mostram chamadas HTTP diretas em linguagens populares. Ajuste payloads, autenticação e tratamento de erros conforme o contrato da sua conta e o ambiente escolhido.

QR Code Pix

Gerar QR Code dinâmico

Node.js

Crie uma cobrança Pix dinâmica usando os headers e campos exigidos na documentação.

import { randomUUID } from 'node:crypto'

const payload = {
  correlationId: randomUUID(),
  amount: 0.1,
  expiresIn: 1800,
  formatResponse: 'PAYLOAD_AND_QRCODE'
}

const response = await fetch('https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/dynamic/', {
  method: 'POST',
  headers: {
    'x-delbank-api-key': process.env.DELBANK_API_KEY ?? '',
    'x-delfinance-account-id': process.env.DELFINANCE_ACCOUNT_ID ?? '',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
})

if (!response.ok) throw new Error('Falha ao gerar QR Code')

const qrCode = await response.json()
console.log(qrCode.payloadPix, qrCode.qrCodeImageBase64)

Produção

O fluxo base é sempre previsível.

Gere uma cobrança ou transferência com um correlationId, salve a resposta no seu sistema, escute webhooks e reconcilie os eventos usando os identificadores retornados.

01Envie a requisiçãoMonte o payload, informe API key, account id e envie a operação para a API Delfinance.

02Persistência localGuarde correlationId, status, valores e identificadores retornados pela API.

03Webhook e conciliaçãoReceba eventos, valide a assinatura e atualize o estado no seu produto.

Próximo passo

Da primeira chamada ao go-live com suporte técnico.

Abra sua conta, habilite os produtos necessários e use as chaves de API para integrar pagamentos e cobranças com uma instituição financeira regulada.

Crie sua conta