Image RemovedImage Added

VTOL CD AR - Manual de usuario 3.8.0.3

VTOL CRÉDITO / DÉBITO

...

Painel
borderColor #E4E3E3 bgColor #ffffff titleColor #ffffff borderWidth 1px titleBGColor #704581 title REVISIONES
Expandir title Expandir revisiones Fecha Revisión Cambios – Motivo 19/11/2009 1.0 Creación del documento 24/02/2011 1.1 Link al manual de usuario del VTOL Core 30/12/2011 1.2 Agregado de reportes de "Movimientos de tarjetas" 27/12/2012 1.3 Modificación imágenes de consola 20/05/2013 1.4 Agregado parámetros Prefijos y opciones de pago 11/11/2013 1.5 Agregado de Configuración de Autorizador, y actualización de pantalla de definición de lote. 23/04/2014 1.6 Agregado Activación de Terminales 23/04/2014 1.7 Agregado Reporte Estado de Terminales 23/06/2014 1.8 Revisión anual de documentación 21/08/2014 1.9 Actualización de Claves de encriptación para cumplimiento de Norma PA-DSS 12/02/2016 2.0 Agregado de Reportes de Canales y Configuración de Locales. 21/10/2016 2.1 Revisión anual de documentación y ajustes en el documento conforme a las normas PCI DSS 3.2 y PA DSS 3.2 04/08/2017 2.2 Agregado de campo Promocional en Opciones de Pago 29/11/2017 2.3 Agregado de apartado Validaciones Crédito Débito 01/02/2018 2.4 Agregado de detalle en el apartado Visualización del tráfico por canal 30/08/2018 2.5 Agregado de configuración, reportes, planificación de proceso y propiedades de configuración relacionados a la funcionalidad PEI 10/01/2019 2.6 Agregado de apartado Búsqueda de cupones por consola 11/02/2019 2.7 Agregado de configuración, reportes, planificación de proceso y propiedades de configuración relacionados a la funcionalidad Billeteras Electrónicas (Mercado Pago y Todo Pago) 22/02/2019 2.8 Agregado de configuración y propiedades de configuración relacionados a la funcionalidad Tokenización

...

Painel
borderColor #E4E3E3 titleColor #ffffff borderWidth 1 titleBGColor #704581 title CONTENIDO
Expandir title Expandir contenido Índice

Âncora
_Toc247539914 _Toc247539914

...

Descripción de la página:
A través de esta página puede llevarse a cabo la administración de las tarjetas por compañías que se utilizarán en el sistema.

10.4.

...

1 Búsqueda de tarjetas por compañías

El sistema brinda la opción de buscar las tarjetas por compañías que se encuentran cargadas, por medio de los campos "Compañía" y "Tarjeta". Una vez completado estos filtros se debe presionar "Buscar" para que la búsqueda se lleve adelante. Como resultado se mostrará la configuración que posee cada tarjeta asociada a una Compañía.

10.4.

...

3 Modificación de tarjetas por compañías

Al oprimir la acción "Modificar" correspondiente a un registro de Compañía Tarjeta, se mostrará la pantalla "Modificar tarjeta por compañía" donde se mostrarán los siguientes datos:

• Compañía: campo con el nombre de la compañía
• Tarjeta: campo con el nombre de la tarjeta

y los siguientes campos con su correspondiente información:

El botón de acción "Aceptar" persistirá los cambios mientras que el de "Cancelar" volverá a la pantalla de "Tarjetas por Compañía".

...

Acceso:
Para acceder a la configuración de las monedas manejadas por el sistema, seleccionar la opción "Monedas" dentro del menú de Configuración (Módulo CR / DB > Configuración > Monedas)

Descripción de la página:
A través de esta página puede llevarse adelante la administración de las monedas que manejará el sistema.

...

