> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delfinance.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar QR Code com vencimento

> Cria um QR Code composto com uma cobrança com vencimento e a oferta de recorrência (jornada 4).

> [!NOTE]
>
> Para o passo a passo completo, veja o guia [Jornada 4: pagamento com oferta de adesão](https://docs.delfinance.com.br/guias/pix/pix-automatico/jornada-4-oferta.md).

## Headers

**x-delbank-api-key** `string` *required*

Sua API key.

**x-delfinance-account-id** `string` *required*

Número da conta Delfinance do recebedor.

## Body

**responseFormat** `string` (default: PAYLOAD\_AND\_QRCODE)

`ONLY_PAYLOAD` ou `PAYLOAD_AND_QRCODE`.

**key** `string` *required*

Chave Pix da sua conta, até 77 caracteres.

**beneficiaryFantasyName** `string`

Nome fantasia do recebedor, até 100 caracteres.

**beneficiaryAddress** `string` *required*

Endereço do recebedor, até 150 caracteres.

**city** `string` *required*

Cidade, até 15 caracteres.

**state** `string` *required*

UF, 2 letras.

**zipCode** `string` *required*

CEP.

**payerName** `string` *required*

Nome do pagador, até 200 caracteres.

**payerDocument** `string`

CPF ou CNPJ do pagador.

**payerRequest** `string`

Mensagem ao pagador, até 140 caracteres.

**dueDate** `string` *required*

Vencimento, `YYYY-MM-DD`.

**daysAfterDue** `number` *required*

Dias após o vencimento em que a cobrança ainda pode ser paga.

**originalAmount** `number` *required*

Valor original. Sempre envie: a falta deste campo retorna `500`.

**rebate** `number`

Abatimento, em reais.

**discount** `number`

Desconto, em reais.

**interest** `number`

Juros, em reais.

**fine** `number`

Multa, em reais.

**additionalData** `object[]`

Lista de `{ "name", "value" }` exibida ao pagador.

**recurrenceData** `object` *required*

Dados da recorrência. Mesmos campos de [Criar QR Code com pagamento imediato](https://docs.delfinance.com.br/api-reference/pix-automatico/criar-qrcode-imediato.md): `recurrenceId`, `frequencyType`, `recurrenceStartDate`, `recurrenceEndDate`, `amount`, `minPayerMaxAmount`, `debtor`, `contractNumber`, `contractDescription` e `retry`.

## Response

`201 Created`. Os mesmos campos de [Criar QR Code de autorização](https://docs.delfinance.com.br/api-reference/pix-automatico/criar-qrcode-autorizacao.md), com `payloadJws` preenchido com a cobrança com vencimento.

O valor final da cobrança é `originalAmount` − `rebate` − `discount` + `interest` + `fine`, calculado na criação.

```bash cURL theme={null}
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"
    }
}'
```

```json 201 theme={null}
{
    "documentId": "01000000-3353-6e2c-12c9-08de9f179025",
    "revision": "0",
    "qrCodeImageBase64": "iVBORw0KGgoAAAANSUhEUgAAASQAAAEkAQAAAACugnFBAAAD60lEQVR4nO2a...",
    "payloadBase64": "MDAwMjAxMjYxODAwMTRici5nb3YuYmNiLnBpeDUyMDQwMDAw...",
    "payloadPix": "00020101021226...80...6304C3D4",
    "payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6...",
    "compositePayloadJws": null,
    "recurrencePayloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjE0NzhFNDZB..."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.