...

Índice

Âncora
_Toc485222713 _Toc485222713

1. Campos de los mensajes

...

VTOL se integra con las siguientes billeteras electrónicas para permitir efectuar pagos en los puntos de venta:

• Mercado Pago
• Yacaré
• Plus Pagos

Las operaciones soportadas en VTOL Server para Billeteras electrónicas son:

...

Procedimiento para Pagos con Mercado Pago, Yacaré y YacaréPlus Pagos

El proceso de pagos con billetera virtual se realizará de la siguiente manera:

1. Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
2. Recién en ese momento el comprador podrá efectuar la lectura del código QR impreso en la caja mediante su smartphone. 
3. La billetera, con la información de la orden de venta recibida por VTOL, le comunicará a la app de la billetera virtual el importe total y el detalle de los artículos adquiridos.
4. El comprador visualizará en su app mobile el detalle de la compra, y efectuará el pago seleccionado el medio de pago (tarjeta, o saldo de Mercado Pagocon dinero en cuenta), la tarjeta enrolada (o incorporando una nueva), las cuotas y confirmando el pago.
5. El POS recibirá la respuesta de la transacción SaleWallet a través de VTOL, quien informará si la operación resultó aprobada por el Autorizador.
   1. Puede darse el caso que VTOL responda "Tiempo expirado. Elija Consultar o Cancelar pago". Este escenario puede surgir cuando el cliente demora en confirmar el pago desde su app mobile, y expira el tiempo designado por defecto en VTOL, entonces al POS se le da una respuesta automática por timeout. Para conocer el resultado de la operación, el POS deberá realizar una consulta (transacción QueryWallet). Las respuestas del QueryWallet pueden ser las siguientes:
      1. VTOL responde "Aprobado". Indica que el pago fue autorizado. El paso siguiente del POS es confirmar o cancelar la transacción, con un Tercer Mensaje.
      2. VTOL responde "Pago Rechazado, desea seguir esperando?". Indica que el cliente intentó pagar y el pago se rechazó, pero a su vez el cliente puede volver a intentar realizar el pago con otra tarjeta u otro medio de pago, por lo cual el POS puede "seguir esperando" para permitirle al cliente intentar pagar nuevamente, y luego el POS deberá enviar un nuevo QueryWallet, o directamente cancelar la operación.
6. Por último, el POS deberá confirmar la operación, mediante el tercer mensaje (transacción UnsyncCompletion).
   

...

La anulación, no precisa de interacción por parte del comprador en la caja. Simplemente el POS envía el identificador del número de pago del Autorizador en el mensaje RefundWallet.

Procedimiento para operar cashout para Cashout con Mercado Pago

Se podrán realizar las siguientes operaciones:

...

• Una vez recibida la respuesta de operación Aprobada por parte de Mercado Pago, se puede realizar lo siguiente:
  • Para una venta con productos y cashout. Permite anular:
    • Los productos y el cashout, todo junto. Esto se logra enviando un UnSyncCompletion=rollback
  • Para una venta sólo con productos. Permita anular:
    • Todos los productos. Esto se logra enviando un UnSyncCompletion=rollback.
• No es posible realizar anulaciones intermedias. 

1.4.18.1 Requerimiento

...

Número

...

Nombre del campo

...

Tipo de dato

...

SaleWallet

...

Descripción

...

...

Procedimiento para Devoluciones en Yacaré

El proceso de Devolución con billetera Yacaré se realizará de la siguiente manera:

1. Se inicia con el envío de una orden de devolución (transacción RefundWallet) por parte del POS a VTOL.
2. El POS recibirá la respuesta de la transacción RefundWallet a través de VTOL, quien informará si la operación resultó aprobada por el Autorizador.
   1. VTOL responde "Aprobado". Indica que la devolución fue autorizada. El paso siguiente del POS es confirmar o cancelar la transacción, con un Tercer Mensaje.
      1. VTOL responde "Rechazado". Indica que la devolución debe ser cursada nuevamente o la misma no se puede realizar. Depende del mensaje informado por VTOL.
   2. Por último, el POS deberá confirmar la operación, mediante el tercer mensaje (transacción UnsyncCompletion).
3. En VTOL se creará la Operación de Devolución que deberá ser resuelta administrativamente, en la pantalla: Resolución Administrativa de Billeteras ver el manual de usuario de VTOL.
4. El comerciante deberá realizar un trámite administrativo en el portal de YACARÉ para que Yacaré aplique la devolución en cuestión. Si no se realiza ese trámite, no se efectuará la devolución al cliente. Una vez realizada, Yacaré informará un código de autorización de la devolución.
5. El código de autorización informado por Yacaré deberá ser ingresado en la pantalla de Resolución Administrativa de Billeteras de VTOL para confirmar la devolución.
6. Esta acción se utiliza para que los sistemas de Yacaré y VTOL queden conciliados.

Procedimiento para Devoluciones con Plus Pagos

La devolución siempre es por el importe total de la venta, por lo que VTOL valida antes de gestionar la operación que el monto de la Devolución sea igual al monto de la Venta.

El proceso de Devolución con billetera Plus Pagos se realizará de la siguiente manera:

1. Se inicia con el envío de una orden de devolución (transacción RefundWallet) por parte del POS a VTOL.
2. VTOL recibe un RefundWallet desde el POS indicando el origen de la billetera.
3. VTOL responde al POS Devolución Aprobada.
4. El POS  envía el tercer mensaje:
   
   1. Si es COMMIT. VTOL programa el envío de la devolución al servicio de Plus Pagos:
      1. Si es el pago fue con Tarjeta de Credito/Debito, Plus Pagos informa al autorizador de la devolución, y si este aprueba, en la respuesta informa "Devolución Aprobada".
      2. Si es el pago fue con Saldo PlusPagos, esa devolución queda pendiente en el sistema de Plus Pagos hasta que sea confirmada o rechazada en su BackOffice. 
         1. Plus Pagos responde a VTOL que el estado de la transacción es PENDIENTE DE APROBACIÓN.
         2. La operación quedará pendiente en el BackOffice de PlusPagos, hasta que el comerciante Confirme o Rechace la devolución en su plataforma.
         3. Una vez que se aplica una acción en el BackOffice de PlusPagos por parte del comerciante, Plus Pagos enviará una Notificación hacia VTOL informando el cambio de estado de la operación:

            1. Si Confirma, se devolverá el pago original, y se enviará una Notificación a VTOL indicando que el estado de la venta es DEVUELTA.

            2. Si Rechaza, no se devolverá el pago original, y se enviará una Notificación a VTOL indicando que el estado de la venta original sigue APROBADA. Si fue Rechazada, no se podrá volver a enviar el pedido de devolución.                                

         4. Cuando VTOL recibe la notificación desde PlusPagos, no informa nada al POS, y si se quiere conocer el estado de la devolución, se debe hacer mediante una consulta con el número de la transacción.

   2. Si es ROLLBACK. VTOL no enviará ningún mensaje a Plus Pagos, y se eliminará el pedido de devolución.

1.4.18.1 Requerimiento

Ejemplo

...

...

...

...