¶ Integrações com PIX Automático – HubSoft
O PIX automático é uma modalidade de pagamento automatizado utilizando a estrutura já existente do PIX. O intuito do projeto é eliminar a antiga modalidade de Débito Automático, uma vez que será possível debitar diretamente na conta do cliente via PIX. A grande vantagem é que agora, a empresa não precisa gerar um convênio para cada banco, ou seja, basta a empresa fazer com convênio com 1 banco e será possível debitar na conta do cliente em qualquer outro banco brasileiro.
¶ Funcionamento do Pix Automático
O Pix Automático funciona a partir de uma autorização antecipada dada pelo pagador ao recebedor, permitindo que este realize cobranças recorrentes sem a necessidade de nova validação a cada transação. Essa autorização estabelece uma relação de recorrência entre as partes.
Para cada cobrança prevista, o recebedor deve registrar, junto ao seu Prestador de Serviço de Pagamento (PSP), uma solicitação individual antes do vencimento. Nesse registro, são informados detalhes como o valor exato a ser debitado para aquele ciclo específico.
Sobre agendamento de cobrança recorrente, esse processo é feito por meio da API Pix, onde o recebedor cria e agenda cada cobrança de forma independente. Isso permite que os valores possam variar entre os períodos, por exemplo, R$70 em um mês e R$80 no mês seguinte, desde que a instrução seja enviada corretamente para que o débito seja efetuado na data acordada.
¶ Etapas do Processo
Após a autorização da recorrência pelo pagador, o débito passa a ocorrer de forma automática, garantindo que os pagamentos sejam realizados dentro do prazo e sem a necessidade de novas confirmações.
-
Criação da Cobrança
O recebedor registra a cobrança no sistema e envia os detalhes (valor, data e identificadores) para sua instituição financeira (PSP).
-
Envio da Instrução
A instituição financeira do recebedor transmite a instrução de pagamento para a instituição do pagador.
-
Agendamento
A instituição do pagador agenda o débito na conta do cliente pagador. Esse agendamento fica visível no extrato como um lançamento futuro, trazendo mais transparência para o processo.
-
Débito
Na data definida (ou no próximo dia útil), o valor é debitado automaticamente, desde que haja saldo.
¶ Tentativas de Cobrança
-
São feitas até duas tentativas de débito no dia do vencimento.
-
Caso não haja saldo, o Banco Central permite até três tentativas adicionais nos dias seguintes.
¶ Jornadas 2 - Ativação via QR Code (Dados da Recorrência)
Na Jornada 2, o pagador autoriza o Pix Automático ao escanear um QR Code que contém apenas os dados da recorrência, sem associar nenhum pagamento imediato. Essa modalidade é ideal quando a empresa (recebedor) deseja configurar cobranças futuras mas não exige um pagamento no ato.
¶ Como funciona:
1. Geração do QR Code:
O recebedor cria um QR Code dinâmico por meio da API Pix, informando dados como: periodicidade da cobrança, identificação do recebedor e, se aplicável, limites de valor. Esse código não dispara nenhuma transação financeira imediata, ele serve apenas para registrar a autorização da recorrência.
2. Leitura pelo pagador:
O cliente (pagador) utiliza o aplicativo do seu banco para escanear o QR Code ou inserir o código no formato “Pix Copia e Cola”. Ao fazer isso, ele visualiza no app bancário todas as informações da recorrência, como o recebedor, o valor ou faixa de valores e a frequência de cobrança.
3. Confirmação da autorização:
Caso concorde com as condições apresentadas, o pagador confirma a autorização no próprio app.
O banco do pagador (PSP pagador) registra essa autorização e envia a confirmação para o banco do recebedor (PSP recebedor), concluindo o processo de ativação.
Vantagem principal: Essa jornada oferece simplicidade e rapidez, permitindo que o pagador autorize débitos automáticos futuros com apenas alguns cliques, e sem precisar efetuar qualquer pagamento imediato no momento da autorização.
¶ Vincular PIX ao Cliente
Após configurar a integração e a forma de cobrança, você poderá vincular uma recorrência de PIX ao cliente.
Acesse o cliente e vá até o menu lateral → Cadastro → aba Pix Automático.
Nesta aba, é possível adicionar novas recorrências vinculadas ao serviço do cliente.
Clique em “Adicionar”.
Em seguida, será exibida a opção para selecionar o serviço no qual a recorrência do PIX automático será registrada.
Selecione o serviço e salve.
Após salvar, serão gerados o QR Code e o PIX Copia e Cola para que o cliente possa autorizar a recorrência diretamente no aplicativo do banco.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados com as Integrações PIX Automatico. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ O que Fazer se a Integração PIX Não Funcionar?
-
Verifique as credenciais:
Confirme se os dados fornecidos pelo banco (client_id, client_secret, chave_pix, modalidade e certificado) estão corretos e atualizados. -
Revise a configuração no Hubsoft:
Vá em Configuração > Integrações > Pix e confirme se todos os campos obrigatórios estão preenchidos e se o Pix Automático está ativado. -
Consulte a documentação do banco:
Alguns bancos podem exigir parâmetros adicionais ou ter atualizado o formato de integração. -
Teste a comunicação:
Use o botão Ações > Testar na tela de configuração do Pix para confirmar se a conexão com o banco está funcionando corretamente.
¶ Como Vincular a integração PIX Automatica na uma Forma de Cobrança?
- Acesse Configuração > Financeiro > Forma de Cobrança.
- Localize a forma de cobrança desejada e clique em Editar.
- Na aba Configuração, preencha os campos necessários para a integração Pix e selecione o Pix Automático configurado anteriormente.
- Salve as alterações.
Com isso, a forma de cobrança estará apta para processar pagamentos recorrentes via Pix Automático.
¶ Preciso de uma Forma de Cobrança apenas para o Pix Automatico?
Não é necessário criar uma forma de cobrança exclusiva para o Pix Automático. Assim, quando a rotina de transmissão do Pix for executada, caso a forma de cobrança tenha as duas integrações habilitadas, o sistema verificará se o cliente possui recorrência para aquele serviço.
Se houver recorrência, será gerado o Pix automático; caso contrário, será gerado um Pix normal.
¶ Qual periodo antes do vencimento eu posso gerar a fatura para meu cliente com Pix Automatico?
Para evitar falhas na transmissão, gere a fatura com pelo menos 3 dias de antecedência em relação ao vencimento.
Caso a geração ocorra dentro desse período, o sistema automaticamente ajustará o vencimento para o primeiro dia do mês seguinte, evitando erros de processamento com o Pix Automático.