Como garantir que apenas o cliente correto pague uma cobrança Pix
Evite fraudes ou problemas financeiros com validação automática e em tempo real por CPF/CNPJ com este novo recurso.

Em operações financeiras, principalmente aquelas com maior valor e a obrigatoriedade do pagador ter o mesmo CPF/CNPJ do cadastro, não basta apenas gerar uma cobrança — é fundamental garantir que quem está pagando é exatamente quem deveria pagar.
Na Woovi, isso é possível através de um controle simples, técnico e extremamente eficiente: o campo ensureSameTaxID.
O problema real
No Pix, qualquer pessoa com acesso ao QR Code ou código de pagamento pode tentar realizar o pagamento. Para alguns modelos de negócios (venda de veículos, crédito, marketplaces ou operações sensíveis) isso não é aceitável, uma vez que abre espaço para cenários como:
- Pagamentos feitos por terceiros não autorizados
- Tentativas de fraude ou “laranjas”
- Dificuldade de rastreabilidade e validação do pagador
A solução: ensureSameTaxID
Ao criar uma cobrança via API da Woovi, você pode ativar o campo:
"ensureSameTaxID": true
Com isso, você instrui a plataforma a validar automaticamente se o CPF/CNPJ do pagador é o mesmo do cliente definido na cobrança. Exemplo prático

O que acontece na prática?
Quando essa opção está ativada:
- O pagamento só é aceito se o CPF/CNPJ do pagador for idêntico ao informado em
customer.taxID - Qualquer tentativa com dados diferentes é recusada automaticamente
- A validação acontece em tempo real, sem necessidade de intervenção manual
Por que isso importa?
Essa funcionalidade cria uma camada adicional de segurança que:
- Reduz fraudes em operações Pix
- Garante que o pagamento está vinculado ao cliente correto
- Evita problemas operacionais e financeiros (como disputas e MEDs)
- Aumenta a confiabilidade do fluxo de cobrança
Quando usar?
O ensureSameTaxID é especialmente recomendado para:
- Operações de crédito
- Pagamentos de alto valor
- Ambientes com risco de fraude
- Fluxos onde a identidade do pagador é crítica
Mais do que gerar cobranças, é sobre controlar quem pode pagar
Com o ensureSameTaxID, você transforma o Pix em um meio de pagamento mais seguro, previsível e alinhado com as regras do seu negócio — sem prejudicar a experiência do usuário.
Consulte a documentação da API da Woovi para explorar todos os parâmetros disponíveis e evoluir ainda mais sua integração.
