Principais lições deste artigo
- O Pix Automático permite cobranças recorrentes com uma única autorização do pagador, elimina convênios bilaterais e cobre mais de 900 instituições.
- A integração exige armazenar o Authorization ID, criar instruções dentro da janela D+2 a D+10 e tratar webhooks de forma idempotente.
- Em caso de falha por saldo insuficiente, o Banco Central determina duas tentativas no dia do vencimento e até quatro retentativas em até sete dias corridos.
- A escolha entre integrar diretamente com um PSP ou usar uma plataforma de banking define o tempo até produção e a complexidade técnica.
- A Celcoin oferece APIs modulares, sandbox e integração assistida por IA que reduzem o ciclo de implementação do Pix Automático para poucas horas.
Conheça o banking da Celcoin para Pix Automático
Como integrar o Pix Automático?
- Definir se a integração será direta com um PSP ou via plataforma de banking.
- Habilitar o recebimento de Pix Automático no PSP ou na plataforma escolhida, garantindo que o CNPJ da empresa esteja ativo e elegível.
- Implementar o fluxo de autorização e consentimento, gerando o QR Code ou link de autorização e redirecionando o pagador ao ambiente do banco dele.
- Armazenar o Authorization ID retornado após a autorização e os limites definidos pelo pagador, como valor máximo e periodicidade.
- Criar a instrução de cobrança recorrente dentro da janela de antecedência regulatória de D+2 a D+10 antes da data de vencimento.
- Tratar webhooks e estados da cobrança de forma idempotente.
- Implementar tratamento de falhas e reagendamento conforme as regras do Banco Central.
- Conciliar a liquidação antes de liberar o serviço ao cliente.
Pré-requisitos e contratação: o que sua empresa precisa antes de codar
Apenas pessoas jurídicas podem receber via Pix Automático. O CNPJ deve estar ativo há pelo menos seis meses, conforme a Resolução BCB nº 1 de 12/8/2020. Pessoas físicas podem pagar, mas não receber por essa modalidade.
A empresa precisa estar habilitada no arranjo do Pix Automático. Isso exige contratar um PSP participante ou uma plataforma de banking que já opere como participante direta. O processo de homologação varia conforme o provedor e pode incluir documentação adicional, análise de risco e testes em sandbox antes da liberação em produção.
A base regulatória do Pix Automático está na Resolução BCB 360/2023, que criou formalmente a modalidade, e em atualizações posteriores, incluindo a Instrução Normativa BCB 743/2026, que ajustou dispositivos de agendamento e liquidação. As especificações técnicas estão no Manual de Padrões para Iniciação do Pix (MPI), versão 2.10.0, publicado pelo Banco Central do Brasil.
O MPI integra o Regulamento do Pix e detalha as especificações para iniciação de pagamentos, incluindo a estrutura dos QR Codes e a comunicação entre sistemas empresariais e instituições participantes. Com esses pré-requisitos atendidos, o próximo passo é entender o fluxo de autorização e consentimento.
Fale com um especialista da Celcoin sobre Pix Automático
Fluxo de autorização e consentimento: o primeiro pagamento e o Authorization ID
A autorização é dada pelo pagador no ambiente do banco dele, não no sistema do recebedor. O fluxo começa quando o recebedor gera um QR Code ou link de autorização via API e apresenta esse elemento ao pagador. O pagador autoriza o débito recorrente uma única vez no ambiente da instituição financeira, normalmente por QR Code ou link gerado pelo recebedor.
Na autorização, o pagador define o valor máximo por ciclo e pode vincular uma linha de crédito pré-aprovada para cobertura em caso de saldo insuficiente. A integração exige armazenar o ID da autorização para uso nas cobranças recorrentes. Sem esse identificador, nenhuma instrução de pagamento futura pode ser criada.
A distinção entre autorização e cobrança é central. A autorização habilita o recebedor a cobrar, enquanto a instrução de pagamento executa cada ciclo. A autorização permanece válida até cancelamento, e as cobranças futuras dependem de uma autorização ativa.
Ciclo de vida da cobrança: criação da fatura, janela de antecedência, agendamento e liquidação
A instrução de cobrança deve ser criada dentro da janela regulatória. A data de agendamento deve estar entre D+2 e D+10 a partir do vencimento configurado, e apenas uma cobrança por intervalo é permitida. Uma instrução enviada fora dessa janela é rejeitada com erro.
O agendamento referencia o Authorization ID armazenado na fase de consentimento. A liquidação ocorre em D+0, com crédito em tempo real na conta do recebedor, 24 horas por dia, 7 dias por semana. A conciliação financeira do Pix Automático é mais direta do que com cartão de crédito. Cada transação gera um comprovante com ID único, e não há antecipação, estorno parcial ou ajuste de bandeira.
O serviço ao cliente só deve ser liberado após a confirmação da liquidação via webhook, pois liberar antes da confirmação expõe a operação a cobranças que nunca se concretizam.
Teste o fluxo de cobrança recorrente no sandbox do banking da Celcoin
Webhooks e estados: eventos e ação esperada
O webhook é a fonte de verdade para atualizar o estado da assinatura do cliente. O processamento deve ser assíncrono e idempotente. O modelo de entrega é “at least once”, e o mesmo evento pode ser reenviado em situações excepcionais, o que torna a idempotência obrigatória para evitar processamento duplicado. A tabela a seguir resume os principais estados da cobrança, o que cada um significa e qual ação o sistema deve tomar em cada caso.
| Estado | Significado | Ação esperada | Observação |
|---|---|---|---|
| Autorizado (ACTIVE) | Pagador concluiu o consentimento | Habilitar a feature de recorrência no sistema | Armazenar o Authorization ID |
| Agendado (SCHEDULED) | Instrução aceita pelo banco do pagador | Registrar o agendamento e aguardar confirmação | Não liberar serviço ainda |
| Pago (COMPLETED/CONFIRMED) | Liquidação confirmada em D+0 | Liberar serviço e dar baixa na fatura | Usar como fonte de verdade para conciliação |
| Rejeitado (REFUSED) | Falha na liquidação por saldo, limite ou recusa | Iniciar fluxo de retentativa ou notificar cliente | Verificar código de recusa antes de retentar |
| Cancelado (CANCELLED) | Instrução ou autorização cancelada | Suspender cobrança e verificar se a autorização ainda está ativa | Cancelamento de instrução pode ocorrer por pagamento via outro meio |
Novos atributos podem ser adicionados aos payloads de webhook sem aviso prévio. O código deve estar preparado para ignorar campos desconhecidos sem lançar exceções, para não interromper a fila de sincronização.
O que acontece se não tiver saldo na conta? Tratamento de falhas e reagendamento
O Banco Central define duas janelas obrigatórias de liquidação. A primeira tentativa ocorre entre 0h e 8h, e uma nova tentativa obrigatória ocorre entre 18h e 21h quando o pagamento não é realizado por falta de saldo ou limite disponível.
Se o pagamento não for concluído na data original, podem ocorrer novas tentativas nos dias seguintes, respeitando o prazo máximo de sete dias corridos. O Banco Central permite que o recebedor configure até quatro retentativas por ciclo de cobrança, com intervalos mínimos definidos na regulação.
Os principais cenários de falha e as ações recomendadas são:
- Saldo insuficiente: aguardar as retentativas automáticas do dia. Se todas falharem, acionar fluxo de retentativa nos dias seguintes dentro da janela de sete dias e notificar o cliente a cada falha.
- Valor acima do limite autorizado: ajustar o valor da cobrança ou criar uma nova autorização com limite adequado.
- Autorização cancelada ou expirada: notificar o cliente e solicitar nova autorização, pois novos agendamentos não podem ser processados.
- Recusa por dados incorretos: corrigir dados em recusas como AMOUNT_MISMATCH ou DUE_DATE_MISMATCH antes de nova tentativa.
Uma recusa pode refletir regras operacionais da instituição do pagador ou restrições da própria autorização. Armazene o código de recusa, converta-o em mensagem clara para o usuário final e verifique se a autorização ainda está ativa antes de definir o próximo passo.
Como cancelar o Pix Automático: revogação pelo pagador e pelo recebedor
O cancelamento da autorização é processado imediatamente e cancela os pagamentos futuros vinculados àquela autorização, exceto os previstos para o mesmo dia do cancelamento. O pagador pode revogar a autorização diretamente no aplicativo do banco, sem contato com a empresa recebedora.
O recebedor também pode cancelar a autorização pelo lado dele via API. Uma vez cancelado, o payment request não pode ser reautorizado, e é necessário criar um novo. Faturas já agendadas para o mesmo dia do cancelamento não são afetadas, e as demais são canceladas automaticamente.
Pix Automático: quando começa e o que muda na operação
O Banco Central lançou oficialmente o Pix Automático em 16 de junho de 2025, tornando a modalidade obrigatória para todas as instituições participantes do Pix desde 13 de outubro de 2025. Em janeiro de 2026, o Banco Central encerrou o débito automático via boleto entre bancos diferentes, e o Pix Automático passou a ser o substituto oficial para cobrança recorrente entre instituições.
Para quem cobra recorrente, a mudança operacional mais relevante está no reconhecimento de receita. Como o Pix Automático liquida em D+0, sistemas de faturamento desenhados para o cenário de D+30 do cartão de crédito precisam rever conciliação e reconhecimento de receita, pois a receita passa a ser realizada no mesmo dia.
Comece a integrar Pix Automático com o banking da Celcoin
Integrar direto com PSP ou usar uma plataforma de banking?
A decisão entre integrar diretamente com um PSP ou usar uma plataforma de banking define o esforço de desenvolvimento e o tempo até produção. Os critérios relevantes se conectam entre si e impactam tanto a arquitetura quanto a operação diária.
- Esforço de integração: a integração direta com PSP exige implementar do zero o fluxo de consentimento, o gerenciamento de estados, os webhooks e a conciliação. Uma plataforma de banking entrega esses componentes prontos via APIs modulares.
- Gestão de consentimento: o fluxo de autorização envolve redirecionamento ao banco do pagador, captura do Authorization ID e armazenamento de limites. Plataformas de banking abstraem essa complexidade.
- Webhooks e idempotência: a integração direta exige construir toda a infraestrutura de recebimento, retry e deduplicação de eventos. Plataformas já entregam esse pipeline pronto.
- Conciliação: com PSP direto, o time de produto precisa construir a conciliação. Com plataforma de banking, essa camada já faz parte da oferta.
- Compliance e homologação: integrar diretamente exige que a empresa passe pelo processo de homologação junto ao arranjo. Uma plataforma participante direta no Pix absorve essa etapa.
- Tempo até produção: a integração direta pode levar meses. Uma plataforma de banking com sandbox, documentação e suporte reduz esse ciclo de forma relevante.
O banking da Celcoin é participante direta no Pix e iniciadora de pagamentos, e oferece APIs modulares para consentimento, webhooks e conciliação do Pix Automático. Com mais de 400 milhões de transações processadas por mês e mais de 6 mil clientes, entre fintechs, bancos digitais, ERPs e varejistas, a plataforma entrega a infraestrutura regulatória e tecnológica necessária para ir a produção sem construir do zero.
O cel_agents, lançado em 24 de agosto de 2026, reduz de meses para poucas horas o tempo entre decidir integrar e ter uma versão funcional. A solução disponibiliza um ambiente gratuito de testes em até cinco minutos. Times de produto testam jornadas financeiras de forma interativa no cel_agents Studio, sem necessidade de programação, enquanto times de tecnologia usam integração assistida por IA via MCP, com apoio contextual durante o desenvolvimento.
Fale com a Celcoin e acelere sua ida a produção
Conciliação e atualização de assinatura: libere o serviço somente após a liquidação
A conciliação do Pix Automático usa o evento de liquidação confirmada, com status pago ou completed no webhook. Cada transação gera um identificador único end-to-end, o que elimina ambiguidades na reconciliação. O serviço ao cliente deve ser liberado somente após o recebimento desse evento, e não após o agendamento.
Em caso de estorno ou reembolso, apenas pagamentos com status SCHEDULED podem ser cancelados. Uma vez concluído, o pagamento só pode ser reembolsado manualmente pelo destinatário. Para fraudes ou erros do banco pagador, o Banco Central determina que a instituição deve reembolsar o cliente em até 24 horas após o pedido, por meio do Mecanismo Especial de Devolução (MED).
A assinatura do cliente deve permanecer ativa até o esgotamento das retentativas dentro da janela regulatória. Somente após esse processo a empresa deve avaliar suspensão ou bloqueio de acesso ao serviço.
Como a Celcoin encurta o caminho até produção
O banking da Celcoin é participante direta no Pix e iniciadora de pagamentos, o que resolve a homologação junto ao arranjo para quem integra pela plataforma. As APIs modulares cobrem todo o ciclo do Pix Automático, incluindo criação de autorização, gestão de consentimento, webhooks, conciliação e cancelamento.
O cel_agents disponibiliza um ambiente gratuito de testes em até cinco minutos, e o cel_agents Studio permite que times de produto testem jornadas financeiras de forma interativa, sem necessidade de programação. Times de tecnologia usam integração assistida por IA via MCP, com orientação contextual durante o desenvolvimento. Empresas com arquitetura própria podem usar apenas os recursos de integração assistida por IA.
A Celcoin atende mais de 6 mil clientes e intermedia mais de R$ 40 bilhões em transações mensais. Com a aquisição da VERT Capital, o ecossistema passou a incluir securitização, administração fiduciária e gestão de fundos estruturados, o que permite que um cliente de banking evolua para crédito e mercado de capitais sem trocar de infraestrutura.
A Celcoin fornece infraestrutura para serviços financeiros que abrangem banking, pagamentos e crédito, incluindo emissão de crédito por meio de suas soluções. A empresa oferece a base tecnológica para que negócios consigam ofertar produtos de crédito aos seus clientes.
| Funcionalidade da Celcoin | Benefício para sua empresa |
|---|---|
| APIs modulares | Permitem integrações mais rápidas, reduzindo custos e prazos de desenvolvimento. |
| Experiência e suporte ao desenvolvedor | Oferecem documentação, SDKs e sandboxes que reduzem ciclos de integração e custos de engenharia. |
| Capacidade de lançamento rápido | Entregam módulos pré-construídos via SaaS, acelerando lançamentos e antecipando a geração de receita. |
| Distribuição white-label e embutida | Viabilizam produtos financeiros com marca própria. |
| Ter escalabilidade com confiabilidade | Garante alta disponibilidade em nuvem, mantendo serviços estáveis em altos volumes e protegendo a receita. |
| Cobertura de diversas possibilidades de pagamentos, incluindo crédito | Permite oferecer pagamentos e emissão de crédito, aumentando conversão, ARPU e fidelização. |
| Acesso a dados e personalização | Utiliza dados e análises via Open Finance para ofertas personalizadas, com impacto em conversão e retenção. |
| Compliance e conformidade como princípio | Inclui KYC, AML e relatórios integrados, reduzindo risco regulatório e acelerando ciclos de vendas. |
| Prevenção de fraude e controles de risco | Aplica monitoramento baseado em IA e autenticação robusta para reduzir estornos, perdas e exposição regulatória. |
| Força do ecossistema de parceiros da Celcoin | Conecta bancos, redes e fintechs para ampliar cobertura, recursos e velocidade de entrada no mercado. |
Explore o banking da Celcoin para Pix, pagamentos e crédito
Perguntas frequentes
Como habilitar o Pix Automático?
A empresa precisa ser pessoa jurídica com CNPJ ativo há pelo menos seis meses e contratar o serviço junto a um PSP participante do arranjo ou a uma plataforma de banking habilitada. Após a contratação, o PSP ou a plataforma realiza a habilitação no arranjo e libera o acesso às APIs para criação de autorizações e instruções de cobrança.
Como funciona a cobrança Pix Automático?
O recebedor cria uma instrução de cobrança via API, referenciando o Authorization ID do pagador, dentro da janela de D+2 a D+10 antes do vencimento. Na data agendada, o banco do pagador realiza a primeira tentativa de débito entre 0h e 8h e, se necessário, uma segunda tentativa entre 18h e 21h. A liquidação ocorre em D+0, e a confirmação chega ao recebedor via webhook.
O que acontece se não tiver saldo na conta?
O banco do pagador realiza duas tentativas no dia do vencimento, entre 0h e 8h e entre 18h e 21h. Se ambas falharem, o recebedor pode configurar retentativas nos dias seguintes, respeitando o prazo máximo de sete dias corridos definido pelo Banco Central. Após o esgotamento das tentativas, a instrução é recusada definitivamente, e o recebedor recebe o evento de rejeição via webhook com o código de recusa.
Como cancelar o Pix Automático?
O pagador pode cancelar a autorização diretamente no aplicativo do banco a qualquer momento, sem contato com a empresa recebedora. O cancelamento é imediato e cancela todas as cobranças futuras vinculadas àquela autorização, exceto as previstas para o mesmo dia. O recebedor também pode cancelar a autorização pelo lado dele via API. Uma vez cancelada, é necessário criar uma nova autorização para retomar a recorrência.
Pix Automático quando começa?
O Pix Automático foi lançado oficialmente em 16 de junho de 2025 e tornou-se obrigatório para todas as instituições participantes do Pix em 13 de outubro de 2025. Em janeiro de 2026, o Banco Central encerrou o débito automático via boleto entre bancos diferentes, consolidando o Pix Automático como substituto oficial para cobranças recorrentes interbancárias.
Pix Automático vs débito automático: qual a diferença?
O débito automático tradicional exige convênio bilateral entre a empresa e cada banco individualmente e opera com arquivos batch em janelas específicas, com cobertura limitada às instituições com convênio ativo. O Pix Automático opera sobre a infraestrutura do Pix, cobre mais de 900 instituições participantes com uma única integração, liquida em D+0 e dispensa convênios bilaterais. A autorização é feita pelo pagador no app do banco, com cancelamento imediato a qualquer momento.
Conclusão
Integrar o Pix Automático exige ir além da criação de uma cobrança recorrente. O ciclo completo envolve gestão de consentimento, armazenamento do Authorization ID, criação de instruções dentro da janela regulatória, tratamento idempotente de webhooks, fluxo de retentativa para falhas por saldo insuficiente e conciliação baseada na confirmação de liquidação, e não no agendamento.
A escolha entre integrar diretamente com um PSP ou usar uma plataforma de banking define o tempo até produção. A integração direta exige construir do zero toda a camada de consentimento, estados, webhooks e conciliação. Uma plataforma de banking que já é participante direta no Pix entrega esses componentes prontos, com sandbox, documentação e suporte, reduzindo o ciclo de meses para dias.
Fale com a Celcoin e implemente Pix Automático com mais rapidez
