...

Índice

Âncora
_Toc485222713 _Toc485222713

1. Campos de los mensajes

...

Procedimiento para Pago Offline con Rappi Payless:

1. El POS envía un SaleWallet a VTOL con la billetera Rappi (walletType: 8).
2. VTOL envía la autorización a Rappi, pero no hay conexión.
3. VTOL responde al POS código 620, “Reintente pago por modo offline con código PIN”. Y la operación queda rechazada en VTOL.
4. El POS calcula el código PIN utilizando un barcode vigente. Y se lo informa al rappi tendero para que lo ingrese en su app y así se autoriza el pago.
5. El POS envía una nueva SaleWallet a VTOL, informando el campo 22 (authorizationCode) con el valor del PIN. Esto es para dejar asentada en VTOL que la transacción se realizó en modo offline.
6. VTOL responde “Aprobado” al POS. La autorización se realiza de forma offline, es decir no se envía ningún mensaje a Rappi.
7. El POS envía tercer mensaje a VTOL, "commit" para confirmar la transacción.
8. El POS imprime el ticket y entrega los productos al rappi tendero.

...

El mensaje con la estructura del ticket estará en XML. El elemento raíz de ese mensaje XML deberá ser la etiqueta <message>, siendo la misma lo que se llamará encabezado.

Dentro del encabezado, se podrá enviar el valor de los descuentos totales y de los impuestos totales que aplicarán a la compra. Son campos opcionales.

Los campos dentro del encabezado son: totDiscount y totTaxes

Detalle de los campos:

La manera de ejecutar un comando es utilizando una etiqueta con la forma <elemento-comando>. El elemento "item" identifica a los artículos. De esta manera, si se desea, por ejemplo, agregar un nuevo artículo el comando a utilizar será <item-add>. En el cuerpo del mensaje podrá contener uno, ninguno o varios de estos comandos. 

...

<message>
<item-add seq="1<message totDiscount="100.00" totTaxes="50.00">
<item-add seq="1" code="0001" discountable="true" unitprice="25100.0" qty="13.0" xprice="300.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="25.0" magnitude="1" description="Jean casual" currency="$" />
<item-add seq="2" code="0002" discountable="true" unitprice="2848.0" qty="21.0" xprice="48.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="48.0" magnitude="1" description="Jean casual" currency="$" />
</message>

...

1.4.24 Operaciones QR Adquiriente Prisma

VTOL se integra con QR Adquiriente de Prisma para permitir efectuar pagos en los puntos de venta con billeteras electrónicas.

...

1. Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL. En el requerimiento, el POS incluirá las opciones de pago que tiene disponibles la caja, para que luego el cliente seleccione la opción de pago más conveniente en su billetera.
2. VTOL recibe la orden de venta del POS, y envía la información a Prisma con todos los datos de la venta.
3. En ese momento el comprador podrá realizar, con su billetera virtual, la lectura del código QR disponible en la caja.
4. Prisma, con la información recibida por VTOL, le comunicará a la billetera virtual el Importe, y las opciones de pago (tarjetas, cuotas, intereses).
5. El comprador visualizará el detalle de la compra, con las opciones de pago enviadas por la caja, y efectuará el pago seleccionando la tarjeta enrolada, las cuotas y confirmando el pago.
6. El POS recibirá la respuesta de la transacción SaleWallet a través de VTOL, quien informará si la operación resultó autorizada por Prisma.
   1. Puede darse el caso que VTOL responda "Consulte el pago por tiempo expirado". 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 envía 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 por Prisma. El paso siguiente del POS es confirmar o cancelar la transacción, con un tercer mensaje.
      2. VTOL responde "Rechazado". Indica que el cliente intentó pagar pero Prisma rechazó el pago.
