Skip to main content
POST
/
pix
/
qrcode
/
static
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": "pix estático com valor",
    "amount": 9.99,
    "additionalInformation": "Testando qrcode"
}'

{
    "transactionId": "vchargeffeeed94cdbc41",
    "correlationId": "6f388279-0658-4bfa-80e5-e5c405cdb318",
    "amount": 9.99,
    "pixKey": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
    "beneficiaryName": "DELBANK",
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "additionalInfo": "testing qrcode",
    "createdAt": "2024-12-10T11:51:55.306Z",
    "payloadPix": "00026540014br.gov.bcb.pix0114+55119999757340214testing qrcode52040000530398654049.995802BR5907DELBANK6007ARACAJU62250521vchargeffeeed94cdbc41630494CD",
    "base64Image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAPoAAA=="
}
Para entender quando usar este endpoint e ver o passo a passo completo, veja o guia Cobrança Reutilizável (QR Code Estático).

​
Headers

​
x-delbank-api-key
string
required
Sua API key.
​
x-delfinance-account-id
string
required
Número da conta Delfinance.
​
idempotencyKey
string
GUID usado para garantir que a mesma requisição não crie cobranças duplicadas caso seja reenviada.
Este header aparece como obrigatório na documentação original, mas nenhum exemplo de requisição o inclui. Confirmar se é de fato obrigatório antes de publicar.

​
Body

​
correlationId
string
required
Identificador usado para conciliação com o seu sistema. Retornado no webhook de confirmação de pagamento. Deve ser um GUID.
​
description
string
Descrição interna da cobrança.
​
amount
number
Valor da cobrança. Se omitido, o pagador escolhe livremente quanto deseja pagar.
​
pixKey
string
Chave Pix específica a ser usada, caso sua conta tenha mais de uma cadastrada.
​
additionalInformation
string
Texto exibido ao pagador no momento do pagamento. Máximo de 64 caracteres.
Confirmar nome do campo: a documentação original usa additionalInformation na tabela de parâmetros, mas additionalInfo nos exemplos e na resposta.
​
formatResponse
string
Controla o formato da resposta (valor visto em exemplo: PAYLOAD_AND_QRCODE).
Campo não documentado na especificação original — confirmar valores aceitos e comportamento padrão.

​
Response

​
transactionId
string
Identificador único do QR Code.
​
correlationId
string
Identificador de correlação enviado na criação.
​
amount
number
Valor da cobrança, quando definido.
​
pixKey
string
Chave Pix utilizada.
​
beneficiaryName
string
Nome do recebedor.
​
address
object
Endereço do recebedor (cityName, zipCode, uf, state, street).
​
additionalInfo
string
Informação exibida ao pagador.
​
createdAt
string
Data e hora de criação, em formato ISO 8601.
​
payloadPix
string
Payload Pix (BR Code) em texto — o “copia e cola”.
​
base64Image
string
Imagem do QR Code, pronta para exibição, em base64.
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": "pix estático com valor",
    "amount": 9.99,
    "additionalInformation": "Testando qrcode"
}'

{
    "transactionId": "vchargeffeeed94cdbc41",
    "correlationId": "6f388279-0658-4bfa-80e5-e5c405cdb318",
    "amount": 9.99,
    "pixKey": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
    "beneficiaryName": "DELBANK",
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "additionalInfo": "testing qrcode",
    "createdAt": "2024-12-10T11:51:55.306Z",
    "payloadPix": "00026540014br.gov.bcb.pix0114+55119999757340214testing qrcode52040000530398654049.995802BR5907DELBANK6007ARACAJU62250521vchargeffeeed94cdbc41630494CD",
    "base64Image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAPoAAA=="
}