3DS - Primeiros passos para integrar pagamento com cartão
Documentação de Integração 3DS - WiteTec#
🎯 Introdução#
O 3DS (3D Secure) é um protocolo de segurança que adiciona uma camada extra de autenticação para transações com cartão de crédito. Esta documentação ensina como integrar o 3DS em sua aplicação usando a WiteTec.Benefícios do 3DS#
✅ Maior segurança - Reduz fraudes em transações online
✅ Compliance - Atende regulamentações internacionais
✅ Melhor aprovação - Aumenta a taxa de aprovação de transações
✅ Proteção ao comerciante - Reduz chargebacks
🔧 Pré-requisitos#
1. Credenciais Necessárias#
2. Scripts Necessários#
Coloque esse script no seu frontend3. Dados do Cartão#
⚙️ Configuração Inicial#
1. Inicializar o ShieldHelper#
2. Obter Configurações 3DS#
🚀 Implementação Passo a Passo#
Passo 1: Preparar os Dados da Transação#
Passo 2: Preparar o 3DS#
Passo 3: Criptografar Dados do Cartão#
Passo 4: Obter IP do Usuário#
Passo 5: Estruturar Requisição#
Passo 6: Enviar Transação#
Caso tenha um service com o endereço base da api configurado, pode reaproveitar. É apenas um EXEMPLO de implementação. Adapte ao seu uso e seu framework.
Chame a url da sua api que é usada para criar uma transaçãoPasso 7: Finalizar 3DS#
💻 Exemplos de Código#
Exemplo 1: HTML Completo#
Exemplo 2: React/Next.js#
⚠️ Tratamento de Erros#
1. Erros Comuns e Soluções#
2. Validações Recomendadas#
🧪 Testes#
2. Cenários de Teste#
✅ Transação aprovada - Cartão válido com saldo
✅ Transação recusada - Cartão sem saldo
✅ 3DS obrigatório - Cartão que requer autenticação
✅ Dados inválidos - Testar validações
✅ Erro de rede - Simular falha de conexão
❓ FAQ#
Q: O que é 3DS?#
A: 3DS (3D Secure) é um protocolo que adiciona uma camada extra de segurança para transações online, solicitando autenticação adicional do portador do cartão.Q: É obrigatório usar 3DS?#
A: Não é obrigatório, mas é altamente recomendado para maior segurança e compliance com regulamentações.Q: Como funciona o ShieldHelper?#
A: O ShieldHelper é responsável por criptografar os dados sensíveis do cartão antes de enviar para a API, garantindo a segurança das informações.Q: Posso testar sem cartão real?#
A: Sim! Use os cartões de teste fornecidos na seção de testes.Q: O que fazer se a transação falhar?#
A: Verifique os logs de erro, valide os dados do cartão e tente novamente. Se o problema persistir, entre em contato com o suporte.
📞 Suporte#
Para dúvidas ou problemas com a integração:Modificado em 2025-11-10 17:23:30
