Central de Ajuda

Aparência

Carteiras de API Pix ​

O Sistema oferece integrações robustas com APIs Pix, projetadas para automatizar operações financeiras, reduzir erros humanos e acelerar o ciclo de fluxo de caixa. Este documento detalha as funcionalidades, benefícios e as configurações de rastreabilidade dessas integrações.

Benefícios da Integração via API ​

A adoção das APIs Pix transforma o processo de cobrança em uma operação dinâmica e eficiente:

  • Agilidade no Registro: A cobrança é registrada instantaneamente no ato da geração.
  • Liquidação Automática: O sistema identifica o pagamento em tempo real, eliminando a baixa manual e processos de arquivos de retorno.
  • Redução da Inadimplência: A confirmação imediata permite que o cliente regularize sua situação instantaneamente, inclusive para desbloqueio de serviços.
  • Custo-Benefício: Tarifas geralmente mais competitivas em comparação aos boletos bancários tradicionais.

APIs Pix Disponíveis ​

Integrações Homologadas

Comunicação via WhatsApp (Opa! Suite) ​

Através da parceria com a Meta e o Opa! Suite, o Sistema permite o envio de templates de cobrança otimizados diretamente para o WhatsApp do cliente.

  • Compatibilidade: Disponível para carteiras do tipo Gateway e Pix.
  • Funcionalidade: Envio automático de QR Code e chave "Pix Copia e Cola" de forma estruturada.
Configuração

Para detalhes técnicos de implementação, acesse: Enviar Template Cobrança Pix via WhatsApp com o Opa! Suite.

Gerenciamento e Automatização de Cobranças ​

1. Cancelamento Síncrono ​

Para garantir a integridade dos dados, o sistema utiliza o cancelamento unitário síncrono. Quando um cliente efetua o pagamento por um meio alternativo (cartão, dinheiro ou outro gateway), o sistema cancela a cobrança Pix principal imediatamente.

  • Segurança: Evita duplicidade de recebimento.
  • Fila de Contingência: Caso ocorra uma falha na comunicação síncrona, a cobrança entra automaticamente em uma fila para nova tentativa de cancelamento.

2. Rastreabilidade e Logs (Foco modobank) ​

O sistema mantém um log detalhado para auditoria e suporte, acessível na aba Histórico do Boleto:

  • Transparência: Registro completo de request (envio) e response (resposta da API).
  • Identificação de Erros: Facilita o diagnóstico de falhas de comunicação ou autenticação.

3. Lógica de Retentativa Automática ​

Em situações de instabilidade temporária na API, o sistema adota uma política de retentativa inteligente:

  • Intervalo: Tentativas a cada 3 horas.
  • Limite: Máximo de 5 execuções.
  • Exceções (Erros Críticos): O sistema interrompe as tentativas caso detecte erros definitivos, como:
    • Cobrança já cancelada anteriormente.
    • Ausência de credenciais (client_id ou client_secret) na carteira.
    • Falha de autenticação (Token expirado/inválido) na API modobank.

Considerações Finais ​

As integrações Pix representam o estado da arte na gestão de recebíveis. Quando configuradas corretamente, minimizam a carga operacional da equipe financeira e oferecem uma experiência de pagamento moderna e fluida para o cliente final.

Leia Também ​

Disponibilizado por IXC S.A.

© 2025