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"
}
Pix
Criar QR Code com Vencimento
Cria uma cobrança Pix com data de vencimento, suporte a juros, multa, abatimento e desconto por antecipação.
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
object
required
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
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
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
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"
}