Skip to main content
POST
/
pix
/
qrcode
/
dynamic
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/dynamic' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "correlationId": "{{$guid}}",
    "amount": 99.90,
    "expiresIn": 1800,
    "formatResponse": "PAYLOAD_AND_QRCODE"
}'

{
    "correlationId": "40ede975-031d-4517-bdd4-31472d3f00a4",
    "transactionId": "vchargeffab8b4c963344c283e491f5e",
    "amount": 99.90,
    "allowChangeAmount": false,
    "expiresIn": 1800,
    "status": "ACTIVE",
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "createdAt": "2024-12-10T13:19:26.501Z",
    "updatedAt": "2024-12-10T13:19:26.501Z",
    "expiresAt": "2024-12-10T13:49:26.501Z",
    "payloadPix": "00020101021226820014br.gov.bcb.pix2560pix-h.delbank.com.br/v2/cob/vchargeffab8b4c963344c283e491f5e5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304CB42",
    "qrCodeImageBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAPoA..."
}
Para entender quando usar este endpoint e ver o passo a passo completo, veja o guia Cobrança Imediata (QR Code Dinâmico).

​
Headers

​
x-delbank-api-key
string
required
Sua API key.
​
x-delfinance-account-id
string
required
Número da conta Delfinance.

​
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.
​
amount
number
required
Valor da cobrança em reais.
​
description
string
Descrição interna da cobrança.
​
expiresIn
number
Prazo de expiração do QR Code em segundos, contados a partir da criação. O padrão é 86400 (24 horas).
​
formatResponse
string
Controla se a imagem do QR Code é retornada na resposta. Valores aceitos:
  • ONLY_PAYLOAD (padrão) — retorna apenas o payloadPix.
  • PAYLOAD_AND_QRCODE — retorna também qrCodeImageBase64 com a imagem pronta (250×250 px).
​
payer
object
Dados do pagador esperado.
​
address
object
Endereço da transação. Se omitido, o padrão é Aracaju/SE.
​
additionalInfos
array
Lista de informações adicionais exibidas ao pagador no app do banco.
​
splitInstructions
array
Instruções de split: distribuição automática de parte do valor para outra conta no momento do recebimento. O amount total das divisões não pode ultrapassar 50% do valor da cobrança, e o valor da cobrança deve ser maior que R$ 1,00.
​
finalBeneficiary
object
Dados do beneficiário final da transação. Usado por gateways e subadquirentes para identificar o recebedor real — essa informação é exibida ao pagador no app do banco.

​
Response

​
correlationId
string
Identificador de correlação enviado na criação.
​
transactionId
string
Identificador único do QR Code gerado.
​
amount
number
Valor da cobrança.
​
allowChangeAmount
boolean
Indica se o pagador pode alterar o valor ao pagar.
​
expiresIn
number
Prazo de expiração em segundos.
​
status
string
Status do QR Code. Valor inicial: ACTIVE.
​
payer
object
Dados do pagador, quando informados na criação.
​
address
object
Endereço da transação (cityName, zipCode, uf, state, street).
​
createdAt
string
Data e hora de criação, em formato ISO 8601.
​
updatedAt
string
Data e hora da última atualização.
​
expiresAt
string
Data e hora exata de expiração, em formato ISO 8601.
​
payloadPix
string
Payload Pix (BR Code) em texto — o “copia e cola”.
​
qrCodeImageBase64
string
Imagem do QR Code pronta para exibição, em base64 (250×250 px). Presente apenas quando formatResponse é PAYLOAD_AND_QRCODE.
​
additionalInfos
array
Informações adicionais enviadas na criação.
​
splitInstructions
array
Instruções de split enviadas na criação.
​
finalBeneficiary
object
Dados do beneficiário final, quando informado na criação.
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/dynamic' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "correlationId": "{{$guid}}",
    "amount": 99.90,
    "expiresIn": 1800,
    "formatResponse": "PAYLOAD_AND_QRCODE"
}'

{
    "correlationId": "40ede975-031d-4517-bdd4-31472d3f00a4",
    "transactionId": "vchargeffab8b4c963344c283e491f5e",
    "amount": 99.90,
    "allowChangeAmount": false,
    "expiresIn": 1800,
    "status": "ACTIVE",
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "createdAt": "2024-12-10T13:19:26.501Z",
    "updatedAt": "2024-12-10T13:19:26.501Z",
    "expiresAt": "2024-12-10T13:49:26.501Z",
    "payloadPix": "00020101021226820014br.gov.bcb.pix2560pix-h.delbank.com.br/v2/cob/vchargeffab8b4c963344c283e491f5e5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304CB42",
    "qrCodeImageBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAPoA..."
}