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

# Registrar autorização

> Registra a autorização do pagador para uma recorrência lida em QR Code (jornadas 2 e 4).

> [!NOTE]
>
> Para o passo a passo completo, veja o guia [Lado do pagador](https://docs.delfinance.com.br/guias/pix/pix-automatico/pagador.md#registrar-a-autorização-jornadas-2-e-4).

## Headers

**Authorization** `string` *required*

Sua API key, sem o prefixo `Bearer`.

**IdempotencyKey** `string` *required*

Chave de idempotência. Use um valor novo a cada chamada.

## Path params

**recurrenceId** `string` *required*

Identificador da recorrência, o `recurrence.id` da leitura do QR Code.

## Body

Copie os dados do objeto `recurrence` retornado na [leitura do QR Code](https://docs.delfinance.com.br/api-reference/pix/inicializar-pagamento-qrcode.md).

**journey** `number` *required*

Jornada: `2` ou `4`.

**frequencyType** `string` *required*

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

**recurrenceStartDate** `string`

Data inicial, `YYYY-MM-DD`.

**recurrenceEndDate** `string`

Data final, `YYYY-MM-DD`.

**amount** `number`

Valor fixo da recorrência.

**minPayerMaxAmount** `number`

Piso do valor máximo definido pelo recebedor.

**payerMaxAmount** `number`

Valor máximo escolhido pelo pagador.

**beneficiary** `object` *required*

Recebedor: `ispb`, `document` e `name`.

**debtor** `object`

Devedor: `type`, `document` e `name`. Ignorado se o documento for igual ao do pagador.

**contractNumber** `string` *required*

Identificador do contrato.

**contractDescription** `string`

Descrição do contrato.

**settlementConfirmedAt** `string`

Data e hora da liquidação do pagamento, quando a autorização vem depois de um pagamento (jornada 4).

## Response

**recurrenceId** `string`

Identificador da recorrência.

**requestedAt** `string`

Data e hora do pedido, em UTC, sem `Z`.

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/authorizations/RR3822485720261027AB12CD34EF5/approve' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{apiKey}}' \
--header 'IdempotencyKey: {{$guid}}' \
--data '{
    "journey": 4,
    "frequencyType": "MONTHLY",
    "recurrenceStartDate": "2026-12-10",
    "amount": 189.90,
    "beneficiary": { "ispb": "38224857", "document": "11222333000181", "name": "ESCOLA EXEMPLO LTDA" },
    "debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
    "contractNumber": "MAT-00012345",
    "contractDescription": "Mensalidade escolar"
}'
```

```json 200 theme={null}
{
    "recurrenceId": "RR3822485720261027AB12CD34EF5",
    "requestedAt": "2026-10-27T16:10:03.881"
}
```


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