Criar QR Code com Vencimento

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/due-date' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "correlationId": "{{$guid}}",
    "amount": 150.00,
    "dueDate": "2025-12-30",
    "formatResponse": "PAYLOAD_AND_QRCODE",
    "payer": {
        "name": "João Alves",
        "document": "07034346593"
    },
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "taxes": {
        "interestType": "PERCENTAGE_PER_MONTH_CALENDAR_DAY",
        "interestAmount": 1,
        "fineType": "PERCENTAGE",
        "fineAmount": 2,
        "discountType": "FIXED_AMOUNT",
        "discountAmount": 10.00
    }
}'

{
    "correlationId": "ac7a235a-1a91-47b0-8da5-0eb75abf3617",
    "transactionId": "wcharge0aac4378c3cf4c37b0ec16c7c",
    "amount": 150.00,
    "originalAmount": 150.00,
    "dueDate": "2025-12-30",
    "maxDaysOverdue": 30,
    "taxes": {
        "interestType": "PERCENTAGE_PER_MONTH_CALENDAR_DAY",
        "interestAmount": 1,
        "fineType": "PERCENTAGE",
        "fineAmount": 2,
        "discountType": "FIXED_AMOUNT",
        "discountAmount": 10.00
    },
    "status": "ACTIVE",
    "revision": 0,
    "payer": {
        "name": "JOAO ALVES",
        "document": "***343465**"
    },
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "createdAt": "2024-12-17T12:22:02.757Z",
    "updatedAt": "2024-12-17T12:22:02.757Z",
    "expiresAt": "2026-01-29T23:59:59.000Z",
    "payloadPix": "00020101021226830014br.gov.bcb.pix2561pix-h.delbank.com.br/v2/cobv/wcharge0aac4378c3cf4c37b0ec16c7c5204000053039865802BR5907DELBANK6007ARACAJU62070503***63040F7B"
}

POST

pix

qrcode

due-date

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/due-date' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "correlationId": "{{$guid}}",
    "amount": 150.00,
    "dueDate": "2025-12-30",
    "formatResponse": "PAYLOAD_AND_QRCODE",
    "payer": {
        "name": "João Alves",
        "document": "07034346593"
    },
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "taxes": {
        "interestType": "PERCENTAGE_PER_MONTH_CALENDAR_DAY",
        "interestAmount": 1,
        "fineType": "PERCENTAGE",
        "fineAmount": 2,
        "discountType": "FIXED_AMOUNT",
        "discountAmount": 10.00
    }
}'

{
    "correlationId": "ac7a235a-1a91-47b0-8da5-0eb75abf3617",
    "transactionId": "wcharge0aac4378c3cf4c37b0ec16c7c",
    "amount": 150.00,
    "originalAmount": 150.00,
    "dueDate": "2025-12-30",
    "maxDaysOverdue": 30,
    "taxes": {
        "interestType": "PERCENTAGE_PER_MONTH_CALENDAR_DAY",
        "interestAmount": 1,
        "fineType": "PERCENTAGE",
        "fineAmount": 2,
        "discountType": "FIXED_AMOUNT",
        "discountAmount": 10.00
    },
    "status": "ACTIVE",
    "revision": 0,
    "payer": {
        "name": "JOAO ALVES",
        "document": "***343465**"
    },
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "createdAt": "2024-12-17T12:22:02.757Z",
    "updatedAt": "2024-12-17T12:22:02.757Z",
    "expiresAt": "2026-01-29T23:59:59.000Z",
    "payloadPix": "00020101021226830014br.gov.bcb.pix2561pix-h.delbank.com.br/v2/cobv/wcharge0aac4378c3cf4c37b0ec16c7c5204000053039865802BR5907DELBANK6007ARACAJU62070503***63040F7B"
}

Para entender quando usar este endpoint e ver o passo a passo completo, veja o guia Cobrança com Vencimento.

Headers

string

required

Sua API key.

string

required

Número da conta Delfinance.

Body

string

required

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

number

required

Valor original da cobrança em reais.

string

required

Data de vencimento no formato YYYY-MM-DD. Após essa data, incidem os encargos configurados em taxes.

object

required

Dados de identificação do pagador.

Show payer

string

required

Nome completo do pagador.

string

required

CPF ou CNPJ do pagador.

object

required

Endereço da transação.

Show address

string

required

Nome da cidade.

string

required

CEP.

string

required

UF do estado (ex: SP).

string

Nome do logradouro.

string

Descrição interna da cobrança.

string

Controla se a imagem do QR Code é retornada. ONLY_PAYLOAD (padrão) ou PAYLOAD_AND_QRCODE.

number

