VTOL ANTIFRAUDE

Manual de Usuario

Cambios por revisiones

Fecha	Revisión	Cambios – Motivo
21/08/2019	1.0	Creación del documento
20/05/2020	1.1	Revisión del documento
17/12/2020	1.2	Agregado de funcionalidades de Whitelist y Condición de aplicación de reglas.
22/12/2020	1.3	Agregado de especificación de Servicios para configurar las Compañías.

Indice

1. Acerca del manual

1.1 Propósito y alcance

El presente manual tiene por finalidad la capacitación de los usuarios que deseen utilizar el módulo antifraude del producto VTOL.
Brinda la información necesaria, con el nivel de detalle suficiente para que el usuario pueda configurar las reglas de antifraude, tanto de tarjetas en listas negras como de reglas de acumulación.

2. Introducción

2.1 ¿Qué es VTOL Antifraude?

VTOL Antifraude es un sistema que evalúa las transacciones presenciales y no presenciales realizadas con tarjetas crédito y débito, con el objetivo de prevenir y controlar transacciones fraudulentas. De esta manera se reducen las pérdidas por fraude en las transacciones de los comercios.

El usuario administrador podrá configurar las reglas antifraude en la consola web de VTOL. De esa manera se validarán dichas reglas contra los datos entregados por el POS, efectuando un rechazo de la operatoria en caso de que no pase las validaciones.

La lógica de validación de transacción será on-line, al momento de realizar el pago.

Las reglas de antifraude disponibles son las siguientes:

Whitelist: Listas blancas, son tarjetas que evitan todas las demás reglas.
Blacklist: Listas negras o baneos de números de tarjetas.
Velocity checks: Reglas de acumulación para validar datos de las operaciones realizadas.

Cómo funciona:

VTOL recibe las transacciones y se evalúan en tiempo real contra el módulo de prevención de fraude.
Se analizan múltiples variables:
- En primer lugar se validan las listas negras.
- En segundo lugar se validan las reglas de acumulación.
VTOL retorna la respuesta sobre la transacción, aprobada o rechazada, según las validaciones del módulo.

Importante

Si se procesa una transacción y el número de tarjeta se encuentra en la Blacklist, se rechaza la transacción y no será necesario validar la transacción mediante los velocity checks.

A continuación se explicará la forma de configurar todas las opciones para poder operar con el módulo AF de VTOL.

3. Servicios de configuración de Compañías

En el módulo de VTOL Antifraude se deben configurar las Compañías que fueron dadas de alta en VTOL Server, las cuales procesarán sus transacciones validando antifraude.

Para configurar las compañías en AF, se podrá realizar por medio de la base de datos (mongoDB), o por medio de webservices (API Rest)

3.1 Configuración por Base de datos

Para conectarse a la base de datos, se puede utilizar una herramienta de administración de base de datos MongoDB, como ser Robo3T.

Para configurar los datos, es necesario editar la collection “Company”.

Los parámetros a configurar son:

code: Corresponde al código de la compañía cargado en VTOL Server.
companyName: Nombre de la compañía cargado en VTOL Server.
applicationCondition: Array de condiciones de aplicación. Importante: El applicationCondition "default" con id "0" se debe cargar obligatoriamente para todas las compañías que se dan de alta.
- id: Identificador de la condición de aplicación. (NOTA: el Id debe ser único por compañía)
- code: Código de la condición de aplicación. Alfanumérico. (NOTA: éste código es el que debe enviar el punto de venta en la autorización a través de VTOL)
- description: Descripción de la condición de aplicación. Alfanumérico.

Ejemplo de insert:

company = {
   "code":"1",
   "companyName":"Napse",
   "applicationCondition":[
      {
         "id":"0",
         "code":"Default",
         "description":"Sin Condición"
      },
      {
         "id":"1",
         "code":"Recurring",
         "description":"Recurrente"
      },
      {
         "id":"2",
         "code":"Subscription",
         "description":"Suscripción"
      }
   ],
   "_class":"global.napse.vtol.antifraud.model.Company"
}

3.2 Configuración por API Rest

El servicio /antifraud permite configurar los datos de las compañías que utilizarán el módulo de VTOL antifraude.

