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

# Solicitar autorização

> Envia uma solicitação de Pix Automático para a conta do pagador (jornada 1).

> [!NOTE]
>
> Para o passo a passo completo, veja o guia [Jornada 1: solicitação no app](https://docs.delfinance.com.br/guias/pix/pix-automatico/jornada-1-solicitacao.md).

## Headers

**Authorization** `string` *required*

Sua API key, sem o prefixo `Bearer`.

**IdempotencyKey** `string` *required*

Chave de idempotência. Use um valor novo a cada solicitação.

## Body

**recurrenceId** `string`

Identificador da recorrência, 29 caracteres. Gerado pela API se omitido, com prefixo `RR`.

**frequencyType** `string` *required*

`WEEKLY`, `MONTHLY`, `QUARTERLY`, `SEMIANNUAL` ou `ANNUAL`. Se omitido, a API assume `WEEKLY`.

**recurrenceStartDate** `string` *required*

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

**recurrenceEndDate** `string`

Data final, `YYYY-MM-DD`.

**amount** `number`

Valor fixo de cada cobrança. Necessário para as cobranças automáticas.

**minPayerMaxAmount** `number`

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

**beneficiary** `object` *required*

Dados da sua empresa. Sobrescritos com os dados da conta autenticada.

**beneficiary**

**beneficiary.ispb** `string` *required*

ISPB da instituição do recebedor (`38224857`).

**beneficiary.document** `string` *required*

CNPJ válido do recebedor.

**beneficiary.name** `string` *required*

Razão social.

**payer** `object` *required*

Dados bancários do pagador.

**payer**

**payer.ispb** `string` *required*

ISPB da instituição do pagador.

**payer.type** `string` *required*

`NATURAL` (CPF) ou `LEGAL` (CNPJ).

**payer.document** `string` *required*

CPF ou CNPJ válido do pagador.

**payer.agencyNumber** `string`

Agência.

**payer.accountNumber** `string`

Número da conta.

**debtor** `object`

Devedor, se for diferente do pagador: `type` (`NATURAL` ou `LEGAL`), `document` e `name`.

**contractNumber** `string` *required*

Identificador do contrato, exibido ao pagador.

**contractDescription** `string`

Descrição exibida ao pagador.

**requestExpiresAt** `string` *required*

Data e hora de expiração da solicitação, em UTC (ISO 8601). No máximo 30 dias após o envio.

## Response

**recurrenceId** `string`

Identificador da recorrência.

**requestedAt** `string`

Data e hora do pedido, em UTC, no formato `yyyy-MM-ddTHH:mm:ss.fff` (sem `Z`).

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/authorizations' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{apiKey}}' \
--header 'IdempotencyKey: {{$guid}}' \
--data '{
    "frequencyType": "MONTHLY",
    "recurrenceStartDate": "2026-12-05",
    "amount": 99.90,
    "beneficiary": { "ispb": "38224857", "document": "11222333000181", "name": "SUA EMPRESA LTDA" },
    "payer": { "ispb": "60701190", "type": "NATURAL", "document": "12345678901", "agencyNumber": "1234", "accountNumber": "567890" },
    "contractNumber": "CTR-555001",
    "contractDescription": "Plano Familia",
    "requestExpiresAt": "2026-11-15T23:59:59.000Z"
}'
```

```json 200 theme={null}
{
    "recurrenceId": "RR3822485720261027B7C8D9E0F1A",
    "requestedAt": "2026-10-27T14:32:10.512"
}
```

```json 400 theme={null}
{
    "code": "REQUEST_ERROR",
    "instance": "/api/v1/automatic-pix/authorizations",
    "errors": ["Payer.Document: Campo inválido."]
}
```


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