Quantidade de dias após o dueDate em que o QR Code ainda poderá ser pago (com encargos). O padrão é 30 dias.

object

Configuração de encargos e descontos. Só é válido quando dueDate também é informado.

Show taxes

string

Tipo do abatimento (redução incondicional do valor): FIXED_AMOUNT ou PERCENTAGE.

number

Valor ou percentual de abatimento. Aplicado sempre, independentemente da data de pagamento.

string

Tipo do desconto por antecipação: FIXED_AMOUNT ou PERCENTAGE.

number

Valor ou percentual de desconto se pago antes do dueDate. Mutuamente exclusivo com discountsDueDate.

array

Até 3 faixas de desconto escalonadas por data. Mutuamente exclusivo com discountAmount.

Show discountsDueDate[]

string

Data limite para aplicação do desconto (YYYY-MM-DD). Deve ser anterior ao dueDate da cobrança.

number

Valor do desconto em reais para esta faixa.

string

Tipo do juros após o vencimento: FIXED_AMOUNT_CALENDAR_DAY, PERCENTAGE_PER_DAY_CALENDAR_DAY, PERCENTAGE_PER_MONTH_CALENDAR_DAY ou PERCENTAGE_PER_YEAR_CALENDAR_DAY.

number

Valor ou percentual dos juros, conforme o interestType.

string

Tipo da multa aplicada uma vez após o vencimento: FIXED_AMOUNT ou PERCENTAGE.

number

Valor ou percentual da multa.

array

Lista de informações adicionais exibidas ao pagador no app do banco.

Show additionalInfos[]

string

required

Rótulo da informação.

string

required

Valor da informação.

Response

string

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

string

Identificador único do QR Code gerado.

number

Valor efetivo da cobrança (após abatimento, se aplicado).

number

Valor original enviado na criação, antes de qualquer abatimento.

string

Data de vencimento.

number

Dias após o vencimento em que o QR Code ainda é válido para pagamento.

string

Status do QR Code. Valor inicial: ACTIVE.

number

Número de revisões da cobrança (usado pelo padrão BR Code/BACEN).

object

Configuração de encargos e descontos enviada na criação.

object

Dados do pagador (name, document mascarado).

object

Endereço da transação.

string

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

string

Data e hora da última atualização.

string

Data e hora limite para pagamento (calculado como dueDate + maxDaysOverdue).

string

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

string

Imagem do QR Code em base64 (250×250 px). Presente apenas quando formatResponse é PAYLOAD_AND_QRCODE.

array

Informações adicionais enviadas na criação.

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/due-date' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "correlationId": "{{$guid}}",
    "amount": 150.00,
    "dueDate": "2025-12-30",
    "formatResponse": "PAYLOAD_AND_QRCODE",
    "payer": {
        "name": "João Alves",
        "document": "07034346593"
    },
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "taxes": {
        "interestType": "PERCENTAGE_PER_MONTH_CALENDAR_DAY",
        "interestAmount": 1,
        "fineType": "PERCENTAGE",
        "fineAmount": 2,
        "discountType": "FIXED_AMOUNT",
        "discountAmount": 10.00
    }
}'

{
    "correlationId": "ac7a235a-1a91-47b0-8da5-0eb75abf3617",
    "transactionId": "wcharge0aac4378c3cf4c37b0ec16c7c",
    "amount": 150.00,
    "originalAmount": 150.00,
    "dueDate": "2025-12-30",
    "maxDaysOverdue": 30,
    "taxes": {
        "interestType": "PERCENTAGE_PER_MONTH_CALENDAR_DAY",
        "interestAmount": 1,
        "fineType": "PERCENTAGE",
        "fineAmount": 2,
        "discountType": "FIXED_AMOUNT",
        "discountAmount": 10.00
    },
    "status": "ACTIVE",
    "revision": 0,
    "payer": {
        "name": "JOAO ALVES",
        "document": "***343465**"
    },
    "address": {
        "cityName": "ARACAJU",
        "zipCode": "49000000",
        "uf": "SE",
        "state": "SE",
        "street": "LOGRADOURO"
    },
    "createdAt": "2024-12-17T12:22:02.757Z",
    "updatedAt": "2024-12-17T12:22:02.757Z",
    "expiresAt": "2026-01-29T23:59:59.000Z",
    "payloadPix": "00020101021226830014br.gov.bcb.pix2561pix-h.delbank.com.br/v2/cobv/wcharge0aac4378c3cf4c37b0ec16c7c5204000053039865802BR5907DELBANK6007ARACAJU62070503***63040F7B"
}

Introdução

Pix

Boleto

Split de Pagamentos

Webhooks

Criar QR Code com Vencimento

Headers

Body

Response

​Headers

​Body

​Response

Headers

Body

Response