Fingerprint é uma proteção anti-fraude disponível no novo widget do checkout. Requer uma impressão digital gerada por fingerprint.com logo antes de carregar o widget de pagamento. As informações recolhidas do cliente nesta etapa ajudam-nos a identificar fraudes e bloquear fraudes de forma discreta.
Integrar Fingerprint
Para integrar, são necessários os seguintes passos de integração:
[Lado do cliente] Carregue o script JS do fingerprint, idealmente globalmente, em todas as páginas.
[Lado do cliente] Chame fp.get() com o fingerprintLinkedId do objeto de pedido retornado na API OCTO.
[Fingerprint] Uma impressão digital é gerada internamente e enviada para a Ventrata via webhook.
[Backend] Consultar a requisição GET /orders/:id até que cardPayments.gateway não seja mais nulo.
[Backend] Quando a etapa 4 for bem-sucedida, carregue o formulário de pagamento com a sessão de pagamento por cartão.
[Backend] Confirme o pagamento como habitual.
📝 NOTAS
Script JS do Fingerprint
Usamos fingerprintjs-pro. Leia o Guia de início rápido para mais informações.
Basta incluir o ficheiro JavaScript. Em seguida, carregue-o com o seguinte script:
const fp = FingerprintJS.load({
apiKey: "XXXXXXXX",
endpoint: "https://fp.ventrata.com",
scriptUrlPattern: "https://fp.ventrata.com/web/v<version>/<apiKey>/loader_v<loaderVersion>.js",
});O valor
XXXXXXXXé a sua chave API pública. Por favor, contacte o seu Gestor de Conta para fornecer a sua chave API.
Use a funcionalidade ventrata/checkout
Para obter acesso a order.fingerprintLinkedId, necessária para a próxima parte, use a funcionalidade ventrata/checkout em todas as requisições de API que você fizer. Isto irá:
Tornar
cardPayments.gatewaynulo até recebermos um webhook do Fingerprint.Fornecer o valor
order.fingerprintLinkedId.
Se tiver alguma dúvida, não hesite em contactar a equipa da Ventrata.