Pix Automático
Conheça o Pix Automático
O Pix Automático permite realizar cobranças recorrentes via Pix após uma autorização prévia do pagador.
Depois que a autorização é ativada, os próximos pagamentos podem ser processados sem uma nova autorização a cada ciclo. A criação das cobranças pode ser manual ou automática, conforme o modo definido na autorização.
Ao concluir este guia, você entenderá a jornada do Pix Automático e poderá escolher como as cobranças recorrentes serão criadas.
Quando utilizar
Utilize o Pix Automático quando sua operação precisar:
- realizar cobranças recorrentes via Pix;
- obter uma autorização prévia do pagador;
- processar os próximos pagamentos sem uma nova confirmação manual;
- escolher entre criar as cobranças pela aplicação ou gerá-las automaticamente.
Para comparar esse modelo com Assinaturas, consulte Diferença entre Pix Automático e Assinaturas.
Como funciona
A integração pela API do Asaas utiliza a Jornada 3.
No primeiro pagamento, o QR Code reúne:
- o pagamento da cobrança inicial;
- a autorização para os próximos pagamentos.
Após a conclusão desse fluxo, a autorização passa para ACTIVE e pode ser utilizada para os próximos ciclos.
Primeiro pagamento
Pagamentos recorrentes
Escolha como criar as cobranças recorrentes
Na criação da autorização, o campo paymentCreationMode define quem será responsável pelas cobranças dos próximos ciclos.
| Modo | Como funciona |
|---|---|
MANUAL | Sua aplicação cria cada cobrança recorrente pela API |
SUBSCRIPTION | As cobranças são geradas automaticamente por uma assinatura |
MANUAL é o modo padrão.
Ao utilizar SUBSCRIPTION, informe também o campo value para configurar o valor das cobranças.
Consulte a referência de criação da autorização.
Jornada do Pix Automático
%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
A["Criar autorização"] --> B["Apresentar o QR Code"]
B --> C["Pagador realiza o primeiro pagamento"]
C --> D["Autorização fica ACTIVE"]
D --> E{"Como as cobranças serão criadas?"}
E --> EManual(("MANUAL"))
E --> EAutomatico(("SUBSCRIPTION"))
EManual --> F["Aplicação cria cada cobrança"]
EAutomatico --> G["Assinatura gera as cobranças"]
F --> H["Processar os débitos via Pix"]
G --> H
H --> I["Acompanhar os eventos por Webhook"]
classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,stroke-width:3px,font-size:17px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px
classDef respostaManual fill:#8B5CF6,stroke:#6D28D9,color:#FFFFFF,stroke-width:3px,font-size:16px
classDef respostaAutomatico fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px,font-size:16px
class A inicio
class E decisao
class B,C,D,F,G,H validacao
class I sucesso
class EManual respostaManual
class EAutomatico respostaAutomatico
linkStyle default stroke:#94A3B8,stroke-width:2px
linkStyle 4 stroke:#8B5CF6,stroke-width:4px
linkStyle 5 stroke:#22C55E,stroke-width:4px
Para criar a autorização e configurar o modo de geração das cobranças, consulte Implementação do Pix Automático.
O que sua integração precisa acompanhar
Independentemente do modo escolhido, acompanhe:
- o status da autorização;
- o processamento das cobranças;
- recusas, cancelamentos e falhas;
- os eventos enviados por Webhook.
No modo MANUAL, sua aplicação também precisa controlar a criação das cobranças de cada ciclo.
Consulte Fluxos de Webhook do Pix Automático para conhecer as sequências esperadas.
Quando uma instrução for recusada, consulte Motivos de Recusa.
Retentativas
O Pix Automático permite configurar retentativas para determinados cenários de falha no pagamento.
As regras e a implementação desse fluxo estão em Processo de retentativas — Jornada 3 API.
Próximos passos
Updated 15 days ago