Skip to main content
O QR Code Estático carrega informações fixas que não mudam ao longo do tempo: uma vez criado, ele pode ser pago quantas vezes for necessário, por pagadores diferentes, até que você decida cancelá-lo.

​
Quando usar

Ponto de venda físico

Imprima ou exiba o QR Code no seu estabelecimento. O cliente escaneia e paga direto pelo app do banco dele, sem precisar de uma maquininha.

Doações

ONGs e projetos podem manter um único QR Code fixo (ex: num site ou cartaz), recebendo contribuições de valor livre de qualquer pessoa, a qualquer momento.
Se você precisa de um código de uso único com expiração curta, por exemplo, para o checkout de um pedido específico, use a Cobrança Imediata (QR Dinâmico) em vez desta.

​
Passo a passo

1

Crie o QR Code Estático

Chame o endpoint de criação informando pelo menos um correlationId — o identificador que você vai usar para conciliar essa cobrança com o seu sistema.O amount é opcional: se você não enviar, o próprio pagador escolhe quanto quer pagar ao escanear o código. Esse comportamento é o que torna esse modelo ideal para doações.
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/static' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "correlationId": "2f908499-685c-4e36-af04-30567dc08dc5",
    "description": "Doação para o projeto X",
    "additionalInformation": "Toda contribuição ajuda"
}'

{
    "transactionId": "vchargeffeeed94cdbc41",
    "correlationId": "2f908499-685c-4e36-af04-30567dc08dc5",
    "pixKey": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
    "beneficiaryName": "DELBANK",
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "additionalInformation": "Toda contribuição ajuda",
    "createdAt": "2024-12-10T11:51:55.306Z",
    "payloadPix": "00026540014br.gov.bcb.pix0114+55119999757340214testing qrcode52040000530398654049.995802BR5907DELBANK6007ARACAJU62250521vchargeffeeed94cdbc41630494CD",
    "base64Image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAPoAAA=="
}
Se quiser um valor fixo (ex: um produto de preço único), basta informar amount:
{
    "correlationId": "{{$guid}}",
    "description": "Pix estático com valor fixo",
    "amount": 9.99,
    "additionalInformation": "Testando QR Code"
}
Também é possível vincular o QR Code a uma chave Pix específica da sua conta, caso você tenha mais de uma cadastrada:
{
    "pixKey": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
    "correlationId": "{{$guid}}",
    "description": "Pix estático com chave específica",
    "amount": 9.99
}
2

Exiba o QR Code para o pagador

A resposta da criação já retorna tudo que você precisa para exibir a cobrança:
  • base64Image — uma imagem pronta do QR Code, para exibir diretamente numa tela ou impressão.
  • payloadPix — o código “Pix Copia e Cola”, para quando o pagador preferir colar o código manualmente no app do banco em vez de escanear.
Disponibilize sempre as duas opções (imagem e copia-e-cola) na sua interface. Pagadores usando desktop ou apps sem câmera dependem do copia-e-cola.
3

Receba múltiplos pagamentos

Diferente da Cobrança Imediata, o mesmo QR Code Estático pode ser pago repetidas vezes por pessoas diferentes. Cada pagamento realizado dispara um evento de webhook (PIX_RECEIVED) contendo o correlationId que você definiu na criação, use-o para identificar a qual QR Code o pagamento pertence.Veja Processando a confirmação via Webhook para o passo a passo de tratamento desse evento.
4

Consulte os pagamentos recebidos

A qualquer momento você pode consultar o histórico de pagamentos feitos sobre um QR Code específico, útil para reconciliação ou para exibir um extrato de doações recebidas, por exemplo.
cURL
curl --location --request GET 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/static/:identifier/payments' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
Veja a referência completa em Consultar Pagamentos do QR Code Estático.
5

Cancele quando não precisar mais

Quando o QR Code não fizer mais sentido (fim de uma campanha, encerramento de um ponto de venda), cancele-o para impedir novos pagamentos:
cURL
curl -X 'PATCH' 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/static/:identifier/cancel' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
Pagamentos já realizados antes do cancelamento não são afetados.

​
Referência da API

Criar

POST /pix/qrcode/static

Consultar

GET /pix/qrcode/static/:id

Cancelar

PATCH /pix/qrcode/static/:id/cancel