Pular para o conteúdo principal

Integração com Antifraude

A Marlim utiliza uma ferramenta de identificação digital / device fingerprint (DFP) chamada ThreatMetrix e que é fornecida pela líder de mercado LexisNexis. Com esta identificação digital nós conseguimos otimizar e melhorar a conversão de compra dos nossos clientes pois tomamos melhores decisões ao analisar informações não sensíveis geradas pela ferramenta como IP, versão do OS, browser, entre outros.

Lembrando do nosso interesse em fornecer serviços de prevenção a fraude a partir de perfis comportamentais, os quais são lícitos e representam uma finalidade legítima, considerada a partir de situações concretas, tal como exigido pela LGPD.

Integração Web​

Você deverá inserir um script em JavaScript no Front-End do seu checkout. A URL da Threatmetrix será inserida no script e por isso deve ser corretamente preenchida, seguindo o figura abaixo:

Antifraude

Na URL, substitua os valores OrgID, ProviderMerchantID e DfpID conforme a orientação da imagem acima.

Importante

Os valores de OrgID e ProviderMerchantID serão disponibilizados pelo time de Desenvolvimento da Marlim durante a interação. Existem valores diferentes para Sandbox e Produção.

Insira a URL preenchida na tag script, seguindo a orientação abaixo:

const OrgID = 'XXXXXX';
const ProviderMerchantID = 'YYYYYY';
const DfpID = '123456789';

const url = `https://h.online-metrix.net/fp/tags.js?org_id=${OrgID}&session_id=${ProviderMerchantID}${DfpID}`;
          // https://h.online-metrix.net/fp/tags.js?org_id=XXXXXX&session_id=YYYYYY123456789

// Insira o resultado da variável url na tag script do seu HTML
<head>
  ... // outros scripts
  <script type="text/javascript" src={url}></script>
</head>

DfpID​

Esse valor deve representar o mesmo passado para a API de Transações da Marlim dentro do parâmetro dfp_id. É com esse valor que faremos o "match" entre o DFP do Browser do cliente no momento do pagamento com a request da API de Transações da Marlim.

O valor em DfpID geralmente é o número do pedido do seu cliente na sua plataforma.

Por exemplo, se URL do pedido do seu cliente for algo similar a: https://seusite.com/pedido/123456789, então valor a ser enviado para a API de Transações da Marlim dentro do parâmetro dfp_id deve ser: 123456789.

Caso, sua plataforma não tenha esse formato (exemplo sites SPA), você pode criar um hash único no frontend do seu checkout e adicionar no final da URL, como por exemplo: https://seusite.com/#ABC123, nesse caso, o valor a ser enviado para a API de Transações da Marlim dentro do parâmetro dfp_id deve ser: #ABC123 (o símbolo # nesse caso deve ser incluído).

Importante

O valor do DfpID deve ser único para cada pedido do seu cliente. Se forem passados valores repetidos em diferentes transações, sua conversão será impactada negativamente.

Exemplo de Request na API de Transações da Marlim passando o dfp_id
{
  "amount": 1000,
  "customer": {
    "name": "Luke Skywalker",
    "email": "luke@jedimaster.sw", 
    "document_number": "00099988877"
  },
  // ... outros parâmetros
  "dfp_id": "123456789",
}
Atenção!

O não preenchimento da URL da ThreatMetrix de forma exata como descrita nessa documentação, bem como valores incorretos em DfpID e dfp_id, podem atrapalhar a conversão da transação do seu cliente. Dúvidas, fale com a gente 🤓

Apps Nativos​

Para integrar com o Antifraude Marlim em aplicativos nativos (Android e iOS), converse com o time de desenvolvimento da Marlim para validarmos o SDK a ser utilizado.