Criar QR Code Estático

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=="
}

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

string

required

Sua API key.

string

required

Número da conta Delfinance.

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

string

required

Identificador usado para conciliação com o seu sistema. Retornado no webhook de confirmação de pagamento. Deve ser um GUID.

string

Descrição interna da cobrança.

number

Valor da cobrança. Se omitido, o pagador escolhe livremente quanto deseja pagar.

string

Chave Pix específica a ser usada, caso sua conta tenha mais de uma cadastrada.

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.

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

string

Identificador único do QR Code.

string

Identificador de correlação enviado na criação.

number

Valor da cobrança, quando definido.

string

Chave Pix utilizada.

string

Nome do recebedor.

object

Endereço do recebedor (cityName, zipCode, uf, state, street).

string

Informação exibida ao pagador.

string

Data e hora de criação, em formato ISO 8601.

string

Payload Pix (BR Code) em texto — o “copia e cola”.

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=="
}

Introdução

Pix

Boleto

Split de Pagamentos

Webhooks

Criar QR Code Estático

Headers

Body

Response

​Headers

​Body

​Response

Headers

Body

Response