Documentación en Swagger

El detalle completo del servicio de Configuración de compañías se encuentra documentado en:

https://{IP}:{Port}/antifraud/swagger-ui.html

Al ingresar en Swagger, se mostrarán los siguientes servicios:

3.2.1 Crear Compañía

Permite dar de alta una Compañía dentro del módulo Antifraude de VTOL.

Método	POST
Url	https://{{baseUrl}}/config/company/add

Los datos necesarios para el alta son:

code	Corresponde al código de la compañía cargado en VTOL Server.
companyName	Nombre de la compañía.
applicationCondition (Array de condiciones)	id	Identificador de la condición de aplicación.
	code	Código de la condición de aplicación. Alfanumérico.
	description	Descripción de la condición de aplicación. Alfanumérico.

Importante: El applicationCondition "default" con id "0" se debe cargar obligatoriamente para todas las compañías que se dan de alta, es decir deben tener como mínimo, la siguiente condición de aplicación:

{
   	"id" : "0",
   	"code" : "Default",
	"description" : "Sin Condición"
}

Invocar al servicio

Para dar de alta una Compañía, se puede utilizar la herramienta Swagger, de la siguiente manera:

Abrir la url: https://{IP}:{Port}/antifraud/swagger-ui.html
Dirigirse a la sección:
Presionar el botón:
Completar los datos del JSON:
Presionar el botón Execute:
Si los datos informados en el JSON son correctos, se creará la Compañía, retornando el código HTTP201 y un eco del id enviado:

3.2.2 Consulta de Compañía por id

Permite consultar las compañías que están creadas dentro del módulo antifraude de VTOL. Este servicio retorna como respuesta una sola compañía.

Método	GET
Url	https://{{baseUrl}}/config/company/{companyId}

Invocar al servicio

Para consultar las Compañías, se puede utilizar la herramienta Swagger, de la siguiente manera:

Abrir la url https://{IP}:{Port}/antifraud/swagger-ui.html
Dirigirse a la sección
Presionar el botón
Completar el id de la Compañía a consultar
Presionar el botón Execute:
Si los datos informados son correctos, retornará el código HTTP200 y los datos de la compañía consultada.

3.2.3 Consultar todas las Compañías

Permite consultar todas las compañías que están creadas dentro del módulo antifraude de VTOL.

Método	GET
Url	https://{{baseUrl}}/config/company/findAll

Invocar al servicio

Para consultar las Compañías, se puede utilizar la herramienta Swagger, de la siguiente manera:

Abrir la url https://{IP}:{Port}/antifraud/swagger-ui.html
Dirigirse a la sección
Presionar el botón
Presionar el botón Execute:
Si los datos informados son correctos, retornará el código HTTP200 y los datos de las compañía creadas en VTOL AF.

3.2.4 Modificar Compañía

Permite modificar una compañía que está creada dentro del módulo antifraude de VTOL.

Método	GET
Url	https://{{baseUrl}}/config/company/update

Invocar al servicio

Para consultar las Compañías, se puede utilizar la herramienta Swagger, de la siguiente manera:

Abrir la url https://{IP}:{Port}/antifraud/swagger-ui.html
Dirigirse a la sección
Presionar el botón
Completar los datos del Json con los datos a modificar:
Presionar el botón Execute:
Si los datos informados son correctos, retornará el código HTTP200:

4. Configuración de reglas

A continuación se explicará la funcionalidad y uso de cada una de las opciones para manejar las reglas antifraude.

4.1 Whitelist

Las whitelist o listas blancas son un grupo de números de tarjetas que evitarán todos los controles de antifraude. Se cargarán en el módulo AF de VTOL y al momento de una compra con una tarjeta de lista blanca, no se ejecutará ninguna validación más.

Las listas blancas persisten números de tarjetas enteros, que AF VTOL los hasheará por PCI (utilizando SHA-512).

Tener en cuenta que cuando una transacción se origine desde un origen físico con pinpad, este enmascara la tarjeta y no se podrá efectuar la validación de lista blanca; sólo se podrá validar cuando la transacción se realice desde alguno de los siguientes orígenes:

