A implementação de um sistema antifraude é crucial para proteger tanto os negócios quanto os consumidores contra atividades fraudulentas.
Javascript
Visão Geral
A integração do antifraude na sua aplicação consiste em adicionar um código JavaScript específico dentro das tags <head> e <body> da sua página checkout. Esse código será automaticamente executado quando a página for carregada, permitindo a análise antifraude das transações.
Requisitos
- Suporte a JavaScript: Seu navegador deve estar habilitado para executar JavaScript.
Procedimentos
- Inclusão do Código JavaScript
Adicione o seguinte código dentro das tags<head>e<body>da sua página HTML de checkout.
Código para a tag
<html>
<head>
<script type="text/javascript" src="https://h.online-metrix.net/fp/tags.js?org_id=1snn5n9w&session_id=adiq_br2dd470e0-698f-4ae4-bf31-71ccd33970dd"></script>
</head>
<body>
<noscript>
<iframe style="width: 100px; height: 100px; border: 0; position:absolute; top: -5000px;"
src="https://h.online-metrix.net/fp/tags.js?org_id=1snn5n9w&session_id=adiq_br2dd470e0-698f-4ae4-bf31-71ccd33970dd">
</iframe>
</noscript>
</body>
</html>
Código para a tag
A estrutura final da sua página HTML deve se parecer com o exemplo abaixo:
<html>
<head>
<script type="text/javascript" src="https://h.online-metrix.net/fp/tags.js?org_id=1snn5n9w&session_id=adiq_br2dd470e0-698f-4ae4-bf31-71ccd33970dd"></script>
</head>
<body>
<noscript>
<iframe style="width: 100px; height: 100px; border: 0; position:absolute; top: -5000px;"
src="https://h.online-metrix.net/fp/tags.js?org_id=1snn5n9w&session_id=adiq_br2dd470e0-698f-4ae4-bf31-71ccd33970dd">
</iframe>
</noscript>
</body>
</html>
Configurações Adicionais
O link usado no script deve ser configurado da seguinte forma:
| Homologação | Produção | |
|---|---|---|
| org_id | 1snn5n9w | k8vif92e |
| organization_id | adiq_br | adiq_br |
Sessão e GUID
O session_id deve ser composto pelo organization_id seguido por um GUID (Globally Unique Identifier), um identificador único global gerado pela aplicação do merchant. Este GUID é gerado no servidor do cliente e deve ser informado no campo payment_method_details.credit_card.antifraud_fingerprint_id na criação do recebimento.
Exemplo de GUID: 2dd470e0-698f-4ae4-bf31-71ccd33970dd
Para mais informações sobre como gerar um GUID, consulte os links abaixo:
Gerar GUID em .NET
Gerar GUID em Java
Implementação SDK Android
Links e Downloads
Para implementar o sistema antifraude, utilize os seguintes links para baixar o SDK Android do nosso parceiro Adiq:
Para utilizar os arquivos, faça o download e substitua-os com as versões mais recentes sempre que houver atualizações no código.
É altamente desaconselhada a utilização de SDKs obtidos de fontes não oficiais.
Procedimentos de Implementação do Antifraude
A implementação do antifraude requer a integração de uma chamada ao SDK Android da Adiq no botão de execução de compra. Esse botão deve estar na view onde o cliente final realiza o pagamento, após a inserção dos dados do cartão de crédito ou débito.
Requisitos:
- Versão mínima do Android: 4.4 (KitKat, API Level 19) ou superior.
Procedimentos
- Referenciar o SDK Android adiq-antifraude-package-1.0.0-hml.aar
Após clicar em JAR/AAR Dependency, selecione o diretório onde o SDK foi extraído.
- Desenvolvimento Mobile
O código a seguir é responsável por gerar opayment_method_details.credit_card.antifraud_fingerprint_id, que deve ser enviado para a API de pagamentos em /payins:
executeDeviceFingerPrint(orgId: String, fingerprintServerUrl: String, providerIdentifier: String): String
Onde:
| Homologação | Produção | |
|---|---|---|
| orgId | 1snn5n9w | k8vif92e |
| fingerprintServerUrl | h.online-metrix.net | h.online-metrix.net |
| providerIdentifier | adiq_br | adiq_br |