Skip to main content
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

​
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 original da cobrança em reais.
​
dueDate
string
required
Data de vencimento no formato YYYY-MM-DD. Após essa data, incidem os encargos configurados em taxes.
​
payer
object
required
Dados de identificação do pagador.
​
address
object
required
Endereço da transação.
​
description
string
Descrição interna da cobrança.
​
formatResponse
string
Controla se a imagem do QR Code é retornada. ONLY_PAYLOAD (padrão) ou PAYLOAD_AND_QRCODE.
​
maxDaysOverdue
number
Quantidade de dias após o dueDate em que o QR Code ainda poderá ser pago (com encargos). O padrão é 30 dias.
​
taxes
object
Configuração de encargos e descontos. Só é válido quando dueDate também é informado.
​
additionalInfos
array
Lista de informações adicionais exibidas 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 efetivo da cobrança (após abatimento, se aplicado).
​
originalAmount
number
Valor original enviado na criação, antes de qualquer abatimento.
​
dueDate
string
Data de vencimento.
​
maxDaysOverdue
number
Dias após o vencimento em que o QR Code ainda é válido para pagamento.
​
status
string
Status do QR Code. Valor inicial: ACTIVE.
​
revision
number
Número de revisões da cobrança (usado pelo padrão BR Code/BACEN).
​
taxes
object
Configuração de encargos e descontos enviada na criação.
​
payer
object
Dados do pagador (name, document mascarado).
​
address
object
Endereço da transação.
​
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 limite para pagamento (calculado como dueDate + maxDaysOverdue).
​
payloadPix
string
Payload Pix (BR Code) em texto — o “copia e cola”.
​
qrCodeImageBase64
string
Imagem do QR Code em base64 (250×250 px). Presente apenas quando formatResponse é PAYLOAD_AND_QRCODE.
​
additionalInfos
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"
}