Jornadas de Autorização do Pix Automático

O Pix Automático é o débito automático no Pix. Primeiro o cliente autoriza a recorrência. Depois você cobra cada parcela.

O Banco Central define 4 jeitos de autorizar. Escolha o que parece com o seu dia a dia e abra o detalhe.

Referência oficial: Guia de Implementação do Pix Automático (Bacen).

Qual jornada usar?

Jornada 1Sem QR. O banco manda um push: “Confirmar Pix Automático da Vivo, todo dia 10?”Jornada 2QR só da recorrência, sem cobrar agora. Ex.: fatura do condomínio por e-mail.Jornada 3Um QR: paga a matrícula agora e autoriza as mensalidades seguintes.Jornada 4Paga o QR da conta (Pix avulso). Depois o app pergunta se quer automatizar as próximas.Cobranças da recorrênciaDepois de autorizado: cada mês é uma CobR (fatura da Ana, condomínio do Carlos…).

Jornada 1 — Sem QR Code (notificação no app do banco)

Quando usar

Não tem QR. O cliente pediu o Pix Automático no seu canal (telefone, app, loja). Você cadastra a recorrência e o banco dele manda o aviso para confirmar.

Exemplo — Ana e a fatura da Vivo

A Ana liga para a operadora e pede para pagar a fatura mensal com Pix Automático. A operadora cadastra a recorrência. O banco da Ana manda um push: “Confirmar Pix Automático da Vivo, todo dia 10, até R$ 120?”. Ela abre o app, confere e autoriza. Do mês seguinte em diante, o débito cai sozinho — cada fatura é uma CobR.

Tópico 3.2 do guia do Bacen.

Caminho de criação

O passo 1 é o atendimento, não a API. Os passos 2 e 3 são seus. O push (passo 4) o banco da Ana envia sozinho depois do POST /solicrec.

Endpoints

1. Criar recorrência — POST /rec com o contrato (valor, frequência, pagador).
2. Pedir confirmação no banco — POST /solicrec ligado a essa recorrência. É isso que faz o banco chamar o cliente.
3. Opcional: consultar ou cancelar recorrências e solicitações se o cliente desistir.

Depois de autorizada, cada mensalidade é uma cobrança da recorrência.

Diagrama do Bacen

Jornada 2 — QR Code só com a recorrência

Quando usar

O cliente recebe ou vê um QR só da autorização. Não cobra nada na hora.

Exemplo — Carlos e o condomínio

O Carlos recebe a fatura do condomínio por e-mail com um QR de Pix Automático (sem cobrança na hora). Ele escaneia no app do banco, vê “Síndico ONZ — mensalidade, dia 5, valor fixo R$ 850” e autoriza. Não paga nada naquele instante; só liga a recorrência para os próximos meses.

Tópico 3.3 do guia do Bacen.

Caminho de criação

Endpoints

1. Criar recorrência — POST /rec.
2. Consultar recorrência — GET /rec/{idRec} sem txid. O QR vem em dadosQR.
3. Opcional: gerenciar recorrências.

Não envie txid nesta consulta. Esse parâmetro é só das jornadas 3 e 4.

Diagrama do Bacen

Jornada 3 — QR Code com 1º pagamento + recorrência

Quando usar

Um QR só: Pix de agora (cobrança imediata) e, na mesma tela, a autorização das próximas. O Pix de agora não entra na recorrência; a recorrência cobre só o que vem depois.

Exemplo — Marina na academia

A Marina assina a academia. No balcão, o QR já traz o Pix de hoje (R$ 149 da matrícula) e a oferta de Pix Automático mensal. Ela paga a matrícula na hora e, na mesma tela, autoriza os débitos dos meses seguintes.

Tópico 3.4 do guia do Bacen.

Caminho de criação

Endpoints

1. Criar recorrência — POST /rec.
2. Criar cobrança imediata — PUT /cob/{txid} (o valor de hoje).
3. Consultar recorrência — GET /rec/{idRec} com o txid da cobrança imediata. O QR composto vem em dadosQR.
4. Opcional: gerenciar recorrências e cobranças imediatas.

Diagrama do Bacen

Jornada 4 — Paga o QR da fatura e depois recebe a oferta

Quando usar

O cliente primeiro paga um Pix avulso (a fatura da vez). Depois que o Pix confirma, o app do banco pergunta se ele quer automatizar as próximas. Se aceitar, só as faturas seguintes entram na recorrência. Aquela primeira já foi um Pix comum.

Exemplo — João e a conta de luz

O João paga a conta de luz com um QR Pix (pagamento único). Depois que o Pix confirma, o app do banco pergunta: “Quer pagar as próximas faturas da Energisa com Pix Automático?”. Se ele aceitar, as próximas cobranças passam a ser automáticas.

Na API isso usa cobrança com vencimento (cobv) ligada à recorrência: o QR que o João lê é o da fatura; a oferta de Pix Automático aparece no app do banco após o pagamento.

Tópico 3.5 do guia do Bacen.

Caminho de criação

Endpoints

1. Criar recorrência — POST /rec.
2. Criar cobrança com vencimento — PUT /cobv/{txid}.
3. Consultar recorrência — GET /rec/{idRec} com o txid da fatura. O QR composto vem em dadosQR.
4. Opcional: gerenciar recorrências e cobranças com vencimento.

Diagrama do Bacen

Cobranças associadas à recorrência — cada parcela

