PIX Automático
Débito recorrente direto da conta do cliente — em desenvolvimento na Zhex. Conceito, fluxo planejado e quando faz sentido.
PIX Automático é o débito recorrente direto da conta (BACEN PIX Auto) — equivalente a "subscription com débito automático" sem custo de adquirente. Requer pré-autorização do cliente via app do banco dele.
Em desenvolvimento
PIX Automático ainda não está disponível na API V1 da Zhex. Esta página descreve o conceito e o fluxo previsto para que você possa planejar a integração — mas hoje, cobrança recorrente em BR usa cartão (com customer_subscriptions) ou boleto recorrente. Acompanhe o changelog para o lançamento.
Quando vai fazer sentido
- Substituir cartão em SaaS BR — taxa ~10x menor, churn involuntário próximo de zero (cartão expira, conta bancária não).
- Mensalidades fixas (academia, escola, clube de assinatura) — ticket previsível dentro do limite autorizado.
- B2B com NF-e mensal — fluxo de cobrança recorrente sem fricção.
Quando NÃO usar: ticket variável grande (cliente perde controle), público que prioriza programa de pontos do cartão.
Fluxo planejado
A diferença de UX vs cartão: o cliente autoriza uma vez no app do banco, define limite e frequência, e depois disso o débito acontece sem nenhuma interação adicional. Falha de cobrança não tem que ver com cartão expirado nem CVV — tem a ver com saldo insuficiente, e o BACEN gerencia automaticamente o retry.
Limites previstos (BACEN)
| Campo | Limite |
|---|---|
| Valor máximo por cobrança | Definido pelo cliente na autorização (até R$ 15.000 sem complemento) |
| Cobranças por mês | Conforme frequência (weekly, monthly, etc.) |
| Janela de retentativa BACEN | 3 dias úteis após falha |
| Revogação | Cliente pode revogar a qualquer momento no app do banco |
Hoje — alternativas para recorrência
Enquanto PIX Automático não está disponível:
- Cartão recorrente via
CustomerSubscription— fluxo padrão, com retentativa em falha (dunning). - Boleto recorrente — gerado via job mensal seu chamando
POST /v1/payment_intentscompayment_method_types: ['boleto']. Trabalhoso mas funciona. - PIX one-shot mensal — você dispara cobrança PIX a cada ciclo. Bom para B2B; ruim para B2C (cliente abandona).
Atualizado em