Físico sin uso de pinpad (puede ser mediante ingreso manual o con teclado de lectura de banda magnética)
IVR (Interactive Voice Response): sistemas telefónico capaces de recibir llamadas e interactuar a través de grabaciones de voz y el reconocimiento de respuestas.
E-Commerce: operaciones a través de comercio electrónico.

AF VTOL realizará la validación de la tarjeta proveniente del POS, de IVR o de eCommerce con las persistidas en la lista blanca.

Acceso

Para acceder a la configuración de las reglas de blacklist, seleccionar la opción "Whitelist" dentro del menú: (Antifraude > Configuración)

Descripción de la página

A través de esta página es posible administrar las reglas Whitelist con las cuales trabajará el sistema.

Funcionalidad

Desde la pantalla de configuración de Whitelist se podrá:

Buscar las tarjetas cargadas
Agregar nuevas tarjetas a la lista blanca
Eliminar las tarjetas existentes
Habilitar o deshabilitar las tarjetas

Búsqueda de Tarjetas

La búsqueda de tarjetas en lista blanca se podrá realizar ingresando los filtros de búsqueda.

Compañía: campo obligatorio
Número de tarjeta: se podrá buscar teniendo en cuenta el largo de la tarjeta. Las opciones son: primeros 6 dígitos (debe coincidir exactamente con los primeros 6 dígitos de la tarjeta), últimos 4 dígitos (debe coincidir exactamente con los últimos 4 dígitos de la tarjeta) o la tarjeta completa.

En la grilla de resultados se mostrarán visibles los primeros 6 y los últimos 4 dígitos de la tarjeta. El resto de los números aparecerán enmascarados.

Agregar Tarjeta a Whitelist

Para cargar una tarjeta a Whitelist, se debe presionar el botón "Crear". Hecho esto la aplicación solicitará el ingreso del número de la tarjeta (debe ser único) y la fecha hasta que se validará (ingreso opcional).

Para que la tarjeta quede habilitada para ser validada en la whitelist, el checkbox "Habilitar" debe quedar tildado. Si el checkbox queda destildado, entonces esa tarjeta no se validará en la whitelist.

Presionar "Aceptar" para concluir el alta de la tarjeta. Presionar "Cancelar" si no se desea cargar la tarjeta en el sistema.

Eliminar Tarjetas

Para eliminar una tarjeta, se deberá seleccionar en la columna "Selección" las tarjetas que se quieren eliminar. Luego oprimir el botón "Eliminar".

Al presionar "Eliminar" el sistema solicitará confirmar la eliminación. Al oprimir "Aceptar" se persistirán los cambios, y al oprimir "Cancelar" no se realizará ningún cambio.

Habilitación de Tarjetas

Para habilitar o deshabilitar tarjetas es necesario seleccionar, en la columna "Selección" las tarjetas que se quieren habilitar o deshabilitar. Luego hay que presionar el botón "Habilitar/Deshabilitar" y se realizará la acción opuesta al estado en que estaba la tarjeta al momento de realizar la acción.

El estado actual está indicado por el valor de la columna "Habilitado".

4.2 Blacklist

Las blacklist o listas negras son un conjunto de números de tarjetas fraudulentas, que se cargarán en el sistema AF VTOL para rechazarlas al momento de una operatoria.

Las listas negras persisten números de tarjetas enteros, que AF VTOL los hasheará por PCI (utilizando SHA-512).

Tener en cuenta que cuando una transacción se origine desde un origen físico con pinpad, este enmascara la tarjeta y no se podrá efectuar la validación de lista negra; sólo se podrá validar cuando la transacción se realice desde alguno de los siguientes orígenes:

Físico sin uso de pinpad (puede ser mediante ingreso manual o con teclado de lectura de banda magnética)
IVR (Interactive Voice Response): sistemas telefónico capaces de recibir llamadas e interactuar a través de grabaciones de voz y el reconocimiento de respuestas.
E-Commerce: operaciones a través de comercio electrónico.

AF VTOL realizará la validación de la tarjeta proveniente del POS, de IVR o de eCommerce con las persistidas en la base de lista negra.