Skip to main content

Bloquear pagamento para CPF/CNPJ diferente do cliente

Em algumas operações, especialmente em setores com risco de fraude, é essencial garantir que o pagamento de uma cobrança Pix seja feito exclusivamente pelo CPF ou CNPJ previamente cadastrado como cliente.

Para atender a esse cenário, a Woovi oferece o campo ensureSameTaxID no endpoint de criação de cobrança.

🛠 Como funciona?​

Ao criar uma cobrança (charge) via API, você pode utilizar o campo ensureSameTaxID. Esse campo, quando ativado, impede que o pagamento seja aceito caso o CPF/CNPJ do pagador seja diferente do informado no campo customer.

🚀 Exemplo de uso com curl​

curl -X POST "https://api.woovi.com/api/v1/application" \
-H "Authorization: {APP_ID}" \
-H "Content-Type: application/json" \
-d '{
  "ensureSameTaxID": true,
  "customer": {
    "name": "João",
    "email": "[email protected]",
    "taxID": "45784409158"
  }
}'

✅ O que acontece na prática?​

Com essa configuração ativada:

  • Se o pagador tentar concluir a cobrança com um CPF/CNPJ diferente daquele informado no campo customer.taxID, o pagamento será recusado.
  • A Woovi valida em tempo real o CPF/CNPJ de quem está tentando pagar com o do cliente registrado.
  • Ideal para prevenir fraudes e proteger operações sensíveis.

🧠 Conclusão​

A funcionalidade ensureSameTaxID é uma camada adicional de segurança que permite que você valide automaticamente a identidade do pagador e evite recebimentos indevidos. Recomendamos seu uso em operações com alto valor ou maior risco de chargeback via Pix (MEDs).

📘 Consulte nossa documentação da API de cobrança para mais detalhes sobre todos os campos disponíveis.