VTOL CD AR - Manual de usuario 3.8.0.12
VTOL CRÉDITO / DÉBITO Manual de Usuario
...
Painel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
|
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Âncora _Toc247539914 _Toc247539914
...
El resultado mostrará los siguientes campos:
Campo | Definición |
---|---|
Fecha inicio cierre | Fecha y hora en la cual se inició el proceso de cierre |
Fecha fin cierre | Fecha y hora en la cual finalizó el proceso de cierre |
Compañía | Nombre de la compañía donde se ejecutó el cierre |
Canal | Canal donde se ejecutó el cierre |
Definición de lote | Definición de lote donde se ejecutó el cierre |
Estado cierre | Descripción del estado. Si finalizó con error, si finalizó sin errores. o si aún está en proceso de cierre |
Total | Se muestra la cantidad total de terminales a cerrar para la compañía y canal |
Progreso | Porcentaje de avance de las terminales cerradas. Se calcula teniendo en cuenta la cantidad total de terminales a cerrar, sobre la cantidad de terminales cerradas. |
Con error | Se muestra la cantidad de terminales con error en el cierre |
Acción | Acción para acceder al detalle del cierre |
8.4.2 Detalle monitoreo de cierres
...
Configuración de propiedades
Propiedad | Tipo | Descripción | Requiere reiniciar? |
---|---|---|---|
Canal de origen a mostrar en Nro de comercio y Def. de lote, para locales físicos | Entero | Canales de origen que se vincularán con opciones de pago en la pantalla Nro. de comercio y Def. de lote, para locales físicos. Valores separados por coma. Opciones: 0:Presencial, 3:IVR | No |
Aviso |
---|
Si se modifica la "Definición de Lote" de un Local, mientras VTOL está operando y el POS ya tiene una sesión iniciada en la librería EMVKit, si se intenta transaccionar sin antes ejecutar una "Interface POS", VTOL devolverá un error indicando que el Hostname es inválido, ya que la librería tiene configurado un canal hacia donde rutear, pero en el Server se modificó dicho canal, por lo tanto se deberá volver a ejecutar una Interface POS para que la librería tome dicho cambio. |
...
- 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.
- 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.Si utiliza mensaje encriptado
- 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.
- 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
- Solicitar ingreso de PIN. Opciones: No, Si, Opcional.
- 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.
- Si utiliza mensaje encriptado.
Presionar "Aceptar" para que el alta tenga lugar, caso contrario presionar "Cancelar". Al presionar "Aceptar" se solicitará la confirmación de la creación del prefijo, mediante el despliegue de una ventana.
...
Para eliminar, se deberá seleccionar el registro en la pantalla de búsqueda haciendo clic sobre el checkbox del registro a borrar y luego presionar el botón "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana.
14.3.1.4
...
En caso de que la comunicación entre VTOL y Mercado Pago tenga salida a través de un Proxy, VTOL permite configurar las propiedades de conexión a dicho Proxy, por donde encaminar las solicitudes a los servicios REST de Mercado Pago.
Las propiedades se configuran a través de consola Web de VTOL (VTOL Admin), como puede verse en la siguiente imagen:
Los cambios se toman sin requerir el reinicio de la aplicación.
A continuación se explican las propiedades para configurar un Proxy:
...
Configuración de propiedades
Se deberán configurar parámetros para poseer una comunicación óptima con los canales Mercado Pago y Adquiriente Prisma.
Para acceder a la configuración de propiedades, presionar la opción denominada "Configuración" dentro del menú "Herramientas administrativas" (Herramientas administrativas > Configuración).
Esta página permite configurar las distintas propiedades disponibles para las billeteras electrónicas en la aplicación, ingresando el valor correspondiente para cada una de ellas. Está orientada a un usuario que tenga un perfil de administrador puesto que brinda opciones de configuración avanzada del sistema. Para operar adecuadamente la página, dirigirse al manual "VTOL CORE - Manual de usuario 3.8".
A continuación, se explicarán las propiedades relacionadas a Billeteras Electrónicas Mercado Pago:
Propiedad | Tipo | Descripción | Requiere reiniciar? |
---|
14.3.2 QR Adquiriente Prisma
Acceso:
Para acceder a la configuración de QR Adquiriente Prisma que se manejará en el sistema, seleccionar la opción "Adquiriente Prisma" dentro del menú de Billeteras electrónicas (VTOL > Módulo CR / DB > Billeteras electrónicas > Adquiriente Prisma).
14.3.2.1 Tarjetas Billetera Prisma
Descripción de la página:
Esta página permite configurar y vincular las tarjetas cargadas en VTOL CR-DB contra las tarjetas del autorizador Prisma. Para poder utilizar las tarjetas cargadas en VTOL, las mismas deben ser asociadas con las tarjetas de Prisma. Se deben asociar las tarjetas de crédito-débito, como también las tarjetas de beneficio.
14.3.2.1.1 Búsqueda de Tarjetas
Se cuenta con la opción de buscar las Tarjetas de VTOL CR-DB que están vinculadas con las tarjetas de Prisma. Una vez completados los filtros de búsqueda, se debe presionar "Buscar" para que la búsqueda sea efectuada.
14.3.2.1.2 Agregar una tarjeta
Para configurar una nueva tarjeta, realizando la vinculación entre VTOL y Prisma, se debe seleccionar del combo "Tarjeta" una tarjeta de VTOL CR-DB, y luego del combo "Tarjeta Prisma" una tarjeta del autorizador Prisma.
Por ejemplo, si en VTOL se crea una nueva tarjeta llamada "Visa Galicia", para que dicha tarjeta pueda ser utilizada en la funcionalidad de "QR Adquiriente Prisma", la misma debe ser vinculada con la "Tarjeta Prisma" denominada "Prisma", como se observa en el siguiente ejemplo:
Al presionar el botón "Guardar", la tarjeta quedará vinculada. De esta manera la caja podrá enviar una opción de pago con la tarjeta "Visa Galicia".
Informações | ||
---|---|---|
| ||
Para que la caja pueda utilizar una tarjeta como medio de pago para QR Adquiriente Prisma, esa tarjeta debe tener configurada sus Opciones de Pago correspondientes. Deben estar asociadas al Tipo de Operación "Wallet" y al Canal de Origen "Presencial". Tanto las tarjetas de crédito-débito como las tarjetas de beneficio, deben tener configurada las opciones de pago. Además, dichas opciones de pago, deben tener la configuración de Número de Comercio y Definición de lote asociada al Tipo de Operación "Wallet". También se validará que la caja a operar tenga configurada su Número de Terminal. |
14.3.2.1.4 Eliminación de una tarjeta
Para eliminar la relación entre Tarjeta VTOL y Tarjeta Prisma, se deberá realizar una búsqueda de la tarjeta a eliminar, luego seleccionar la misma haciendo clic sobre el checkbox correspondiente y presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana.
Informações | ||
---|---|---|
| ||
Para utilizar QR Adquiriente, se deben configurar los "Datos Tributarios" de la Compañía, con los datos propios de la Compañía. Ver en el apartado 20.1 Datos tributarios |
14.4 Configuración de propiedades
Se deberán configurar parámetros para poseer una comunicación óptima con los canales Mercado Pago y Adquiriente Prisma.
Para acceder a la configuración de propiedades, presionar la opción denominada "Configuración" dentro del menú "Herramientas administrativas" (Herramientas administrativas > Configuración).
Esta página permite configurar las distintas propiedades disponibles para las billeteras electrónicas en la aplicación, ingresando el valor correspondiente para cada una de ellas. Está orientada a un usuario que tenga un perfil de administrador puesto que brinda opciones de configuración avanzada del sistema. Para operar adecuadamente la página, dirigirse al manual "VTOL CORE - Manual de usuario 3.8".
A continuación, se explicarán las propiedades relacionadas a Billeteras Electrónicas.
14.4.1 Opciones de configuración de Mercado Pago
...
URL del centro autorizador Mercado Pago por el cual se establecerá la comunicación de la venta.
Configurar con el valor: https://api.mercadopago.com
...
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.mercadopago.com
...
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.mercadopago.com
...
Indica si se encuentra habilitada la comunicación SSL/TLS entre Mercado Pago y VTOL.
Configurar con el valor: True.
...
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-18.0.1.Final\CD3803\configuration\synthesis.keystore
...
Informações |
---|
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). |
14.4.2 Opciones de configuración de QR Adquiriente Prisma
...
14.5 Flujo de Mensajería
14.5.1 Mercado Pago
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.
El POS es el originador de la transacción de venta. La orden de venta se genera en base a la necesidad de abonar un pago.
Flujo:
Requerimiento POS - VTOL
El POS le entregará a VTOL una transacción SaleWallet, especificada en la mensajería VTOL EMVKIT AR Procesar Mensajes Billeteras Electronicas.
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
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.
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:
...
VTOL actualiza la WalletFinancialTransaction con el estado del pago.
...
VTOL contesta al POS la respuesta de SaleWallet APROBADA.
...
VTOL deja la tabla Operation con estado Pending (Tercer Mensaje).
...
El POS cierra OK la operación.
...
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 | No |
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 | No |
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 | No |
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.mercadopago.com | No |
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.mercadopago.com | No |
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.mercadopago.com | No |
Maximo cantidad de dias para realizar devolución en Mercado Pago | Entero | Máximo cantidad de días para hacer devolución en Mercado Pago 90 días desde su acreditación | No |
Maximo número de devoluciones parciales en Mercado Pago | Entero | Maximo número de devoluciones parciales en Mercado Pago para un mismo pago | No |
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 | No |
Habilita al proceso de pasaje a historico de transacciones de billetera | True/False | Habilita al proceso de pasaje a histórico de transacciones de billetera | Si |
Habilita el servicio de notificaciones SSL con las billeteras | True/False | Indica si se encuentra habilitada la comunicación SSL/TLS entre Mercado Pago y VTOL. Configurar con el valor: True. | Si |
SSL Billeteras: Almacen de certificados del servidor para las notificaciones | 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-18.0.1.Final\CD3803\configuration\synthesis.keystore | No |
SSL Billeteras: Contraseña del almacen de certificados del servidor para las notificaciones | Alfanumérico | Contraseña de acceso al keystore que contiene los certificados del servidor para la comunicacion entre Mercado Pago y VTOL | No |
URL Base de notificacion que usará Mercado Pago | Alfanumérico | URL donde VTOL recibirá las notificaciones de Mercado Pago. A la misma se le adiciona la compañía | No |
URL Base de API Location Mercado PagoN | Alfanumérico | URL donde VTOL consultará por el catálogo de locations de Mercado Pago | No |
URL Base de catálogo de tiendas y cajas de Mercado Pago | Alfanumérico | URL donde VTOL registrará y consultará las cajas y tiendas en Mercado Pago | No |
Identificador del sponsor en Mercado Pago | Alfanumérico | Código único que Identifica la cuenta de Napse creada en Mercado Libre. En cada creación de orden de pago, VTOL informará este dato a MP. | No |
Mercado Pago Proxy: Conexión a través de Proxy | Alfanumérico | Habilita encaminar las solicitudes a los servicios REST de Mercado Pago a través de un Proxy. | No |
Mercado Pago Proxy: IP o nombre de host | Alfanumérico | La IP o nombre de host del proxy. | No |
Mercado Pago Proxy: Puerto | Numérico | Puerto donde escucha el proxy. | No |
Mercado Pago Proxy: Usuario | Alfanumérico | Nombre de usuario en caso de que la conexión con el proxy requiera autenticación. | No |
Mercado Pago Proxy: Contraseña | Alfanumérico | Contraseña del usuario en caso de que la conexión con el proxy requiera autenticación | No |
Informações |
---|
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). |
14.3.1.5 Configurar propiedades de conexión a un Proxy
En caso de que la comunicación entre VTOL y Mercado Pago tenga salida a través de un Proxy, VTOL permite configurar las propiedades de conexión a dicho Proxy, por donde encaminar las solicitudes a los servicios REST de Mercado Pago.
Las propiedades se configuran a través de consola Web de VTOL (VTOL Admin), como puede verse en la siguiente imagen:
Los cambios se toman sin requerir el reinicio de la aplicación.
A continuación se explican las propiedades para configurar un Proxy:
Propiedad | Descripción | Requiere reiniciar? |
---|---|---|
Mercado Pago Proxy: Conexión a través de Proxy | Habilita encaminar las solicitudes a los servicios REST de Mercado Pago a través de un Proxy. | No |
Mercado Pago Proxy: IP o nombre de host | La IP o nombre de host del proxy. | No |
Mercado Pago Proxy: Puerto | Puerto donde escucha el proxy. | No |
Mercado Pago Proxy: Usuario | Nombre de usuario en caso de que la conexión con el proxy requiera autenticación. | No |
Mercado Pago Proxy: Contraseña | Contraseña del usuario en caso de que la conexión con el proxy requiera autenticación | No |
14.3.2 QR Adquiriente Prisma
14.3.2.1 Configuración inicial
Para operar con QR Prisma, lo primero que se debe configurar son los medios de pago que utilizará el comercio, y también se deben configurar los datos tributarios de la compañía. Como se indica a continuación:
Dica | ||
---|---|---|
| ||
Para que la caja pueda utilizar una tarjeta como medio de pago para QR Adquiriente Prisma, esa tarjeta debe tener configurada sus Opciones de Pago correspondientes. Deben estar asociadas al Tipo de Operación "Wallet" y al Canal de Origen "Presencial". Tanto las tarjetas de crédito-débito como las tarjetas de beneficio, deben tener configurada las opciones de pago. Para las tarjetas de beneficio, se debe configurar una opción de pago en una sola cuota. Todas las opciones de pago deben rutear hacia el Canal Visa. Además, dichas opciones de pago, deben tener la configuración de Número de Comercio y Definición de lote asociada al Tipo de Operación "Wallet". También se validará que la caja a operar tenga configurada su Número de Terminal. |
Dica | ||
---|---|---|
| ||
Para utilizar QR Adquiriente, se deben configurar los "Datos Tributarios" de la Compañía, con los datos propios del Comercio. Ver en el apartado 20.1 Datos tributarios |
14.3.2.2 Tarjetas Billetera Prisma
Acceso:
Para acceder a la configuración de QR Adquiriente Prisma que se manejará en el sistema, seleccionar la opción "Adquiriente Prisma" dentro del menú de Billeteras electrónicas (VTOL > Módulo CR / DB > Billeteras electrónicas > Adquiriente Prisma).
Descripción de la página:
Esta página permite configurar y vincular las tarjetas cargadas en VTOL CR-DB contra las tarjetas del autorizador Prisma. Para poder utilizar las tarjetas cargadas en VTOL, las mismas deben ser asociadas con las tarjetas de Prisma. Se deben asociar las tarjetas de crédito-débito, como también las tarjetas de beneficio.
14.3.2.2.1 Búsqueda de Tarjetas
Se cuenta con la opción de buscar las Tarjetas de VTOL CR-DB que están vinculadas con las tarjetas de Prisma. Una vez completados los filtros de búsqueda, se debe presionar "Buscar" para que la búsqueda sea efectuada.
14.3.2.2.2 Agregar una tarjeta
Para configurar una nueva tarjeta, realizando la vinculación entre VTOL y Prisma, se debe seleccionar del combo "Tarjeta" una tarjeta de VTOL CR-DB, y luego del combo "Tarjeta Prisma" una tarjeta del autorizador Prisma.
Por ejemplo, si en VTOL se crea una nueva tarjeta llamada "Visa Galicia", para que dicha tarjeta pueda ser utilizada en la funcionalidad de "QR Adquiriente Prisma", la misma debe ser vinculada con la "Tarjeta Prisma" denominada "Prisma", como se observa en el siguiente ejemplo:
Al presionar el botón "Guardar", la tarjeta quedará vinculada. De esta manera la caja podrá enviar una opción de pago con la tarjeta "Visa Galicia".
14.3.2.2.3 Eliminación de una tarjeta
Para eliminar la relación entre Tarjeta VTOL y Tarjeta Prisma, se deberá realizar una búsqueda de la tarjeta a eliminar, luego seleccionar la misma haciendo clic sobre el checkbox correspondiente y presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana.
Informações | ||
---|---|---|
| ||
Para que la caja pueda utilizar una tarjeta como medio de pago para QR Adquiriente Prisma, esa tarjeta debe tener configurada sus Opciones de Pago correspondientes. Deben estar asociadas al Tipo de Operación "Wallet" y al Canal de Origen "Presencial". Tanto las tarjetas de crédito-débito como las tarjetas de beneficio, deben tener configurada las opciones de pago. Además, dichas opciones de pago, deben tener la configuración de Número de Comercio y Definición de lote asociada al Tipo de Operación "Wallet". También se validará que la caja a operar tenga configurada su Número de Terminal. |
Informações | ||
---|---|---|
| ||
Para utilizar QR Adquiriente, se deben configurar los "Datos Tributarios" de la Compañía, con los datos propios del Comercio. Ver en el apartado 20.1 Datos tributarios |
14.3.2.3 Configuración de propiedades
Se deberán configurar parámetros para poseer una comunicación óptima con QR Prisma Adquiriente.
Para acceder a la configuración de propiedades, presionar la opción denominada "Configuración" dentro del menú "Herramientas administrativas" (Herramientas administrativas > Configuración).
Esta página permite configurar las distintas propiedades disponibles para las billeteras electrónicas en la aplicación, ingresando el valor correspondiente para cada una de ellas. Está orientada a un usuario que tenga un perfil de administrador puesto que brinda opciones de configuración avanzada del sistema. Para operar adecuadamente la página, dirigirse al manual "VTOL CORE - Manual de usuario 3.8".
Propiedad | Tipo | Descripción | Requiere reiniciar? |
---|---|---|---|
Url de conexión con CA Prisma QR | Alfanumérico | URL del centro autorizador Prisma QR por el cual se establecerá la comunicación para operaciones QR | No |
Credencial apiKey para Prisma QR | Alfanumérico | Apikey del Sistema Propio (integrador) provista por Prisma. Es una única apiKey para Napse. | No |
Tiempo maximo de espera para notificacion de venta en Prisma QR | Alfanumérico | Tiempo maximo de espera en milisegundos para notificacion de venta en la billetera de QR | No |
Habilita el servicio de notificaciones SSL con las billeteras | True/False | Propiedad que indica si se encuentra habilitado el cifrado de información, mediante certificado SSL/TLS, para establecer un protocolo de comunicación segura para las notificacines que envian las billeteras a VTOL. (Requiere reiniciar VTOL) Configurar con el valor: True. | Si |
SSL Billeteras: Almacen de certificados del servidor para las notificaciones | Alfanumérico | Archivo que contiene los certificados del servidor para la comunicacion segura SSL/TLS para las notificacines que envian las billeteras a VTOL. Ruta donde está el keystore que contiene los certificados del servidor para la comunicación segura SSL/TLS entre las billeteras y VTOL. Ejemplo: D:\tools\wildfly-18.0.1.Final\CD3803\configuration\synthesis.keystore | No |
SSL Billeteras: Contraseña del almacen de certificados del servidor para las notificaciones | Alfanumérico | Contraseña de acceso al archivo que contiene los certificados del servidor para la comunicacion segura SSL/TLS para las notificacines que envian las billeteras a VTOL. | No |
14.3.2.4 Configurar propiedades de conexión a un Proxy
En caso de que la comunicación entre VTOL y Adquiriente Prisma tenga salida a través de un Proxy, VTOL permite configurar las propiedades de conexión a dicho Proxy, por donde encaminar las solicitudes a los servicios REST de Prisma.
Las propiedades se configuran a través de consola Web de VTOL (VTOL Admin), como puede verse en la siguiente imagen:
Los cambios se toman sin requerir el reinicio de la aplicación.
A continuación se explican las propiedades para configurar un Proxy:
Propiedad | Descripción | Requiere reiniciar? |
---|---|---|
Prisma QR Proxy: Conexión a través de Proxy | Habilita encaminar las solicitudes a los servicios REST de Prisma QR a través de un Proxy. | No |
Prisma QR Proxy: IP o nombre de host | La IP o nombre de host del proxy. | No |
Prisma QR Proxy: Puerto | Puerto donde escucha el proxy. | No |
Prisma QR Proxy: Usuario | Nombre de usuario en caso de que la conexión con el proxy requiera autenticación. | No |
Prisma QR Proxy: Contraseña | Contraseña del usuario en caso de que la conexión con el proxy requiera autenticación | No |
14.4 Flujo de Mensajería
14.4.1 Mercado Pago
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.
El POS es el originador de la transacción de venta. La orden de venta se genera en base a la necesidad de abonar un pago.
Flujo:
Requerimiento POS - VTOL
El POS le entregará a VTOL una transacción SaleWallet, especificada en la mensajería VTOL EMVKIT AR Procesar Mensajes Billeteras Electronicas.
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
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.
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:
- El POS envía un mensaje SaleWallet a VTOL.
- VTOL entrega a MP una orden de venta.
- MP responde un HTTP 200 a VTOL para indicar que recibió la orden de venta.
- El cliente confirma el pago en su aplicativo mobile de MP.
- MP envía una notificación IPN a VTOL de la confirmación del pago.
- VTOL envía un HTTP 200 a MP (respuesta del paso 5)
- 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.
- MP informa los datos del pago a VTOL.
VTOL actualiza la WalletFinancialTransaction con el estado del pago.
VTOL contesta al POS la respuesta de SaleWallet APROBADA.
VTOL deja la tabla Operation con estado Pending (Tercer Mensaje).
El POS cierra OK la operación.
VTOL realiza commit de la operación en la base de datos.
14.5 Transacciones Pendientes de Billeteras
VTOL permite resolver, desde la consola administrativa, las operaciones de Billeteras Electrónicas que quedaron en estado "Pendiente" de confirmación, debido a algún problema de sincronización con la caja.
En los casos donde una operación queda en estado "Pendiente", el Punto de Venta no puede operar contra VTOL hasta no resolver dicha situación.
Para poder "Reversar" o "Confirmar" las operaciones pendientes, se puede acceder a una pantalla de la consola, la cual será explicada a continuación.
14.5.1 Configuración de acceso
Se deberá configurar accesos para que los usuarios tengan habilitada la opción en el menú. Para acceder a la configuración, ingresar la opción "Usuarios" dentro del menú "Seguridad".
Se deberá dar los siguientes accesos al usuario:
- Para visualizar las transacciones pendientes de billetera, asignar los permisos:
- Visualización de Transacciones Pendientes de Billetera
- Para confirmar las transacciones pendientes de billetera, asignar los permisos:
- Confirmación de Transacciones Pendientes de Billetera
14.5.2 Búsqueda de Transacciones Pendientes
Acceso:
Para acceder a la búsqueda de Transacciones Pendientes de Billeteras que se encuentran registradas en el sistema, seleccionar la opción "Transacciones Pendientes" dentro del menú: VTOL > Módulo Crédito-Débito > Billeteras electrónicas
La pantalla de búsqueda cuenta con un conjunto filtros que permiten realizar consultas por diferentes criterios, como se describirá a continuación en mayor detalle.
Filtros de búsqueda
Al ingresar a la pantalla, se mostrarán los siguientes filtros:
- Compañía (obligatorio)
- Nombre del local de VTOL
- Caja de VTOL
- Billetera virtual
- Botón Buscar
14.5.3 Resolver Transacciones Pendientes
Para resolver una operación pendiente, se debe presionar las acciones "Confirmar" o "Reversar", lo cual realizará lo siguiente:
Acción Confirmar:
- Para todas las Billeteras:
- Si se ejecuta la acción Confirmar, VTOL verificará si tiene todos los datos de la transacción enviadas por el Autorizador. Si tiene todos los datos completos, entonces se podrá confirmar, caso contrario, la operación continuará Pendiente.
- En esta implementación no se hará ninguna consulta a los Autorizadores para obtener los datos completos de la transacción.
- Si la operación pudo ser confirmada por VTOL, se mostrará el siguiente mensaje en pantalla: "La transacción se confirmó exitosamente".
- Si la operación no pudo ser confirmanda por VTOL, debido a que no están completos los datos del autorizador, se mostrará el siguiente mensaje en pantalla: "La transacción no se puede confirmar, el sistema no pudo obtener los datos del Autorizador".
- Si se ejecuta la acción Confirmar, VTOL verificará si tiene todos los datos de la transacción enviadas por el Autorizador. Si tiene todos los datos completos, entonces se podrá confirmar, caso contrario, la operación continuará Pendiente.
Acción Reversar:
- Para todas las Billeteras:
- Si se ejecuta la acción Reversar, se incluirá la transacción en el proceso de Reverso de VTOL. De esa manera, se pueden dar los siguientes casos:
- Si la transacción todavía no se pagó, se enviará un DELETE al Autorizador.
- Si la transacción ya se pagó, se enviará una Devolución al Autorizador. En el caso de Adquiriente Prisma, se enviará una Anulación Forzada.
- Si se ejecuta la acción Reversar, se incluirá la transacción en el proceso de Reverso de VTOL. De esa manera, se pueden dar los siguientes casos:
15. Configuración Tokenización
...
Para cargar datos tributarios se debe presionar el botón "Crear", ante lo cual el sistema solicitará el ingreso de los siguientes datos:
- Compañía
- Razón social
- Tipo de identificación tributaria
- Número de identificación tributaria
- Razón social
- Dirección
- Dirección del comercio
- Ciudad del comercio
- Código de categoría del comercio
Presionar "Aceptar" para que el alta tenga lugar, caso contrario presionar "Cancelar". Al presionar "Aceptar" se solicitará la confirmación de la creación de los datos tributarios, mediante el despliegue de un pop-up.
20.1.3 Modificación de datos tributarios
...
Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará confirmar la modificación, mediante el despliegue de un pop-up.
20.1.4 Eliminación de datos tributarios
...
Al acceder al alta de link de pago, se desplegarán los siguientes campos:
Campo | Detalle | Requerido |
---|---|---|
Compañía | Nombre de las compañías cargadas en el Core que el usuario logueado tenga acceso y permiso | SI |
Local | Local de la compañía seleccionada | SI |
Concepto | Concepto del pago a realizarse | SI |
Descripción | Descripción del concepto a pagar | SI |
Importe | Importe a pagar Los decimales se separan por "." | SI |
Moneda | Moneda del importe | SI |
Métodos de pago | ||
Solapa Crédito / Débito | ||
Tarjeta | Tarjeta disponible para efectuar el pago. Se podrá seleccionar tarjetas de crédito y de débito. Deben existir opciones de pago con modo de ingreso E-commerce. | SI |
Cuotas | Cantidad de cuotas toleradas para una tarjeta. Permite valor alfanumérico. Los ingresos podrían ser por rango:
| SI |
% interés | Porcentaje de interés relacionado a las cuotas y a la tarjeta. Los decimales se separan con "." (punto) | SI |
Solapa PEI Para que se despliegue esta solapa, se debe seleccionar un Comercio que tenga asociado Locales virtuales y que además tengan configurado Comercio PEI y Sucursales PEI | ||
Tarjeta | Tarjeta disponible para efectuar un pago con modalidad PEI. Sólo se desplegarán tarjetas de débito. No hace falta que existan opciones de pago cargadas. | |
Cliente | ||
Nombre | Nombre del cliente | SI |
Apellido | Apellido del cliente | SI |
E-mail del cliente | NO | |
Teléfono | Teléfono del cliente | SI |
Artículos | Artículos que conforman la solicitud de pago. Se permitirá la carga de hasta 20 registros como máximo.
| NO |
Código | Identificador o código del artículo | Condicional |
Descripción | Descripción o título del artículo | Condicional |
Cantidad | Cantidad de artículos | Condicional |
Precio unitario | Precio unitario del artículo Los decimales se separan con "." | Condicional |
Solapa PEI
En la sección "Métodos de pago" se visualizará la solapa PEI donde se podrán seleccionar tarjetas de débito, para realizar pagos a través de la modalidad PEI. Para que esta solapa aparezca visible, se debe seleccionar un Comercio que tenga asociado Locales virtuales y que además tengan configurado Comercio PEI y Sucursales PEI.
Se mostrarán los siguientes datos:
Campo | Detalle |
---|---|
Tarjeta | Tarjeta disponible para efectuar un pago con modalidad PEI. Sólo se desplegarán tarjetas de débito. No hace falta que existan opciones de pago cargadas. |
Informações | ||
---|---|---|
| ||
Los links de pago generados tienen un vencimiento por defecto, de 24 hs. Si el cliente no realiza el pago en ese período, el link de pago cambia de estado a "Expirado" y no se podrá pagar. Dicho link de pago queda descartado. |
...
- La sección de búsqueda tendrá los siguientes campos:
Campo | Detalle | Requerido |
---|---|---|
Compañía | Combo desplegable que lista los nombres de las compañías. Sólo mostrará las compañías asociadas al usuario logueado. | SI |
Estado de solicitud | Combo desplegable que lista los nombres de los estados de solicitudes. | SI |
Número de solicitud | Campo de texto donde se ingresará el número de la transacción a buscar. | NO |
Apellido del cliente | Campo de texto donde se ingresará el apellido del cliente; buscará por similitud (si se agrega la palabra "rodrig", se tendrá que buscar con la sintaxis LIKE '%rodrig%'). | NO |
Fecha de creación desde | Campo que desplegará un calendario para ingresar una fecha. | NO |
Fecha de creación hasta | Campo que desplegará un calendario para ingresar una fecha. | NO |
Mis solicitudes | Checkbox que filtrará las solicitudes que haya creado el usuario logueado. Valor por defecto "tildado". | SI |
Botón "Buscar" | Al presionar el botón, se listará el resultado de la búsqueda con los datos que coincidan con los filtros. |
La sección resultados por defecto se mostrará vacía al ingresar en esta pantalla. El cuadro de resultados tendrá los campos:
"Fecha de creación", creación del link de pago
- "Estado", estado de la solicitud al momento de consultarla.
- "Número de solicitud", número generado por VTOL.
"Cliente", mostrará nombre y apellido del cliente que realiza el pago.
"Concepto", concepto que se cargó en el alta.
"Importe", importe que se cargó en el alta.
"Email cliente".
- "Cancelar", checkbox que acompañado del botón "Cancelar" se podrán cancelar las solicitudes en estado "Pendiente"
Acción "Ver", al presionar la acción desplegará un popup con los detalles de la solicitud. Ver más abajo.
...
Detalles de la solicitud de pago
Campo | Detalle |
---|---|
Compañía | Compañía asociada a la solicitud de pago |
Código de compañía | Código de la Compañía asociada a la solicitud de pago |
Número de solicitud | Número de solicitud generado por VTOL Server. |
Fecha de creación | Fecha de creación de la solicitud de pago. |
Usuario | Usuario que creó la solicitud de pago |
Concepto | Concepto de la solicitud de pago |
Estado de solicitud | Estado de la solicitud |
Descripción | Descripción de la solicitud |
Link de pago generado | Link de pago generado |
Datos del pago
Si el pago tiene estado distinto de "Pagado" o "Devuelto", la sección de Datos del pago no se mostrará.
Campo | Detalle |
---|---|
Resultado | Resultado de la operación de pago |
Código de autorización | Código de autorización de la operación |
Tarjeta | Tarjeta con la cual se realizó el pago |
Tipo de tarjeta | Tipo de Tarjeta con la cual se realizó el pago |
Número de tarjeta | Número de Tarjeta con la cual se realizó el pago |
Cuotas | Cuotas con las cuales se realizó el pago |
Importe de la solicitud | Importe con el cual se creó la solicitud |
Importe pagado | Importe por el cual se realizó el pago |
Lote | Numero de lote |
Ticket | Número de ticket |
Comercio | Número de comercio |
Terminal | Número de terminal |
Datos del cliente
Campo | Detalle |
---|---|
Nombre | Nombre del cliente que realizó el pago |
Apellido | Apellido del cliente que realizó el pago |
Email del cliente que realizó el pago | |
Teléfono | Teléfono del cliente que realizó el pago |
Ejemplo de pantalla:
22.4.3 Cancelar un Link de Pago
...
La pantalla "Ventas Ecommerce" ofrece los siguientes filtros de búsqueda para localizar una venta efectuada en un canal no presencial:
Campo | Detalle | Requerido |
---|---|---|
Compañía | Combo desplegable con los nombres de las compañías que el usuario logueado tiene acceso y permiso | Sí |
Local | Combo desplegable con los nombres de las tiendas virtuales pertenecientes a la compañía preseleccionada | Sí |
Fecha desde | Campo que desplegará un calendario para ingresar la fecha desde por rango de la operación de venta | No |
Fecha hasta | Campo que desplegará un calendario para ingresar la fecha hasta por rango de la operación de venta | No |
Número referencia comercio | Campo para ingresar el Número de referencia creado por el comercio. | No |
Estado del lote | Combo desplegable para seleccionar el estado del lote (abierto o cerrado) | Sí |
Apellido cliente | Apellido del cliente que realizó la compra | No |
Nro. Doc. titular tarjeta | Número de DNI del titular de la tarjeta que realizó la compra | No |
Últimos 4 dígitos tarjeta | Campo para ingresar los últimos 4 dígitos de la tarjeta que se utilizó para realizar el pago. | No |
Al oprimir el botón "Buscar" se listará en la grilla de resultados las ventas que coincidan con la búsqueda.
...
Efectuada una búsqueda, se puede visualizar la información resumida de las ventas eCommerce en la grilla de resultados:
Campo | Detalle |
---|---|
Compañía | Nombre de la compañía a la que pertenece la venta |
Local | Nombre del local o la tienda virtual perteneciente a la compañía |
Fecha de transacción | Fecha y hora que se registró la operación de venta |
Importe | Importe de la venta |
Número referencia comercio | Número que identifica la transacción, creado por el comercio. |
Estado del lote | Estado del lote (abierto o cerrado) |
Apellido cliente | Apellido del cliente que realizó la compra |
Nro. Doc. titular tarjeta | Número de DNI del titular de la tarjeta que realizó la compra |
Detalle | Al presionar el botón "Ver" se mostrará un popup con los detalles de la venta y las devoluciones asociadas, en caso de que existieran. |
Acción | Al presionar el botón "Devolver" se mostrará un popup para que el comerciante pueda efectuar devoluciones parciales o totales de la venta. Ver mas abajo. |
23.2.2.1 Detalles de las ventas eCommerce
...
A continuación, se detalla la propiedad:
Propiedad | Tipo | Descripción | Requiere reiniciar? |
---|---|---|---|
Url de conexión con el servicio de autorizaciones ecommerce (VTOL Integration Service) | Alfanumérico | URL de conexión con el componente VTOL Integration Service | No |
24. Generación de códigos QR
...
- Compañía
- Nombre template
Archivo: corresponde a la plantilla HTML que se utilizará para generar los códigos QR. Por defecto, en cada instalación de VTOL se cuenta con plantillas de Napse, las cuales se encuentran en la siguiente ubicación:
<directorioInstalación>\dist\config\modules\cd-ar\qr-templates.
Allí se encontrarán los siguientes archivos:
Nombre de archivo Descripción default-mp.zip
Archivo con diseño de Napse, el cual incluye únicamente el logo de la billetera Mercado Pago default-tp-bimo-modo.zip
Archivo con diseño de Napse, el cual incluye el logo de las billeteras Todo Pago, Bimo y Modo default-yacare.zip Archivo con diseño de Napse, el cual incluye únicamente el logo de la billetera Yacaré
Presionar "Cargar template" para confirmar el alta, caso contrario presionar "Volver".
...