Guia de Uso | Efí PIX Automático
1. Ativar o PIX Automático no SGP
1.1 Configurando o Contrato
Para usar o PIX Automático, o cliente precisa ter um contrato ativo, para cadastrar o PIX Automático, basta acessar o cadastro do cliente e editar o Serviço.
Na seção Dados do Plano, selecione o Portador do PIX Automático, a forma de cobrança PIX e ative a Cobrança Automática.
Exemplo: Se hoje for dia 8, só é possível ativar recorrência para vencimentos a partir do dia 10.
1.2 Acessar o Gerenciador do PIX Automático
Depois de criar o contrato, clique em Opções e Gerenciar PIX Automático.
Na tela, você verá o status atual do PIX Automático para esse contrato (cada contrato possui a própria recorrência). Para cadastrar, clique em Cadastrar PIX Automático e selecione o contrato desejado.
1.3 Gerando o QR Code da Recorrência
Ao criar a recorrência, o sistema gera um QR Code e um código PIX Copia e Cola. O cliente deve usar um aplicativo bancário que ofereça suporte ao PIX Automático.
1.4 Status da Recorrência
Depois que o cliente ler o QR Code, o status pode ser:
- CRIADA – o cliente ainda não leu o QR Code
- APROVADA – o cliente leu e aceitou no app
- CANCELADA – o cliente cancelou a autorização
- Nubank: envia cancelamento ao SGP.
- Banco do Brasil: pode não avisar automaticamente.
Após aprovada, aparece um ícone de lixeira que permite desativar a recorrência.
2. Emissão de Faturas Recorrentes
Após a recorrência estar aprovada, o sistema poderá criar automaticamente os títulos mensalmente.
Regras importantes
- Apenas um título recorrente por mês.
- São recorrentes apenas: Mensalidades, Carnês e Emissões automáticas / lotes.
- Faturas avulsas não são recorrentes — aparecem como
cobv, nãocobr. - Títulos Avulsos não geram cobr
Exemplo de título recorrente (cobr):
Exemplo de título avulso (cobv):
2.1 Histórico de Ações
O SGP registra no histórico todas as ações relevantes: criação, aprovação, geração dos PIX mensais e recebimento de pagamento.
Pagamento (recebimento)
3. PIX Automático na Central do Assinante
O cliente também pode ativar ou desativar a recorrência diretamente pela Central do Assinante.
4. Informações Importantes
- Webhook único: A mesma conta da Efí não pode ser usada em mais de um SGP.
- Fluxo resumido: Criar contrato → cliente ativa no banco → SGP gera a mensalidade → banco debita automaticamente no vencimento.
- PIX cobr não pode ser pago manualmente (sem EMV/QR físico).
- CPF/CNPJ: A conta onde o PIX Automático será ativado deve ter o mesmo CPF/CNPJ do contrato.
- Retentativas: O sistema tentará cobrar por até 7 dias caso não haja saldo; depois o título será considerado inadimplente.
- Para cobrança no mesmo mês: Todo o processo precisa ser concluído até 2 dias antes do vencimento.














