Pular para o conteúdo principal

Bibliotecas de Segurança

A Sopague oferece bibliotecas especializadas para garantir a máxima segurança em suas transações de pagamento.

Bibliotecas Disponíveis​

Solução Integrada​

A Biblioteca Sopague é nossa solução mais completa, combinando criptografia RSA e anti-fraude em uma única biblioteca JavaScript.

Principais funcionalidades:

  • Criptografia RSA-OAEP com SHA-256
  • Sistema anti-fraude integrado
  • Zero dependências
  • Leve e rápida (~5KB minificado)
  • Compatível com todos os navegadores modernos

Ver documentação completa →

Guia de Início Rápido​

1. Escolha sua Biblioteca​

Para novos projetos: Recomendamos a Biblioteca Sopague por oferecer funcionalidades integradas.

Para projetos existentes: Você pode continuar usando as bibliotecas específicas (Anti-fraude ou 3DS).

2. Instalação​

<!-- Para obter a URL do CDN da biblioteca Sopague, entre em contato com o suporte -->
<script src="https://cdn.exemplo.com/sopague/sopague.min.js"></script>

<!-- Ou baixe e referencie localmente -->
<script src="/libs/sopague-integration-library-1.0.0.min.js"></script>

3. Configuração Básica​

// Configurar chave pública
Sopague.setEncryptPublicKey('sua-chave-publica-aqui');

// Inicializar anti-fraude
const sessionId = Sopague.initAntiFraud('seu-session-id');

// Criptografar dados
const encrypted = await Sopague.encryptCard('numero-do-cartao');

Exemplos Práticos​

E-commerce Completo​

Ver exemplo completo →

Exemplo prático de integração em um sistema de e-commerce com:

  • Formulário de pagamento
  • Validação de dados
  • Criptografia de cartão
  • Sistema anti-fraude
  • Interface responsiva

Integração NextJS​

Ver exemplo React/NextJS →

Hook personalizado e componente de pagamento para aplicações React/NextJS com:

  • TypeScript
  • Gerenciamento de estado
  • Tratamento de erros
  • Validação de formulários

JavaScript Vanilla​

Ver exemplo Vanilla JS →

Implementação simples em HTML + JavaScript para:

  • Páginas estáticas
  • Protótipos rápidos
  • Integração em sistemas legados

Configuração Avançada​

Variáveis de Ambiente​

# Chave pública RSA
NEXT_PUBLIC_RSA_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----..."

# ID da organização
NEXT_PUBLIC_ORG_ID="sua_organizacao_id"

# Versão da biblioteca
NEXT_PUBLIC_SOPAGUE_VERSION="1.0.0"

Configuração de Servidor​

// Exemplo de endpoint para processar pagamentos
app.post('/api/payments', async (req, res) => {
    const { encryptedCard, antiFraudSessionId, amount } = req.body;
    
    // Validar dados de segurança
    if (!encryptedCard || !antiFraudSessionId) {
        return res.status(400).json({ 
            message: 'Dados de segurança obrigatórios' 
        });
    }
    
    // Processar pagamento com API da SoPague
    // ...
});

Testes e Validação​

Teste de Criptografia​

async function testEncryption() {
    const testCard = '4111111111111111';
    const encrypted = await Sopague.encryptCard(testCard);
    console.log('Teste de criptografia:', encrypted ? '✅ Sucesso' : '❌ Falha');
}

Teste de Anti-Fraude​

function testAntiFraud() {
    const sessionId = Sopague.initAntiFraud('test-session');
    const currentSession = Sopague.getAntiFraudSessionId();
    console.log('Teste de anti-fraude:', currentSession ? '✅ Sucesso' : '❌ Falha');
}

Compatibilidade​

NavegadorVersão MínimaStatus
Chrome37+✅ Suportado
Firefox34+✅ Suportado
Safari11+✅ Suportado
Edge79+✅ Suportado
Opera24+✅ Suportado

Requisitos:

  • HTTPS obrigatório (Web Crypto API)
  • JavaScript habilitado
  • Suporte a Promises

Suporte e Recursos​

Documentação Adicional​

Recursos Úteis​

Próximos Passos​

  1. Escolha a biblioteca que melhor atende suas necessidades
  2. Implemente seguindo os exemplos fornecidos
  3. Teste em ambiente de desenvolvimento
  4. Configure as variáveis de ambiente
  5. Integre com sua API de pagamentos
  6. Monitore o funcionamento em produção

Para dúvidas ou suporte, entre em contato com nossa equipe técnica.