> ## 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 pagamento imediato

> Cria um QR Code composto com uma cobrança imediata e a recorrência (jornada 3). Pagar a cobrança autoriza o Pix Automático.

> [!NOTE]
>
> Para o passo a passo completo, veja o guia [Jornada 3: pagamento imediato e autorização](https://docs.delfinance.com.br/guias/pix/pix-automatico/jornada-3-pagamento-imediato.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 que recebe o pagamento imediato. Até 77 caracteres.

**originalAmount** `number` *required*

Valor do pagamento imediato.

**city** `string` *required*

Cidade do recebedor, até 15 caracteres.

**zipCode** `string`

CEP do recebedor.

**categoryCode** `string` (default: 0000)

Código de categoria (MCC), até 4 caracteres.

**payerRequest** `string`

Mensagem exibida ao pagador, até 140 caracteres.

**payerDocument** `string`

CPF (11 dígitos) ou CNPJ (14 dígitos) do pagador.

**payerName** `string`

Nome do pagador, até 25 caracteres.

**changeValue** `string` (default: NOT\_ALLOWED)

Se o pagador pode alterar o valor: `NOT_ALLOWED` ou `ALLOWED`. Não envie `null`.

**qrExpiration** `number` (default: 86400)

Validade da cobrança, em segundos. É também o prazo para o pagador autorizar.

**additionalData** `object[]`

Informações exibidas ao pagador.

**additionalData**

**additionalData\[].name** `string`

Rótulo, até 100 caracteres.

**additionalData\[].value** `string`

Valor, até 400 caracteres.

**reusable** `boolean` (default: false)

Se o QR Code pode ser pago mais de uma vez. Mantenha `false` no Pix Automático.

**recurrenceData** `object` *required*

Dados da recorrência. Envie todos os campos obrigatórios: neste endpoint, a falta de um deles retorna `500`.

**recurrenceData**

**recurrenceData.recurrenceId** `string`

Identificador da recorrência, 29 caracteres. Gerado pela API se omitido.

**recurrenceData.frequencyType** `string` *required*

`WEEKLY`, `MONTHLY`, `QUARTERLY`, `SEMIANNUAL` ou `ANNUAL`.

**recurrenceData.recurrenceStartDate** `string` *required*

Data da primeira cobrança recorrente, `YYYY-MM-DD`.

**recurrenceData.recurrenceEndDate** `string`

Data final, `YYYY-MM-DD`.

**recurrenceData.amount** `number`

Valor fixo de cada cobrança. Não envie junto com `minPayerMaxAmount`.

**recurrenceData.minPayerMaxAmount** `number`

Piso do valor máximo do pagador, para valor variável.

**recurrenceData.debtor** `object` *required*

Devedor: `type` (`NATURAL` ou `LEGAL`), `document` e `name`, todos obrigatórios.

**recurrenceData.contractNumber** `string` *required*

Identificador do contrato, até 35 caracteres.

**recurrenceData.contractDescription** `string`

Descrição exibida ao pagador, até 35 caracteres.

**recurrenceData.retry** `string` *required*

`NOT_ALLOWED` ou `ALLOWED`.

## 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 imediata.

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/immediate-payment' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "key": "e7c3d5f2-4a1b-4c3d-9d15-1b2c3d4e5f60",
    "city": "Sao Paulo",
    "originalAmount": 49.90,
    "qrExpiration": 3600,
    "recurrenceData": {
        "recurrenceId": "RR3822485720261027F6E5D4C3B2A",
        "frequencyType": "MONTHLY",
        "recurrenceStartDate": "2026-11-27",
        "debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
        "amount": 49.90,
        "contractNumber": "CTR-123456",
        "contractDescription": "Plano Premium",
        "retry": "ALLOWED"
    }
}'
```

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


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