Cobrança Reutilizável (QR Code Estático)

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

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
}

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.

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.

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.

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

Introdução

Autenticação

Receber via Pix (Pix Cash-in)

Pagar via Pix (Pix Cash-out)

Cobranças via Boleto

Split de Pagamentos

Webhooks

Cobrança Reutilizável (QR Code Estático)

Quando usar

Ponto de venda físico

Doações

Passo a passo

Referência da API

Criar

Consultar

Cancelar

​Quando usar

Ponto de venda físico

Doações

​Passo a passo

​Referência da API

Criar

Consultar

Cancelar

Quando usar

Passo a passo

Referência da API