curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/due-date' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"key": "e7c3d5f2-4a1b-4c3d-9d15-1b2c3d4e5f60",
"beneficiaryAddress": "Av. Paulista, 1000",
"city": "Sao Paulo",
"state": "SP",
"zipCode": "01310100",
"payerName": "Joao da Silva",
"dueDate": "2026-11-10",
"daysAfterDue": 30,
"originalAmount": 189.90,
"recurrenceData": {
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-12-10",
"debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
"amount": 189.90,
"contractNumber": "MAT-00012345",
"contractDescription": "Mensalidade escolar",
"retry": "ALLOWED"
}
}'
{
"documentId": "01000000-3353-6e2c-12c9-08de9f179025",
"revision": "0",
"qrCodeImageBase64": "iVBORw0KGgoAAAANSUhEUgAAASQAAAEkAQAAAACugnFBAAAD60lEQVR4nO2a...",
"payloadBase64": "MDAwMjAxMjYxODAwMTRici5nb3YuYmNiLnBpeDUyMDQwMDAw...",
"payloadPix": "00020101021226...80...6304C3D4",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6...",
"compositePayloadJws": null,
"recurrencePayloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjE0NzhFNDZB..."
}
Pix Automático
Criar QR Code com vencimento
Cria um QR Code composto com uma cobrança com vencimento e a oferta de recorrência (jornada 4).
POST
/
baas
/
api
/
v1
/
pix
/
qrcode
/
recurrences
/
due-date
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/due-date' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"key": "e7c3d5f2-4a1b-4c3d-9d15-1b2c3d4e5f60",
"beneficiaryAddress": "Av. Paulista, 1000",
"city": "Sao Paulo",
"state": "SP",
"zipCode": "01310100",
"payerName": "Joao da Silva",
"dueDate": "2026-11-10",
"daysAfterDue": 30,
"originalAmount": 189.90,
"recurrenceData": {
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-12-10",
"debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
"amount": 189.90,
"contractNumber": "MAT-00012345",
"contractDescription": "Mensalidade escolar",
"retry": "ALLOWED"
}
}'
{
"documentId": "01000000-3353-6e2c-12c9-08de9f179025",
"revision": "0",
"qrCodeImageBase64": "iVBORw0KGgoAAAANSUhEUgAAASQAAAEkAQAAAACugnFBAAAD60lEQVR4nO2a...",
"payloadBase64": "MDAwMjAxMjYxODAwMTRici5nb3YuYmNiLnBpeDUyMDQwMDAw...",
"payloadPix": "00020101021226...80...6304C3D4",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6...",
"compositePayloadJws": null,
"recurrencePayloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjE0NzhFNDZB..."
}
Para o passo a passo completo, veja o guia Jornada 4: pagamento com oferta de adesão.
Headers
string
required
Sua API key.
string
required
Número da conta Delfinance do recebedor.
Body
string
default:"PAYLOAD_AND_QRCODE"
ONLY_PAYLOAD ou PAYLOAD_AND_QRCODE.string
required
Chave Pix da sua conta, até 77 caracteres.
string
Nome fantasia do recebedor, até 100 caracteres.
string
required
Endereço do recebedor, até 150 caracteres.
string
required
Cidade, até 15 caracteres.
string
required
UF, 2 letras.
string
required
CEP.
string
required
Nome do pagador, até 200 caracteres.
string
CPF ou CNPJ do pagador.
string
Mensagem ao pagador, até 140 caracteres.
string
required
Vencimento,
YYYY-MM-DD.number
required
Dias após o vencimento em que a cobrança ainda pode ser paga.
number
required
Valor original. Sempre envie: a falta deste campo retorna
500.number
Abatimento, em reais.
number
Desconto, em reais.
number
Juros, em reais.
number
Multa, em reais.
object[]
Lista de
{ "name", "value" } exibida ao pagador.object
required
Dados da recorrência. Mesmos campos de Criar QR Code com pagamento imediato:
recurrenceId, frequencyType, recurrenceStartDate, recurrenceEndDate, amount, minPayerMaxAmount, debtor, contractNumber, contractDescription e retry.Response
201 Created. Os mesmos campos de Criar QR Code de autorização, com payloadJws preenchido com a cobrança com vencimento.
O valor final da cobrança é originalAmount − rebate − discount + interest + fine, calculado na criação.
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/due-date' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"key": "e7c3d5f2-4a1b-4c3d-9d15-1b2c3d4e5f60",
"beneficiaryAddress": "Av. Paulista, 1000",
"city": "Sao Paulo",
"state": "SP",
"zipCode": "01310100",
"payerName": "Joao da Silva",
"dueDate": "2026-11-10",
"daysAfterDue": 30,
"originalAmount": 189.90,
"recurrenceData": {
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-12-10",
"debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
"amount": 189.90,
"contractNumber": "MAT-00012345",
"contractDescription": "Mensalidade escolar",
"retry": "ALLOWED"
}
}'
{
"documentId": "01000000-3353-6e2c-12c9-08de9f179025",
"revision": "0",
"qrCodeImageBase64": "iVBORw0KGgoAAAANSUhEUgAAASQAAAEkAQAAAACugnFBAAAD60lEQVR4nO2a...",
"payloadBase64": "MDAwMjAxMjYxODAwMTRici5nb3YuYmNiLnBpeDUyMDQwMDAw...",
"payloadPix": "00020101021226...80...6304C3D4",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6...",
"compositePayloadJws": null,
"recurrencePayloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjE0NzhFNDZB..."
}