O que é o quê

A recorrência (Rec) é a autorização: “pode debitar até R$ 120 todo mês”.
A cobrança associada (CobR) é a parcela daquele mês: “abril, R$ 120, vence dia 5”.

Sem recorrência autorizada, não existe parcela. Sem criar a CobR, o banco não cobra aquele mês — a autorização sozinha não gera o Pix.

No dia a dia

Volta na Ana: fatura da Vivo, até R$ 120, todo dia 10.

1. Em março ela autoriza (jornada 1).
2. Em abril a operadora cria a parcela: PUT /cobr/{txid} com vencimento 10/4.
3. O banco tenta debitar. O webhook de CobR avisa se pagou.
4. Em maio, outra CobR no mesmo idRec. O condomínio do Carlos e as faturas da Energisa do João seguem a mesma lógica.

Se a parcela não cair, dá para pedir retentativa no mesmo txid, quando a política da recorrência permitir.

Caminho depois da autorização

Endpoints

1. Criar cobrança da parcela — PUT /cobr/{txid} com o idRec e o vencimento daquele ciclo.
2. Consultar a parcela — GET /cobr/{txid}.
3. Listar parcelas — GET /cobr para conciliar o mês.
4. Pedir retentativa — se a parcela não cair e a política da recorrência permitir.
5. Webhooks de CobR — liquidação, rejeição, cancelamento.
6. Webhooks de recorrência — a autorização mudou (aprovada, cancelada).
7. Atualizar recorrência se o contrato mudar (teto, data-fim).

Não use cob nem cobv para as mensalidades seguintes. Esses dois entram só na autorização das jornadas 3 e 4. O ciclo normal é sempre CobR.

Comparativo

Jornada	Exemplo	QR	Paga agora?
1	Ana liga para a Vivo; push no banco	Não	Não
2	Carlos lê o QR do condomínio no e-mail	Só da recorrência	Não
3	Marina paga R$ 149 de matrícula e autoriza o resto	Composto (cob + rec)	Sim, só a matrícula
4	João paga a luz; o app oferece automatizar as próximas	Fatura (cobv)	Sim, Pix avulso da fatura

Perguntas frequentes

Dúvidas que clientes fazem na rua, no Reclame Aqui e na imprensa — e o que responder / fazer na API.

A conta da luz muda todo mês. Como fica?

O valor da CobR pode ser diferente a cada ciclo. O que o cliente trava no banco é um teto (limite de Pix Automático). Se abril for R$ 95 e maio R$ 140, os dois passam se estiverem abaixo do teto. Se a CobR passar do teto, o banco não agenda; a autorização continua. Peça para ele subir o limite no app ou cobre aquele mês por outro meio.

A cobrança recorrente pode ser cobrada em datas diferentes?

Não em qualquer data do ciclo. Na criação ou atualização da CobR, calendario.dataDeVencimento precisa ser:

• a data do ciclo, calculada a partir da dataInicial da recorrência e da periodicidade; ou
• se ajusteDiaUtil for true (é o padrão) e essa data cair em sábado, domingo ou feriado, a data ajustada para o próximo dia útil.

Data que está “dentro do ciclo” e não bate com uma dessas duas é rejeitada.

Exemplo. Recorrência mensal com dataInicial em 04/09. Os ciclos caem em 04/10, 04/11, 04/12… Enviar 07/10 no ciclo de 04/10 falha. O vencimento aceito é 04/10. Se 04/10 for sábado, domingo ou feriado e ajusteDiaUtil estiver true, também vale o próximo dia útil. 07/10, por exemplo, continua rejeitado.

{
  "idRec": "RR1234567820240904abcdefghijk",
  "calendario": {
    "dataDeVencimento": "2025-10-04"
  },
  "valor": { "original": "120.00" },
  "ajusteDiaUtil": true
}

2025-10-07 nesse mesmo ciclo volta erro. Com ajusteDiaUtil em false, só a data exata do ciclo passa, mesmo que caia em fim de semana ou feriado.

Também vale uma CobR válida por ciclo: não dá para criar duas cobranças no mesmo ciclo. Status REJEITADA ou CANCELADA não ocupa o ciclo. O dia da autorização permanece o mesmo. Para outro calendário, crie outra Rec e o pagador confirma de novo.

Como funciona a retentativa?

Há dois momentos.

No dia do vencimento. O banco do pagador tenta entre 0h e 8h. Se faltar saldo ou limite, ele mesmo tenta de novo entre 18h e 21h. Isso não passa pela API.

Depois do vencimento. Só existe se a Rec estiver com PERMITE_3R_7D. O Bacen não dispara sozinho: você monta uma rotina e pede cada nova data:

POST /cobr/{txid}/retentativa/{data}

{data} é o dia da nova liquidação (YYYY-MM-DD). O txid é o da CobR original.

Nos 7 dias o Bacen manda assim:

• o prazo conta da liquidação original;
• até 3 pedidos, em dias diferentes, nesses 7 dias corridos;
• a data nova fica antes do próximo ciclo;
• a instrução pode ir até 23h59 da véspera da data pedida;
• em cada um desses dias o banco tenta de novo 0h–8h e 18h–21h;
• retentativa já pedida não se cancela.

Com NAO_PERMITE, o mês termina nas tentativas do dia do vencimento.

Referência da API: QRCodes. Manual do Bacen (participantes): FAQ em PDF.