Jornada 1: notificação
O pagador aceita a recorrência por uma notificação, sem ler QR Code. A especificação diz "notificação externa ao ecossistema". Na API, o recebedor cria a recorrência em POST /rec e pede a confirmação em POST /solicrec.
Guia grátis para quem integra Pix Automático
API do Pix Automático: as quatro jornadas, os endpoints e quem já entrega.
O Banco Central publica a especificação da API Pix, e quem a oferece é o banco ou o intermediador de quem recebe. Lemos a versão 2.10.0 em 4 de novembro de 2026: abaixo, as quatro jornadas de adesão, os recursos do Pix Automático, as regras que mandam no desenho e quem já documenta a API.
AP.S1 — Jornadas
As quatro jornadas de adesão do Pix Automático.
Jornada 2: QR Code da recorrência
O pagador lê um QR Code só da recorrência e autoriza. Nada é pago na leitura do QR Code: ele só registra o consentimento.
Jornada 3: QR Code composto com pagamento
O pagador lê um QR Code composto, paga uma cobrança imediata e autoriza as próximas no mesmo passo. A especificação exige o txid dessa cobrança em dadosJornada.txid. É a jornada do Asaas pela API.
Jornada 4: cobrança com vencimento
O pagador lê o QR Code composto de uma cobrança com vencimento, ou o estático de um contrato vigente, e escolhe aderir à recorrência ao pagar.
Qual jornada a recorrência teve
O campo ativacao.tipoJornada grava JORNADA_1 a JORNADA_4 depois da ativação. Antes dela, o valor é AGUARDANDO_DEFINICAO.
O QR Code de cada jornada
Em GET /rec/{idRec}, os dadosQR trazem o Pix Copia e Cola da jornada pedida: QR Composto da recorrência na 2, da cobrança imediata com a recorrência na 3 e da cobrança com vencimento com a recorrência na 4.
Definições da especificação API Pix 2.10.0 do Banco Central, publicada em github.com/bacen/pix-api, lida em 4 de novembro de 2026.
AP.S2 — Endpoints
Os recursos da API para o Pix Automático.
/rec
A recorrência, que é a autorização: POST /rec cria, GET /rec/{idRec} consulta e PATCH /rec/{idRec} revisa ou cancela. Status: CRIADA, APROVADA, REJEITADA, EXPIRADA e CANCELADA.
/solicrec
A solicitação de confirmação que chega ao app do pagador. POST /solicrec cria e PATCH /solicrec/{idSolicRec} revisa. Status: CRIADA, ENVIADA, RECEBIDA, ACEITA, REJEITADA, EXPIRADA e CANCELADA.
/cobr
A cobrança recorrente de cada ciclo, em POST /cobr ou PUT /cobr/{txid}. Status: CRIADA, ATIVA, CONCLUIDA, EXPIRADA, REJEITADA e CANCELADA. A nova tentativa é POST /cobr/{txid}/retentativa/{data}.
/locrec
O endereço do payload do QR Code da recorrência. POST /locrec cria e DELETE /locrec/{id}/idRec desvincula a recorrência.
/webhookrec e /webhookcobr
Um webhook para as recorrências e outro para as cobranças recorrentes, cada um com PUT para configurar, GET para ver e DELETE para cancelar. Só avisam o que é do próprio recebedor.
Escopos OAuth2
Cada recurso tem o seu: rec.write, rec.read, solicrec.write, cobr.write, cobr.read, payloadlocationrec.write, webhookrec.write e webhookcobr.write, entre outros. Sem o escopo, o PSP recusa a chamada.
A 2.11.0-rc1, de 29 de outubro de 2026, ainda é release candidate: acrescenta o campo cobr.tributo do Split Tributário e o valorLiquidoEstimado na cobrança recorrente.
AP.S3 — Regras
O que a especificação manda no desenho da integração.
Periodicidade
SEMANAL, MENSAL, TRIMESTRAL, SEMESTRAL ou ANUAL. Não existe bimestral: um plano a cada dois meses vira mensal ou trimestral.
Valor fixo ou variável
valorRec só quando o valor é fixo. Sem ele, o valor muda por ciclo, e valorMinimoRecebedor é o piso para o valor máximo que o pagador puser. Os dois juntos são recusados.
Retentativa
politicaRetentativa aceita NAO_PERMITE ou PERMITE_3R_7D e fica gravada na recorrência. Com NAO_PERMITE, a cobrança recusada no vencimento não ganha outra tentativa.
Uma cobrança por ciclo
A API recusa uma segunda cobrança da mesma recorrência no mesmo ciclo enquanto a primeira não estiver REJEITADA ou CANCELADA. Isso evita débito em dobro, desde que o seu sistema trate a recusa.
Autorizar não é pagar
O pagamento da Jornada 3 pode cair e a autorização ser recusada depois pelo banco do pagador. A recorrência só vale quando chega ao status de aprovada: a cobrança do próximo ciclo depende dela.
Prazo da cobrança
No Asaas, a cobrança de cada ciclo tem de ser criada entre 2 e 10 dias úteis antes do vencimento. Quem cria a cobrança no dia do vencimento perde o ciclo.
AP.S4 — Quem oferece
Quem documenta a API do Pix Automático.
Inter
API Pix Automático no portal do desenvolvedor, com os nomes do Banco Central (/rec, /solicrec, /cobr, /locrec, /webhookrec, /webhookcobr) e as Jornadas 1 a 4. A página diz que a API "pode ser oferecida apenas a CNPJs com pelo menos 6 meses de atividade".
Efí
Os endpoints do Banco Central com /v2 na frente: POST /v2/rec, POST /v2/solicrec e PUT /v2/cobr/:txid, cada um com o seu escopo. Pede Conta Digital Efí Empresas.
Sicredi
A API Pix do Sicredi tem cobrança recorrente (Pix Automático), com os escopos rec, solicrec e cobr, e autenticação com mTLS.
Asaas
API própria, fora dos nomes do Banco Central: a autorização nasce em POST /v3/pix/automatic/authorizations com o immediateQrCode, e cada cobrança vai em POST /v3/payments com o pixAutomaticAuthorizationId. O paymentCreationMode escolhe se a sua aplicação cria as cobranças ou se uma assinatura do Asaas cria. Pela API, só a Jornada 3.
Banco do Brasil
A página da API Pix do BB diz que ela faz "a configuração e administração do Pix Automático". Os endpoints não estão na página aberta, então não os conferimos.
Itaú, Santander, Sicoob, Bradesco e Mercado Pago
Nos portais públicos que abrimos, não achamos a referência da API do Pix Automático. Pode estar atrás do login do portal do desenvolvedor: pergunte ao gerente.
Portais lidos em 4 de novembro de 2026: developers.inter.co, dev.efipay.com.br, developers.sicredi.com.br, docs.asaas.com e bb.com.br/site/developers. Tarifa do recebimento não está nessas páginas: veja o guia da taxa do Pix Automático.
AP.S5 — Na prática
O que a nossa integração com o Asaas mostrou.
Os eventos que importam
PAYMENT_RECEIVED do primeiro Pix não garante a autorização: o que vale é PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED. Se vier PIX_AUTOMATIC_RECURRING_AUTHORIZATION_REFUSED depois do pagamento, o primeiro Pix fica, e a renovação precisa de outro caminho.
Recusa é comum
Na conta da Design Master no Asaas, que cobra assinaturas de outros produtos nossos, 10 das 54 autorizações da Jornada 3 criadas até 3 de novembro de 2026 terminaram recusadas. Tratar a recusa não é detalhe.
Webhook entregue mais de uma vez
O Asaas pode entregar o mesmo evento mais de uma vez: a integração precisa guardar o id de cada evento e ignorar o repetido, ou o mesmo pagamento é processado duas vezes.
Sem programar, no WooCommerce
O Brasa Pix Automático liga o WooCommerce Subscriptions ao Asaas na Jornada 3: o primeiro Pix autoriza, a cobrança de cada renovação sai 3 dias úteis antes do vencimento, a retentativa de 3 em 7 dias vai ligada e autorização recusada vira QR Code novo na renovação. R$ 297 por ano por loja.
Ver o Brasa Pix AutomáticoQuando ele não serve
Loja sem o WooCommerce Subscriptions, outro intermediador que não o Asaas ou plano bimestral. Para esses casos, a API do seu banco é o caminho.
AP.S6 — Perguntas
O que perguntam sobre a API do Pix Automático.
O que é a API do Pix Automático?
É a parte da API Pix do Banco Central que cuida da cobrança recorrente: /rec cria a recorrência, /solicrec pede a confirmação ao pagador, /cobr cria a cobrança de cada ciclo, /locrec guarda o endereço do QR Code e /webhookrec e /webhookcobr avisam as mudanças. O Banco Central publica a especificação, na versão 2.10.0, e quem a oferece é o banco ou o intermediador de quem recebe.
O Banco Central tem uma API do Pix Automático para eu chamar?
Não para chamar direto. O Banco Central publica o padrão no GitHub e cada banco ou intermediador de quem recebe expõe a API para os clientes dele. Inter, Efí e Sicredi documentam os nomes do padrão. O Asaas tem uma API própria.
Quais são as jornadas do Pix Automático?
São quatro. Na Jornada 1, o pagador aceita por uma notificação, sem QR Code. Na Jornada 2, ele lê um QR Code só da recorrência. Na Jornada 3, ele lê um QR Code composto, paga a primeira cobrança e autoriza no mesmo passo. Na Jornada 4, ele lê o QR Code composto de uma cobrança com vencimento e escolhe aderir à recorrência.
Qual a diferença entre a Jornada 2 e a Jornada 3?
Na Jornada 2, o QR Code serve só para autorizar e nada é pago na hora. Na Jornada 3, o mesmo QR Code paga uma cobrança imediata e autoriza as próximas, e a especificação exige o txid dessa cobrança em dadosJornada.txid. É a jornada que o Asaas oferece pela API.
O Asaas tem API de Pix Automático?
Tem, só a Jornada 3. A autorização nasce em POST /v3/pix/automatic/authorizations com o immediateQrCode do primeiro pagamento, e cada cobrança seguinte vai em POST /v3/payments com o pixAutomaticAuthorizationId. A doc do Asaas manda criar a cobrança entre 2 e 10 dias úteis antes do vencimento.
O Pix Automático tem retentativa?
Tem, se a recorrência permitir. O campo politicaRetentativa aceita NAO_PERMITE ou PERMITE_3R_7D, e a nova tentativa é pedida em POST /cobr/{txid}/retentativa/{data}. No Asaas, a política vai no retryPolicy, na criação da autorização.
Dá para cobrar valor variável no Pix Automático?
Dá. O valorRec só deve ser preenchido quando o valor for fixo. Sem ele, o valor muda a cada ciclo, e o valorMinimoRecebedor é o piso: se o pagador puser um valor máximo na autorização, ele não pode ficar abaixo desse piso.
Quais periodicidades o Pix Automático aceita?
SEMANAL, MENSAL, TRIMESTRAL, SEMESTRAL e ANUAL, as cinco da especificação 2.10.0. Não existe bimestral: um plano a cada dois meses precisa virar mensal ou trimestral.
Qual banco tem API de Pix Automático?
Nos portais públicos que abrimos em 4 de novembro de 2026, Inter, Efí e Sicredi documentam a API com os nomes do Banco Central, o Asaas tem a dele, e o Banco do Brasil cita o Pix Automático na página da API Pix. No Itaú, Santander, Sicoob, Bradesco e Mercado Pago, não achamos a referência pública da API.
Preciso programar para cobrar Pix Automático no WooCommerce?
Não, se a loja usa o WooCommerce Subscriptions e conta no Asaas. O Brasa Pix Automático faz a Jornada 3 no checkout, cria a cobrança de cada renovação antes do vencimento e trata autorização recusada. Custa R$ 297 por ano por loja.
AP.S7 — Suporte
Está integrando Pix Automático?
Chame no WhatsApp com o banco ou intermediador e a jornada que você quer usar. Você fala com quem escreveu a integração do Brasa Pix Automático.