Fingerprint es una protección antifraude disponible en el nuevo widget de checkout. Requiere una huella digital generada por fingerprint.com justo antes de cargar el widget de pago. La información recopilada del cliente en este paso nos ayuda a identificar el fraude y rechazarlo discretamente.
Integrar Fingerprint
Para integrar, se requieren los siguientes pasos de integración:
[Lado del cliente] Cargar el script JS de fingerprint, idealmente de forma global, en todas las páginas.
[Lado del cliente] Llamar a fp.get() con el fingerprintLinkedId del objeto de pedido devuelto en la API OCTO.
[Fingerprint] Se genera una huella digital internamente y se envía a Ventrata mediante webhook.
[Backend] Consultar la solicitud GET /orders/:id hasta que cardPayments.gateway ya no sea nulo.
[Backend] Cuando el paso 4 tenga éxito, cargue el formulario de pago con la sesión de pago con tarjeta.
[Backend] Confirme el pago normalmente.
📝 NOTAS
Script JS Fingerprint
Usamos fingerprintjs-pro. Lea el Guía de inicio rápido para más información.
Simplemente necesitas incluir el archivo JavaScript. Luego cárgalo con el siguiente 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",
});El
XXXXXXXXvalor es tu clave API pública. Por favor, contacte con su Gestor de Cuenta para obtener su clave API.
Utilice la capacidad ventrata/checkout
Para obtener acceso a order.fingerprintLinkedId, necesaria para la siguiente parte, utilice la capacidad ventrata/checkout en todas las solicitudes API que realice. Esto hará lo siguiente:
Establecerá
cardPayments.gatewaycomo nulo hasta que recibamos un webhook de Fingerprint.Proporcionará el valor
order.fingerprintLinkedId.
Si tiene alguna pregunta, no dude en ponerse en contacto con el equipo de Ventrata.