...

Índice

...

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:

Image Removed

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:

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:

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).

Image Removed

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.

Image Removed

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:

Image Removed

...

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:

Image Added

Los cambios se toman sin requerir el reinicio de la aplicación.

A continuación se explican las propiedades para configurar un Proxy:

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:

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).

Image Added

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.

...

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. 

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

...

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.

Image Added

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:

Image Added

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. 

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".

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:

Image Removed

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. 

...

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:

Image Added

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:

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.

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 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

Image Added

14.5.2 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".
    
    

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. 

15. Configuración Tokenización

...