7. Por último, el POS deberá confirmar la operación, mediante el cierre de sesión (en estado Closeun Tercer Mensaje (Commit o Rollback).

La anulación o / devolución, sí precisa de interacción por parte del comprador en la caja, en su billetera digital debe confirmar la operación. El POS envía el identificador del número de pago del Autorizador en el mensaje RefundWallet.

...

Ejemplo de Respuesta

...

...

1. Campo 27: Código de Respuesta
2. Campo 28: Descripción de la Respuesta

...

...

Código

...

Descripción

1.4.26 Operaciones QR Adquiriente Fiserv

VTOL se integra con QR Adquiriente de Fiserv para permitir efectuar pagos en los puntos de venta con billeteras electrónicas. El código QR es dinámico, es decir que se genera uno nuevo por cada transacción.

Las operaciones soportadas son:

• SaleWallet = Permite realizar una compra presencial con billetera electrónica.
• RefundWallet = NO se permite realizar una devolución con Adquiriente Fiserv. No está contemplado en Fiserv.
• QueryWallet = Permite realizar una consulta de una operación de compra con billetera para conocer si la misma fue autorizada y así obtener los datos por parte del Autorizador.

Procedimiento para QR Adquiriente Fiserv

El proceso de pagos para QR Adquiriente Fiserv 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 Server. En el requerimiento, el POS podrá incluir las opciones de pago mediante las cuales se realizará la operación.
2. VTOL recibe la orden de venta del POS, y envía la información a Fiserv con todos los datos de la venta.
3. Fiserv responde a VTOL que la orden de venta fue creada, y envía el QR para imprimir en el Punto de Venta.
4. VTOL envía hacia el POS el QR enviado por Fiserv. El POS muestra el QR. 
5. VTOL responde al POS: "QR generado. Consulte operación"
6. En ese momento el comprador podrá realizar con su billetera virtual la lectura del código QR. Luego de escanear el QR, el comprador visualizará el detalle de la compra, seleccionando tarjeta, cuotas y confirmando el pago.
7. Fiserv envía a VTOL el Bin de la tarjeta (prefijo y últimos 4 dígitos) del cliente para que VTOL obtenga el Proveedor de la tarejta. Además envía la opción de pago seleccionada por el cliente, informando cuotas y monto final de la operación.
8. VTOL valida que la opción de pago esté configurada en su sistema. Si las cuotas y el monto final de la operación son correctos, se envían los datos a Fiserv para ser autorizados.
9. Fiserv cursa el pago con el Autorizador.
10. El POS deberá consultar el estado del pago, enviando un mensaje de QueryWallet.
    1. Las respuestas del QueryWallet pueden ser las siguientes:
       1. VTOL responde "Aprobado". Indica que el pago fue autorizado por Fiserv. El paso siguiente del POS es confirmar o cancelar la transacción.
       2. VTOL responde "Rechazado". Indica que el cliente intentó pagar pero Fiserv rechazó el pago.
11. Por último, el POS debe confirmar la operación, mediante un Tercer Mensaje (Commit o Rollback).

1.4.26.1 Requerimiento

Estructura del campo posTicket (270)

El mensaje con la estructura del ticket estará en XML. El elemento raíz de ese mensaje XML deberá ser la etiqueta <message>, siendo la misma lo que se llamará encabezado.

La manera de ejecutar un comando es utilizando una etiqueta con la forma <elemento-comando>. El elemento "item" identifica a los artículos. De esta manera, si se desea, por ejemplo, agregar un nuevo artículo el comando a utilizar será <item-add>. En el cuerpo del mensaje podrá contener uno, ninguno o varios de estos comandos. 

Cada uno de los comandos que se envían posee diversos atributos, los cuales identifican al elemento que se está enviando y definen diversas propiedades que poseen los mismos. Poseerá un número de secuencia, el cual identifica cada elemento unívocamente:

Cada comando posee una serie de atributos que definirán las distintas propiedades del elemento que se está agregando (además del número de secuencia antes mencionado).

Para el elemento ítem, los atributos serán los siguientes:

Ejemplo

<message>
 <item-add seq="1" code="0001" discountable="true" unitprice="25.0" qty="1.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="25.0" magnitude="1" description="Jean casual" currency="$" />
 <item-add seq="2" code="0002" discountable="true" unitprice="28.0" qty="2.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="48.0" magnitude="1" description="Jean casual" currency="$" />
</message>

Estructura del campo paymentMethodsData (401)

El mensaje con la estructura de los medios de pago será en JSON. Estará conformado por los siguientes campos:

Ejemplo del campo paymentMethodsData (401)

[
   {
      "providerPosCode":"VIG",
      "bankCode":"7",
      "installments":[
         {
            "paymentOptionId":"1",
            "quantity":"1",
            "amountPerInstallment":150000,
            "totalAmount":150000,
            "surcharge":0,
            "nominalAnnualRate":0,
            "defaultPosWalletInstallement":true
         },
         {
            "paymentOptionId":"2",
            "quantity":"6",
            "amountPerInstallment":25000,
            "totalAmount":150000,
            "surcharge":1100,
            "nominalAnnualRate":1500
         }
      ]
   },
   {
      "providerPosCode":"VI",
      "installments":[
         {
            "paymentOptionId":"3",
            "quantity":"12",
            "amountPerInstallment":15000,
            "totalAmount":180000,
            "surcharge":1256,
            "nominalAnnualRate":1487
         }
      ]
   },
   {
      "providerPosCode":"MC",
      "installments":[
         {
            "paymentOptionId":"4",
            "quantity":"1",
            "amountPerInstallment":150000,
            "totalAmount":150000,
            "surcharge":0,
            "nominalAnnualRate":0
         },
         {
            "paymentOptionId":"5",
            "quantity":"12",
            "amountPerInstallment":15000,
            "totalAmount":180000,
            "surcharge":1256,
            "nominalAnnualRate":1487
         }
      ]
   }
]

1.4.26.2 Respuesta

1.4.27 Operaciones PayStore

VTOL se integra con PayStore de Prisma para permitir efectuar pagos en los puntos de venta, utilizando tarjetas presentes de crédito o débito, y billeteras electrónicas.

Las operaciones soportadas son:

• SaleWallet = Permite realizar una compra presencial a través de PayStore.
• RefundWallet = Permite realizar una devolución (total) de una compra presencial a través de PayStore. No se permiten devoluciones parciales.
• QueryWallet = Permite realizar una consulta de una operación de compra con PayStore para conocer si la misma fue autorizada y así obtener los datos por parte del Autorizador.

Procedimiento para PayStore

El proceso de pagos con PayStore 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. En el requerimiento, el POS puede incluir o no la cantidad de cuotas del pago.
2. VTOL recibe la orden de venta del POS, y envía la información a PayStore con todos los datos de la venta.
3. En ese momento el cajero podrá capturar los datos del pago en la terminal pinpad, el cual puede ser con tarjeta física de crédito y débito, o bien con billetera virtual, realizando la lectura del código QR que se muestra en el pinpad.
4. El POS recibirá la respuesta de la transacción SaleWallet con el mensaje: "Consulte el pago". 
5. 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. 1. VTOL responde "Aprobado". Indica que el pago fue autorizado por PayStore. El paso siguiente del POS es confirmar o cancelar la transacción. Se imprime el comprobante en la terminal pinpad.
      2. VTOL responde "Rechazado". Indica que el cliente intentó pagar pero PayStore rechazó el pago.
6. Por último, el POS deberá confirmar la operación, mediante el Tercer Mensaje, enviando Commit.

La anulación o devolución, sí precisa de interacción por parte del comprador en la caja, en la terminal pinpad se debe capturar los mismos datos de la tarjeta o billetera virtual que se utilizó para el pago. El POS envía el identificador del número de pago del Autorizador en el mensaje RefundWallet.

1.4.27.1 Requerimiento

Estructura del campo posTicket

El mensaje con la estructura del ticket estará en XML. El elemento raíz de ese mensaje XML deberá ser la etiqueta <message>, siendo la misma lo que se llamará encabezado.

Dentro del encabezado, se podrá enviar el valor de los descuentos totales y de los impuestos totales que aplicarán a la compra.

Los campos dentro del encabezado serán: totDiscount y totTaxes

Detalle de los campos:

La manera de ejecutar un comando es utilizando una etiqueta con la forma <elemento-comando>. El elemento "item" identifica a los artículos. De esta manera, si se desea, por ejemplo, agregar un nuevo artículo el comando a utilizar será <item-add>. En el cuerpo del mensaje podrá contener uno, ninguno o varios de estos comandos. 

Cada uno de los comandos que se envían posee diversos atributos, los cuales identifican al elemento que se está enviando y definen diversas propiedades que poseen los mismos. Poseerá un número de secuencia, el cual identifica cada elemento unívocamente:

Cada comando posee una serie de atributos que definirán las distintas propiedades del elemento que se está agregando (además del número de secuencia antes mencionado).

Para el elemento ítem, los atributos serán los siguientes:

Ejemplo

<message totDiscount="100.00" totTaxes="50.00">
<item-add seq="1" code="0001" discountable="true" unitprice="100.0" qty="3.0" xprice="300.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS"  magnitude="1" description="Jean casual" currency="$" />
<item-add seq="2" code="0002" discountable="true" unitprice="28.0" qty="1.0" xprice="48.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" magnitude="1" description="Jean casual" currency="$" />
</message>

Ejemplo de requerimiento:

1.4.27.2 Respuesta

Ejemplo de respuesta:

Âncora
_Toc485222740 _Toc485222740

1.5 Códigos de Respuesta al POS

La respuesta que el POS recibe de VTOL se encuentra en los siguientes campos:

1. Campo 27: Código de Respuesta
2. Campo 28: Descripción de la Respuesta

A continuación se detallan las respuestas posibles con una breve descripción de cada una:

...

A continuación se detallan las respuestas posibles de VTOL Server, cuando se opera con Billeteras Electrónicas, con una breve descripción de cada una:

1.5.4.1 Códigos de respuesta de VTOL Server para Billetera Rappi Payless

1.5.4.1 Códigos de respuesta de VTOL Server para Billetera Rappi Payless

Âncora
codrespnopresencial codrespnopresencial

1.5.5 Códigos de Respuesta de VTOL Server para operaciones no presenciales

...

A continuación se detalla la información que viaja en el campo ConfData y que se corresponde con la interface generada para el POS.

La versión de Formato de interface utilizada por Crédito Debito Argentina es la v109 v110

Header

...

Ejemplo
PV:VI;Visa;;
PV:MA;Mastercard;00;DEFAULT;VI
PV:AMVIG;AmexVisa;;7;BANCO DE GALICIA Y BUENOS AIRES S.A.U.;VI
PV:MA;Maestro;;00;DEFAULT;MC
PV:MC;Master Card;;00;DEFAULT;MC
PV:AM;Amex;;00;DEFAULT;AM
PV:DI;Diners;;00;DEFAULT

Tabla Prefijos

...