Configuração e Processo Pix Recorrente - Banco Itaú
| Importante | |
| Para a utilização deste recurso, certifique-se de que o contrato junto ao banco (Itaú) prevê a modalidade de Pix Recorrente / Automático e que as credenciais de API para Pix Recorrente foram liberadas. |
O Pix Recorrente permite a cobrança automática via API.
Siga o passo a passo abaixo para realizar a configuração correta no BankPlus.
1. Acesse BankPlus → Cobrança → Configurações → Contrato Bancário.
Ao criar ou editar um contrato, na aba Arquivos de Licença, selecione a licença correspondente ao Pix Recorrente (Ex: 341 - PIX Recorrente Itaú).
Certifique-se de que a coluna Modalidade esteja definida como PIX Automático.
Siga o passo a passo abaixo para realizar a configuração correta no BankPlus.
1. Acesse BankPlus → Cobrança → Configurações → Contrato Bancário.
Ao criar ou editar um contrato, na aba Arquivos de Licença, selecione a licença correspondente ao Pix Recorrente (Ex: 341 - PIX Recorrente Itaú).
Certifique-se de que a coluna Modalidade esteja definida como PIX Automático.
2. Na aba Geral, preencha as informações bancárias obrigatórias:

- Agência e Conta Corrente: Preencha conforme dados da conta emissora.
- Chave PIX: Informe a chave Pix vinculada ao contrato.
3. Vá até a aba Boleto, sub-aba Geral.
Realize as seguintes configurações para garantir o funcionamento do layout:
Realize as seguintes configurações para garantir o funcionamento do layout:
- Layout do Boleto: Selecione PIX_QrCode.
- Tipo de Documento: Selecione PIX - PIX Automático.
- Marque a opção Qr Code PIX.
- Recomendado marcar: Permitir imprimir/enviar boleto somente após confirmado (conforme regra de negócio).
4. Na aba Arquivo, foi criado um campo de Identificação dos Clientes no Banco, campo que será alimentado pelo WebHook com as informações do cliente com as informações cadastrais do cliente, ID e Status da Recorrência.
Serviço Necessário | ||||||||
Para habilitar o WebHook, é necessário contratar o time de Serviços. Isso se faz necessário para a liquidação dos títulos em tempo real e para alimentar o campo de Identificação do cliente no Banco. | ||||||||
- Marque a flag Registro de cobrança online via API.
- Preencha as credenciais: Cliente ID e Client Secret.(Vale relembrar que as credenciais que serão informadas nesse campo deve ser credenciais específicas)
- Clique no botão Habilitar WebHook e selecione a Versão do WebHook: "341_PIX_AUTOMATICO_V1.0 - WebHook PIX Automático Itaú".
- Clique no botão Parâmetros API (seta indicada na imagem).
- Na janela que se abrir, configure:
- Política de retentativa: Ex: NAO_PERMITE.
- Descrição recorrência: Informe o motivo (Ex: streaming de música).
- Periodicidade: Ex: MENSAL.
- ID DO WEBHOOK: Informe o identificador do Webhook configurado no portal do banco.
| Atenção | |
| As demais abas (Contabilização, Ações da Remessa, Desconto/Juros) devem seguir a configuração padrão da sua empresa conforme as normas internas de contabilização. |
Processo de Geração do PIX Automático
Para que o Título seja enviado e confirmado pelo banco como PIX Recorrente, existe uma regra específica de validação de datas que deve ser respeitada no momento da emissão.
⚠️ | Atenção à Data de Vencimento | |||||||
| A Nota Fiscal deve ter o vencimento entre 2 a 10 dias posteriores à data atual. Caso o título tenha a data de vencimento divergente a esses dias, o título será rejeitado pelo Banco. | ||||||||
Confirmação e Pagamento
Após a confirmação do título, ao visualizá-lo, você verá que será gerado o QR Code para pagamento.
Quando o cliente efetuar o pagamento do mesmo, aparecerá um Pop-up com a mensagem solicitando a confirmação da recorrência. Esta etapa é fundamental para que, quando o cobrador for realizar a cobrança futura, o Pix já seja debitado automaticamente sem a necessidade de uma nova confirmação do devedor.
Retorno e Liquidação (WebHook)
O processo de retorno é automatizado via WebHook e realiza as seguintes operações:
- Liquidação Financeira: Após o cliente realizar o pagamento do QR Code, o WebHook retornará com a liquidação do título, gerando automaticamente o Contas a Receber e o Lançamento Contábil.
- Vínculo de Recorrência: Quando o cliente confirma a recorrência, o WebHook retorna alimentando o campo Identificação dos Clientes no Banco, dentro do Contrato Bancário, adicionando as informações do cliente com o ID e Status da recorrência.