• Tarjeta a la que corresponde.
• Rango del prefijo (desde – hasta)
• Largo correspondiente al número de tarjeta.
• Condición de identificación: es una identificación adicional para aquellas tarjetas que no se pueden distinguir únicamente mediante sus prefijos.
• Permitir operar off-line: indica si la validación off-line se encuentra habilitada para el rango de prefijos.
• Monto límite para transacciones efectuadas en modo off-line.
• Si el prefijo requiere validación de: largo del CVC, dígito verificador y / o fecha de vencimiento.
• Largo del CVC: debe ser indicado sólo en el caso que el prefijo requiera de validación de CVC.
• Si el prefijo estará habilitado / deshabilitado
• Si se requiere el envío del track 1.
• Si el prefijo requiere el ingreso del PinPIN.Se debe
  • Si el prefijo debe validar los N últimos números.
  • Cantidad de N últimos números a validar en caso de estar activada esta validación.
  • Si el prefijo requiere el tipo de cuenta.
  • Si el prefijo solicita el número de cuenta.
  • • Solicitar ingreso de PIN. Opciones: No, Si, Opcional.
      • No: el pinpad nunca solicitará ingreso de PIN.
      • Si: el pinpad siempre solicitará ingreso de PIN. De todas maneras dependerá si la tarjeta posee o no PIN.
      • Opcional: esta opción Chequea si debe solicitar PIN de acuerdo al Service Code de la tarjeta. Si el tercer dígito del Service Code devuelto por la tarjeta tiene los siguientes valores, entoces se solicitará ingreso de PIN: 0, 5, 6, 7.
  • Si el prefijo debe validar los N últimos números.
  • Cantidad de N últimos números a validar en caso de estar activada esta validación.
  • Si el prefijo requiere el tipo de cuenta.
  • Si el prefijo solicita el número de cuenta.
  • Se debe seleccionar el tipo de tarjeta

  ...

  A continuación, se explicarán las propiedades relacionadas a PEI.

  
  

  Propiedad	Tipo	Descripción	Requiere reiniciar?
  URL de conexión con CA Link #0 Nodo 01 (al Nodo 10)	Alfanumérico	URL del centro autorizador Link #0 por el cual se establecerá la comunicación del Nodo	No
  URL de conexión con CA Link #1 Nodo 01 (al Nodo 10)	Alfanumérico	URL del centro autorizador Link #1 por el cual se establecerá la comunicación del Nodo	No
  Usuario PEI canal Link	Alfanumérico	Usuario PEI utilizado para conectarse con el canal Link	No
  Clave PEI canal Link	Alfanumérico	Clave PEI utilizada para conectarse con el canal Link	No
  ClientId PEI canal Link	Alfanumérico	ClientId PEI utilizado para conectarse con el canal Link	No
  ClientSecret PEI canal Link	Alfanumérico	ClientSecret PEI utilizado para conectarse con el canal Link	No
  IP SV PEI canal Link	Alfanumérico	Dirección IP Server PEI utilizado para conectarse con el canal Link	No
  Expiracion en segundos token PEI canal Link	Entero	Expiracion en segundos del token PEI utilizado para conectarse con el canal Link	No
  Timeout para autorización Pei	Entero	Tiempo de espera máximo en milisegundos para la recepción de la respuesta de una transacción de autorización PEI	No
  Habilita al proceso de cierre de transacciones PEI	true / false	Habilita el proceso de cierre de transacciones PEI	No
  Timeout de escritura para autorización Pei	Entero	Tiempo maximo en milisegundos de escritura de un requerimiento una transacción de autorización para PEI	No
  Timeout de conexión para autorización Pei	Entero	Tiempo maximo en milisegundos que se esperara para conectarse una transacción de autorización para PEI	No
  Timeout en segundos de solicitud token PEI al autorizador	Entero	Timeout en segundos que se espera la respuesta de una solicitud de Token PEI al autorizador	No

  
  

  13. Búsqueda de cupones

  Acceso:
  Para acceder a la búsqueda de cupones digitales que se encuentran cargados en el sistema, seleccionar la opción "Búsqueda de vouchers" dentro del menú: VTOL > Módulo Crédito-Débito.

  
  

  13.1 Funcionalidad

  Esta página permite efectuar la búsqueda y descarga de cupones digitalizados.

  Informações
  Las transacciones NO Aprobadas, no generan registros de voucher digitales en el sistema. Por lo tanto no se podrán consultar en esta búsqueda.

  
  

  13.1.1 Búsqueda de Cupones

  ...

  • Compañía
  • Fecha desde y hasta del cupón
  • Tarjeta
  • Últimos 4 dígitos de la tarjeta
  • Importe total de la transacción

  Además como filtros adicionales, para que un retailer localice un comprobante en caso de que aparezcan varios con una fecha, tarjeta e importe, se muestran los filtros:

  ...

  Una vez completados estos campos se debe presionar el botón "Buscar" para que la búsqueda sea efectuada.

  Image RemovedImage Added
  

  Tener en cuenta que se buscarán los comprobantes que contengan los valores de los filtros ingresados. En caso de que no existan resultados para la búsqueda, se mostrará la leyenda "No existen cupones con los criterios seleccionados".

  ...

  • Compañía
  • Local
  • Operación
  • Fecha del comprobante
  • Tarjeta
  • Últimos 4 dígitos
  • Importe Total
  • Retiro de efectivo
  • Número de comercio
  • Número de lote
  • Cupón
  • Transacción
  • Componente checkbox

  ...

  La columna "Transacción" mostrará por cada registro un hipervínculo que desplegará un pop-up (ventana emergente) con el detalle del cupón seleccionado.

  Image RemovedImage Added
  

  13.1.2 Descarga de cupones

  Al seleccionar uno o más registros mediante el componente checkbox de la grilla de resultados y oprimiendo el botón "Descargar", se descargarán el o los comprobantes seleccionados. Los archivos que se descargan tendrán formato .POS.

  
  

  13.2 Configuración de acceso

  ...

  El Identificador de la cuenta del vendedor es es collector_id asignado por Mercado Pago a nivel compañía/empresa.

  ...

  Para realizar una carga automática de datos de punto de venta MP, se debe seleccionar una Compañía del combo Compañía, y luego presionar el botón "Carga automática". No hace falta realizar una búsqueda previa. La Compañía es el único campo obligatorio que se debe completar. 

  ...

  Opciones de configuración de Mercado Pago:

  Propiedad	Tipo	Descripción	Requiere reiniciar?
  Timeout para autorización Mercado Pago	Entero	Tiempo de espera máximo en milisegundos para la recepción de la respuesta de una transacción de autorización para Mercado Pago	Si
  Timeout de escritura para autorización Mercado Pago	Entero	Tiempo maximo en milisegundos de escritura de un requerimiento una transacción de autorización para Mercado Pago	Si
  Timeout de conexión para autorización Mercado Pago	Entero	Tiempo maximo en milisegundos que esperara para conectarse una transacción de autorización para Mercado Pago	Si
  Url de conexión con CA Mercado Pago para la venta	Alfanumérico	URL del centro autorizador Mercado Pago por el cual se establecerá la comunicación de la venta. Configurar con el valor: https://api.mercadolibre.com	Si
  Url de conexión con CA Mercado Pago para la consulta de venta	Alfanumérico	URL del centro autorizador Mercado Pago por el cual se establecerá la comunicación de la consulta de la venta. Configurar con el valor: https://api.

  mercadolibre

  mercadopago.com	Si
  Url de conexión con CA Mercado Pago para la devolución de la venta	Alfanumérico	URL del centro autorizador Mercado Pago por el cual se establecerá la comunicación de la devolución de la venta. Configurar con el valor: https://api.

  mercadolibre

  mercadopago.com	Si
  Maxima cantidad de dias para realizar devolución en Mercado Pago	Entero	Maximo cantidad de dias para hacer devolucion en Mercado Pago 90 días desde su acreditacion	Si
  Maximo número de devoluciones parciales en Mercado Pago	Entero	Maximo número de devoluciones parciales en Mercado Pago para un mismo pago	Si
  Tiempo maximo de espera para notificación de venta en Mercado Pago	Entero	Tiempo maximo de espera para notificacion de venta en la billetera de Mercado Pago	Si
  Habilita al proceso de pasaje a historico de transacciones de billetera	True/False	Habilita al proceso de pasaje a historico de transacciones de billetera	Si
  Habilita el servicio de notificaciones SSL con Mercado Pago	True/False	Indica si se encuentra habilitada la comunicación SSL/TLS entre Mercado Pago y VTOL. Configurar con el valor: True.	Si
  SSL: Almacen de certificados del servidor en Mercado Pago	Alfanumérico	Ruta donde está el keystore que contiene los certificados del servidor para la comunicación segura SSL/TLS entre Mercado Pago y VTOL. Ejemplo: D:\tools\wildfly-10.1.0.Final\CD3803\configuration\synthesis.keystore	Si
  SSL: Contraseña del almacen de certificados del servidor con Mercado Pago	Alfanumérico	Contraseña de acceso al keystore que contiene los certificados del servidor para la comunicacion entre Mercado Pago y VTOL	Si
  URL Base de notificacion que usará mercado pago	Alfanumérico	URL donde VTOL recibira las notificaciones de Mercado Pago. A la misma se le adiciona la compania al final de la URL. Ejemplo: locahost:8585/vtol/mpNotification/	Si

  
  

  Informações
  title Info
  Para el caso de Mercado Pago, es requerido abrir un puerto para que la plataforma de Mercado Pago llegue al servicio REST publicado por VTOL donde recibirá notificaciones de pago, bajo el protocolo seguro HTTPS (el puerto por defecto que VTOL abre es el 8585).

  ...

  Opciones de configuración Todo Pago

  Propiedad	Tipo	Descripción	Requiere reiniciar?
  Timeout para autorización Todo Pago	Entero	Tiempo de espera máximo en milisegundos para la recepción de la respuesta de una transacción de autorización desde Todo Pago	Si
  Habilita el servicio de notificaciones SSL con Todo Pago	True/False	Indica si se encuentra habilitada la comunicación SSL/TLS entre Todo Pago y VTOL. Configurar con el valor: True	Si
  SSL: Almacen de certificados del servidor con Todo Pago	Alfanumérico	Ruta donde está el keystore que contiene los certificados del servidor para la comunicacion segura SSL/TLS entre Todo Pago y VTOL	Si
  SSL: Contraseña del almacen de certificados del servidor con Todo Pago	Alfanumérico	Contraseña de acceso al keystore que contiene los certificados del servidor para la comunicación entre Todo Pago y VTOL	Si
  Timeout de la notificación Todo Pago	Entero	Timeout de la notificación de solicitud de compra enviada desde TodoPago	Si
  Timeout para la Devolucion Todo Pago	Entero	Tiempo de espera máximo en milisegundos para la recepción de la respuesta de una Devolución desde Todo Pago	Si
  URL de conexión con CA TodoPago #0 (Nodo 01 al Nodo 10)	Alfanumérico	URL del centro autorizador TodoPago #0 por el cual se establecerá la comunicación del Nodo 01 al Nodo 10	Si
  Timeout maximo de venta Todo Pago	Entero	Tiempo de espera máximo en milisegundos para completar la autorización de venta en Todo Pago, por defecto 5 minutos	Si

  
  

  14.5 Flujo de Mensajería

  14.5.1 Mercado Pago

  A- SaleWallet - Orden de Venta

  La venta de billetera maneja tercer mensaje. La operación queda en estado pendiente cuando la venta es aprobada o cuando la misma corresponde a un error por Timeout de la notificación.

  La orden de venta se genera en base a la necesidad de abonar un pago. El POS es el originador de la transacción de venta.

  Flujo:

  Image Added
  

  Requerimiento POS - VTOL

  El POS le entregará a VTOL una transacción SaleWallet, especificada en la mensajería VTOL EMVKIT AR 1.4.X#I.ProcesarMensajesBilleterasElectr%C3%B3nicas.

  
  

  Requerimiento VTOL - Mercado Pago

  Una vez que el POS haya enviado la transacción de tipo SaleWallet, VTOL deberá enviarle al servidor de Mercado Pago la Orden de Venta.

  Los campos importantes que VTOL deberá enviar de forma obligatoria son:

  • items: los ítems de la compra (categoría, precio unitario, moneda, etc)
  • total_amount: costo total de la venta
  • notification_url: URL en la que se recibiría la notificación del estado del pago
  • external_reference: referencia informada por el POS para sincronizar con el sistema de pagos y obtener una correlación única

  
  

  Informações
  Documentación Mercado Pago:  https://www.mercadopago.com.ar/developers/es/reference/merchant_orders/resource/ Se informan los atributos que se deben enviar en el requerimiento de la orden de venta.

  
  

  Respuesta Mercado Pago - VTOL

  VTOL recibirá un HTTP 200 de recibido por parte de Mercado Pago cuando reciba la orden de venta o un HTTP 400 cuando haya algún error.

  
  

  Notificación

  Posterior pago de la orden de venta por parte del comprador en su app, Mercado Pago le realizará una notificación a VTOL del tipo IPN (Instant Payment Notification) para informarle el evento ocurrido.

  
  

  Respuesta Mercado Pago - VTOL

  Luego de la confirmación del pago por parte del comprador en su aplicativo de Mercado Pago, Mercado Pago entregará una notificación IPN a VTOL. Aquí VTOL deberá exponer un servicio público para que Mercado Pago pueda enviar la notificación. Para Mercado Pago, el único requisito es contar con un certificado válido, es decir que la URL sea https.

  
  

  Informações
  Documentación Mercado Pago: http://beta.mercadopago.com.ar/developers/es/guides/notifications/ipn/ Se informan las notificaciones que Mercado Pago le realizará a VTOL.

  
  

  VTOL al recibir esta notificación, enviará un mensaje de consulta a Mercado Pago mencionando el ID de pago para obtener información del pago y entregárselo al POS. Cuando se reciba la información, VTOL persistirá los datos de la transacción en la base de datos y generará el mensaje de respuesta VTOL - POS.

  
  

  Respuesta VTOL - POS

  VTOL le entregará al POS la respuesta de la transacción SaleWallet.

  
  

  Resumen:

  1. El POS envía un mensaje SaleWallet a VTOL.
  2. VTOL entrega a MP una orden de venta.
  3. MP responde un HTTP 200 a VTOL para indicar que recibió la orden de venta.
  4. El cliente confirma el pago en su aplicativo mobile de MP.
  5. MP envía una notificación IPN a VTOL de la confirmación del pago.
  6. VTOL envía un HTTP 200 a MP (respuesta del paso 5)
  7. VTOL recibe la notificación y envía un mensaje de consulta con el ID de pago a MP para obtener los datos del pago.
  8. MP informa los datos del pago a VTOL.

  9. VTOL actualiza la WalletFinancialTransaction con el estado del pago.

  10. VTOL contesta al POS la respuesta de SaleWallet APROBADA.

  11. VTOL deja la tabla Operation con estado Pending (Tercer Mensaje).

  12. El POS cierra OK la operación. 

  13. VTOL realiza commit de la operación en la base de datos.

  
  

  15. Configuración Tokenización

  ...

  A continuación, se explicarán las propiedades relacionadas a Tokenización.

  
  

  Propiedad	Tipo	Descripción	Requiere reiniciar?
  Timeout de escritura para envios de Token VISA	Entero	Tiempo máximo en milisegundos de escritura de un requerimiento de Token VISA	No
  Timeout de conexión para conexiones con el Token VISA	Entero	Tiempo máximo en milisegundos de conexión de un requerimiento de Token VISA	No
  Timeout de lectura para envios de Token VISA	Entero	Tiempo máximo en milisegundos de lectura de un requerimiento de Token VISA	No
  URL Token Publico VISA	Alfanumérico	URL Token Publico VISA por el cual se establecerá la comunicación	No
  URL Token Privado VISA	Alfanumérico	URL Token Privado VISA por el cual se establecerá la comunicación	No
  Tiempo maximo de espera para tokenizar	Entero	Tiempo máximo de espera para la tokenización de una tarjeta	No
  Intervalo de tiempo para el envio de alertas por error de tokenizacion	Entero	Intervalo de tiempo para el envío de alertas por si se producen errores	No
  Cantidad de errores para envio de alerta en tokenizacion	Entero	Cantidad de errores máximo para envió de alerta por error de tokenización	No
  Días conservación de token generados automaticamente	Entero	Cantidad de días que se desea mantener la información de token (públicos y privados) generados automáticamente antes de ser depurados	No
  Proceso de depuracion token habilitado	True/False	Habilita la depuración de token que se generaron automáticamente luego de un tiempo configurado	No
  IP utilizada para enviar en mensajes iso	Alfanumérico	IP utilizada para enviar en mensajes ISO tokenizados	No