Jornada 1: Solicitação de Autorização

Na jornada 1, você combina a adesão com o cliente fora do Pix, por telefone, e-mail ou no balcão, e envia uma solicitação de autorização para a conta dele. A solicitação aparece em “Autorizações pendentes” no app do banco do pagador, que aprova ou recusa. Não há QR Code. Em compensação, você precisa dos dados bancários do pagador: instituição, agência, conta e CPF ou CNPJ. O Pix Automático não usa chave Pix.

Quando usar

Venda por telefone ou balcão

O cliente fecha o contrato com um atendente e recebe a solicitação no app do banco para confirmar.

Migração de débito automático

Você já tem os dados bancários dos clientes e quer convidá-los a migrar para o Pix Automático.

Não reenvie a mesma oferta para quem não autorizou em menos de 30 dias. O Banco Central considera isso envio excessivo.

Passo a passo

Envie a solicitação

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 '{
    "recurrenceId": "RR3822485720261027B7C8D9E0F1A",
    "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"
    },
    "debtor": {
        "type": "NATURAL",
        "document": "12345678901",
        "name": "Joao da Silva"
    },
    "contractNumber": "CTR-555001",
    "contractDescription": "Plano Familia",
    "requestExpiresAt": "2026-11-15T23:59:59.000Z"
}'

{
    "recurrenceId": "RR3822485720261027B7C8D9E0F1A",
    "requestedAt": "2026-10-27T14:32:10.512"
}

O header IdempotencyKey é obrigatório. Use um valor novo a cada solicitação.
Em beneficiary, envie os dados da sua empresa. O documento precisa ser um CNPJ. A API sobrescreve esses dados com os da conta autenticada.
Em payer, informe a instituição (ispb), a agência, a conta e o CPF ou CNPJ do pagador.
requestExpiresAt é o prazo para o pagador responder, no máximo 30 dias após o envio.

Aguarde a resposta do pagador

A solicitação começa com authorizationResult igual a PENDING_USER ou PROCESSING. Quando o pagador responde, ela passa a ACCEPTED ou REJECTED.Consulte o andamento em Consultar autorizações, filtrando por flow=1 (recebedor). O status é sincronizado com a instituição do pagador a cada 15 minutos.

Acompanhe as cobranças

Com a autorização aceita, a Delfinance envia automaticamente a cobrança de cada ciclo. Veja Cobranças recorrentes.

Campos da solicitação

Campo	Obrigatório	Descrição
`recurrenceId`	Não	Identificador da recorrência. Gerado pela API se omitido, sempre com prefixo `RR`
`frequencyType`	Sim	`WEEKLY`, `MONTHLY`, `QUARTERLY`, `SEMIANNUAL` ou `ANNUAL`
`recurrenceStartDate`	Sim	Data da primeira cobrança, `YYYY-MM-DD`
`recurrenceEndDate`	Não	Data final, `YYYY-MM-DD`
`amount`	Não	Valor fixo de cada cobrança. Necessário para as cobranças automáticas
`minPayerMaxAmount`	Não	Piso do valor máximo, para valor variável
`beneficiary`	Sim	`ispb`, `document` (CNPJ) e `name` da sua empresa
`payer`	Sim	`ispb`, `type` (`NATURAL` ou `LEGAL`), `document`, `agencyNumber` e `accountNumber` do pagador
`debtor`	Não	`type`, `document` e `name` do devedor, se for diferente do pagador
`contractNumber`	Sim	Identificador do contrato, exibido ao pagador
`contractDescription`	Não	Descrição exibida ao pagador
`requestExpiresAt`	Sim	Data e hora de expiração da solicitação, em UTC

Envie frequencyType sempre. Se ele faltar, a API assume WEEKLY sem retornar erro.

Referência da API

Solicitar autorização

POST /baas/api/v1/pix/automatic/authorizations

Introdução

Autenticação

Receber via Pix (Pix Cash-in)

Pagar via Pix (Pix Cash-out)

Pix Automático

Pagar via TED (TED Cash-out)

Pagar boletos e contas (Cash-out)

Cobranças via Boleto

Split de Pagamentos

Saldo e extrato

Webhooks

Jornada 1: Solicitação de Autorização

Quando usar

Venda por telefone ou balcão

Migração de débito automático

Passo a passo

Campos da solicitação

Referência da API

Solicitar autorização

​Quando usar

Venda por telefone ou balcão

Migração de débito automático

​Passo a passo

​Campos da solicitação

​Referência da API

Solicitar autorização

Quando usar

Passo a passo

Campos da solicitação

Referência da API