...
| Painel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| Painel | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
| Nota |
|---|
| Nota: Para el caso en que la terminal utiliza un dispositivo teclado con lector de banda magnética u otro dispositivo que no sea un pinpad, no es preciso realizar configuración alguna en el archivo serialPinPad.properties de la librería. |
| Âncora | ||
|---|---|---|
|
...
Como se mencionó anteriormente, EMVKIT corre como una aplicación stand alone en el POS, independiente de la aplicación de punto de venta, publicando un puerto de comunicación server TCPIP, capaz de interpretar mensajes del protocolo VTOL (mismo protocolo de comunicación utilizado por VTOL Server).
...
|
| Âncora | ||
|---|---|---|
|
...
|
...
|
...
Para poder realizar las llamadas hacia EMVKIT, es necesario que la aplicación punto de venta integre la librería cliente, también llamada "liviana":
La misma está disponible en 2 versiones:
- JAVA
- .NET
El uso de cada una dependerá del lenguaje de programación de la aplicación de punto de venta o del sistema integrador.
Para mayor información referirse a la documentación de la librería liviana.
– Driver del pinpad "VISA 0315B 3DES"
| Âncora | ||||
|---|---|---|---|---|
|
La instalación de EMVKIT o EMV Kit se realiza gracias al uso de un instalador o asistente gráfico. Mediante este asistente de instalación, también se instala el componente agente de la solución Director para que EMV Kit pueda actualizarse remotamente.
En esta nueva versión de EMVKIT AR se puede elegir en la configuración la versión de Driver del pinpad "VISA 0315B 3DES", la cual permite utilizar el nuevo firmware de Pinpad de Prisma que realiza encriptación en 3DES.
Para ello se deben seguir los siguientes pasos:
- Iniciar sesión en el sistema operativo donde se instalará EMVKIT con un usuario con permisos de administrador.
- Iniciar el instalador de la aplicación ejecutando la siguiente sentencia en la línea de comandos:
| Bloco de código |
|---|
java –jar INSTALADOR.jar |
Por ejemplo:
| Bloco de código |
|---|
java -jar vtol-pos-client-lib-ar-installer-1.11.1-2024-01-23-DirectorV-2.0.0.jar |
| Nota |
|---|
| Nota: Verificar tener seteada correctamente la variable JAVA_HOME. En caso de no tenerla, setearla a la carpeta de instalación de la JVM. Para esto verificar la carpeta de instalación, ejemplo: C:\Java\jdk1.8.0_25\. |
Al ejecutar esta sentencia, se descomprime el archivo. 
3. Se presentará la pantalla de bienvenida del instalador. Presionar el botón "Siguiente".
4. Al pasar a la siguiente pantalla, se mostrarán los términos y condiciones de uso de la aplicación de software para ser leídos y posteriormente aceptados para poder continuar con la instalación.
Presionar el botón "Aceptar".
5. A continuación, se deberán aceptar los términos y condiciones de uso y completar los datos (nombre completo y correo electrónico) de quién acepta. Presionar el botón "Siguiente".
| Nota |
|---|
| Nota: Si no se aceptan los términos y condiciones de uso, la instalación no se completará. |
6. En la siguiente pantalla se deben ingresar las siguientes propiedades:
- El directorio donde se encuentra Java
- El directorio donde se desea instalar EMVKIT o EMV Kit
- El código de la compañía, configurado en Director
- El código de la tienda, configurado en Director
- El código de la terminal de la tienda desde donde se operará, configurado en Director
- La IP de VTOL Server para poder comunicarse
- El puerto de VTOL Server
- Por defecto 3003 (con SSL)
- La IP donde se comunica EMV Kit
- Por defecto localhost
- El puerto donde se vincula EMV Kit
- Por defecto 3500
- Y, por último, establecer si se desea actualizar EMV Kit remotamente gracias a Director.
Al habilitar el componente checkbox, se ofrecerá completar las propiedades de la pantalla del punto 7. Si no se habilita el componente checkbox, se continúa con la pantalla del "punto 8. Indicar el puerto donde se encuentra conectado el pinpad y seleccionar mediante el desplegable el driver del pinpad" correspondiente a 3DES.
Presionar el botón "Siguiente".
En caso de que el directorio donde se desea instalar EMV Kit no exista, se ofrecerá crearlo. Presionar el botón "Sí" para ello.
A continuación, se muestra la información de la configuración de SSL con los siguientes campos completados:
7. Se muestra la pantalla en donde se deberá completar el campo de la URL de Director, esta pantalla se brindará cuando se haya habilitado el componente checkbox "Actualizable Remotamente" del punto 6.
Luego de ingresar la URL de Director se deberá oprimir el botón "Siguiente". Nota: la URL debe cumplir con el formato https://www.napsedirector.com, de lo contrario, se mostrará el siguiente mensaje “Campos obligatorios o con el formato incorrecto”.
8. En la configuración del Driver del Pinpad se deberá seleccionar de la lista desplegable el driver “VISA 0315B 3DES” que permite utilizar el nuevo firmware de Pinpad de Prisma que realiza encriptación en 3DES, como se muestra a continuación:
| Nota |
|---|
Para conocer en Windows el puerto donde se encuentra conectado el pinpad, dirigirse a Panel de control > Administrador de dispositivos, desplegar el submenú "Puertos (COM y LPT)" y revisar el COM que aparece. Ejemplo: Verifone Terminal (COM9). |
9. Presionar "Instalar" para que se ejecute la instalación.
Se podrá observar información detallada de la instalación presionando el botón "Enseñar detalles". Al hacer esto se mostrarán dos solapas:
- En la solapa "Salida" podrá observar el progreso de la instalación visualizando las tareas ejecutadas por el instalador
- En la solapa "Errores" se presentan las fallas que tuvieron lugar durante la instalación
10. La finalización de la instalación se informa mediante un mensaje de "Terminado".
Oprimir "Aceptar".
11. Presionar el botón "Salir" para salir del instalador.
| Âncora | ||||
|---|---|---|---|---|
|
Finalmente, EMVKIT o EMV Kit queda funcionando como unservicio junto con el componente agente de Director. A continuación, los servicios:
Donde:
- EmvKit: Servicio de EMVKIT o EMV Kit
- EmvKitDirectorService: Servicio del componente agente de Director correspondiente a EMVKIT o EMV Kit
| Âncora | ||||
|---|---|---|---|---|
|
Carpeta / Archivo | Descripción |
backup | Directorio que persistirá los últimos cinco backups de archivos de las versiones instaladas de la solución EMV Kit durante la tarea de instalación |
| doc | Contiene los archivos map_port.sh y README.txt, los cuales son definidos en la siguiente sección. |
Contiene todos los archivos requeridos para el funcionamiento del EMV Kit | |
sdagent | Contiene los archivos del componente agente de Director (configuración, binarios y registros) |
sdagentcmds | Contiene los archivos para iniciar/detener/consultar el agente de Director de la solución EMV Kit |
tmp | Persiste los archivos de la versión a instalar de la solución EMV Kit durante la tarea de sincronización |
util | Contiene las utilidades para la creación de los servicios en Linux |
licenseAccepted.sts | Archivo de texto que menciona el nombre de usuario, el mail del usuario y la fecha que aceptó los términos y condiciones de uso |
nssm.exe | Aplicación encargada de construir los servicios EmvKit y EmvKitDirectorService para Windows |
| Âncora | ||||
|---|---|---|---|---|
|
Carpeta / Archivo | Descripción |
config | Contiene los archivos de configuración requeridos para EMVKIT o EMV Kit |
lib | Contiene todos los archivos JAR, propietarios y de terceros, requeridos para el funcionamiento de EMVKIT |
start.cmd | Archivo de inicio de la aplicación como proceso de Windows |
start.sh | Archivo de inicio de la aplicación como proceso de Linux |
| Âncora | ||||
|---|---|---|---|---|
|
Carpeta / Archivo | Descripción |
map_port.sh | Script, exclusivo para entorno Linux (versión soportada por VTOL) e idealmente para que sea ejecutado al inicio del sistema, que permite asignarle un alias específico a los puertos que poseen una conexión establecida con pinpads para poder definirlos por ese alias. Nota: El alias se configura desde el archivo serialPinPad.properties |
README.txt | Documento de texto que informa los objetivos de los archivos contenidos en la carpeta "doc" |
Luego de realizar la instalación de emvkit versión 1.11.1 con el drive de 3DES de Prisma, se deberá verificar el archivo serialPinPad.properties que se encuentra en la carpeta config de la instalación de emvkit. A continuación, se muestra que la línea 26 "PPVX820VISA.nativeImpleClass=com.synthesis.vtolClientLib.deviceAdapters.RxTxSimpleSerialNativeLibWrapperImpl" correspondiente a Producción no debe estar comentada:
| Aviso |
|---|
IMPORTANTE: La instalación mediante el asistente gráfico configurará la solución EMV Kit en su totalidad. En caso de que se precise configurar un archivo de forma manual, se deberá detener el servicio y efectuar el cambio en base a lo explicado en el apartado "Configuración". |
5.3 Configuración Pinpad 3DES de Prisma
Luego de realizar la instalación de emvkit versión 1.11.1 con el drive 3DES de Prisma, se debe verificar el archivo "serialPinPad.properties" que se encuentra en la carpeta "config" de la instalación de emvkit. La línea 26 "PPVX820VISA.nativeImpleClass=com.synthesis.vtolClientLib.deviceAdapters.RxTxSimpleSerialNativeLibWrapperImpl" correspondiente a Producción debe estar de la siguiente forma:
| Nota | ||
|---|---|---|
| ||
La versión de VTOL compatible con la funcionalidad del PIN 3DES es "VTOL CD AR 3.8.1.0" |
| Âncora | ||||
|---|---|---|---|---|
|
Como se mencionó anteriormente, EMVKIT corre como una aplicación stand alone en el POS, independiente de la aplicación de punto de venta, publicando un puerto de comunicación server TCPIP, capaz de interpretar mensajes del protocolo VTOL (mismo protocolo de comunicación utilizado por VTOL Server).
La integración con la aplicación de punto de venta se realizará a través de la librería cliente liviana de VTOL la cual brinda todo el mecanismo de comunicación con EMVKIT, permitiendo enviar y recibir mensajes del protocolo VTOL. La aplicación punto de venta básicamente deberá indicar cuáles son los campos a enviar y, luego, procesar la respuesta.
| Âncora | ||||
|---|---|---|---|---|
|
Para poder realizar las llamadas hacia EMVKIT, es necesario que la aplicación punto de venta integre la librería cliente, también llamada "liviana":
La misma está disponible en 2 versiones:
- JAVA
- .NET
El uso de cada una dependerá del lenguaje de programación de la aplicación de punto de venta o del sistema integrador.
Para mayor información referirse a la documentación de la librería liviana.
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
6.2 Tipos de Operación
EMVKIT reconoce los siguientes tipos de operaciones:
...
- Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
- VTOL le envía a GoCuotas el requerimiento de Authentication mediante el endpoint /authentication. Nota: el el request message solo se envía si no existe un authToken vigente, la vigencia de cada authToken es de 24 hs.
- GoCuotas responde a VTOL con el Message message HTTP 200 en donde se envía el Token con la respuesta Aprobadode autenticación aprobado.
- Luego VTOL se comunica con GoCuotas mediante endpoint / send_code, en donde se envían todos los datos del necesarios para generar la venta: email, dni, area_code (sin "0"), telephone_number (sin "15"), amount_in_cents, number_of_installments, order_reference_id y Authorization: Bearer.
- GoCuotas responde a VTOL con el Message HTTP 201 y el dato del "sale_token" que será el token que representará la nueva venta.
- VTOL le responde al POS el isocode 714 y el responseMessage “Orden creada, ingrese el código de verificación”
- El POS le envía a VTOL el primer QueryWallet con el campo QueryWallet con el campo 279: softToken.
- VTOL se comunica con GoCuotas mediante el enpoint “code_verification” endpoint /code_verification, en donde le envía los campos sale_token, code y Authorization: Bearer. En este endpoint se envía el código de seguridad “code” que recibió el cliente en su celular para validar su identidad.
- GoCuotas le responde a VTOL con el dato de la tarjeta (card) que contiene los últimos 4 dígitos y el status de la compradígitos y el status de la compra. GoCuotas responde con toda la información de la venta generada y con los datos del cliente.
- VTOL le responde al POS con el isocode 718 y el responseMessage “Confirma la tarjeta recibida”.
- El POS le envía a VTOL la segunda QueryWallet enviando el (se envía elcampo 6: cardNumber cardNumber con los últimos cuatro dígitos de la tarjeta para confirmar el pago.como eco del campo 6 de la respuesta de VTOL al POS del paso anterior).
- VTOL se comunica con Gocuotas mediante al endpoint / payments (este endpoint se utiliza para realizar el pago y completar la venta).
- GoCuotas responde a VTOL con el status aprobado de la transacción y otros datos.
- VTOL le responde a al POS con el estado de la transacción aprobada (isoCode "00" y responseMessage "Aprobada")
- Por último, el POS envía el tercer mensaje de “Commit”.
...
- Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
- VTOL le envía a GoCuotas el requerimiento de Authentication mediante el endpoint /authentication. Nota: el request message solo se envía si no existe un authToken vigente, la vigencia de cada authToken es de 24 hs.
- GoCuotas responde a VTOL con el Message HTTP 200 en donde se envía el Token con la respuesta Aprobadode autenticación aprobado.
- Luego VTOL se comunica con GoCuotas mediante endpoint / send_code, en donde se envían los datos del email, dni, area_code (sin "0"), telephone_number (sin "15"), amount_in_cents, number_of_installments, order_reference_id y Authorization: Bearer.
- GoCuotas responde a VTOL con el Message HTTP 201 y el dato del "sale_token" . que será el token que representará la nueva venta
- VTOL le responde al POS el isocode 714 y el responseMessage “Orden creada, ingrese el código de verificación”
- El POS le envía a VTOL el primer QueryWallet con el campo 279: softToken.
- VTOL se comunica con GoCuotas mediante el enpoint “code_verification” endpoint / code_verification, en donde le envía los campos sale_token, code y Authorization: Bearer.
- GoCuotas le responde a VTOL con el dato de la tarjeta (card) que contiene los últimos 4 dígitos y el status de la compra. GoCuotas responde con toda la información de la venta generada y con los datos del cliente.
- VTOL le responde al POS con el isocode 718 y el responseMessage “Confirma la tarjeta recibida”.
- El POS le envía a VTOL la segunda QueryWallet con los campos, "6 cardNumber" (dieciséis dígitos de la tarjeta), "8 cvc" (tres dígitos), expirationDate (cuatro dígitos en formato AAMM). También se debe informar el campo "269 WalletType" con GoCuotas.
- VTOL le envía a GoCuotas el requerimiento del cambio de tarjeta mediante el endpoint /cards (este endpoint se utiliza en el caso de que el cliente no tenga ninguna tarjeta cargada en el sistema de GoCuotas o si es necesario cambiar de tarjeta para realizar el pago).
- GoCuotas le responde a VTOL con los siguientes datos: sale_token, status, last_four_digits, entre otros
- VTOL le responde al POS con el isocode 718 y el responseMessage “Confirma la tarjeta recibida”.
- El POS le envía a VTOL la tercera QueryWallet con el "campo 6: cardNumber" en donde se deben ingresar los cuatro últimos dígitos de la tarjeta para confirma confirmar el pago.
- VTOL se comunica con Gocuotas mediante al el endpoint / payments (este endpoint se utiliza para realizar el pago y completar la venta).
- GoCuotas responde a VTOL con los campos payment_successfully_confirmed: true, "status": "approved", card, entre otros.
- VTOL le envía al POS el response message "Aprobada".
...
- Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
- VTOL le envía a GoCuotas el requerimiento de Authentication mediante el endpoint /authentication. Nota: el request message solo se envía si no existe un authToken vigente, la vigencia de cada authToken es de 24 hs.
- GoCuotas responde a VTOL con el Message HTTP 200 en donde se envía el Token con la respuesta Aprobadode autenticación aprobado.
- Luego VTOL se comunica con GoCuotas mediante endpoint / send_code, en donde se envían los datos del email, dni, area_code (sin "0"), telephone_number (sin "15"), amount_in_cents, number_of_installments, order_reference_id y Authorization: Bearer.
- GoCuotas responde a VTOL con el Message HTTP 201 y el dato del "sale_token" que será el token que representará la nueva venta.
- VTOL le responde al POS el isocode 714 y el responseMessage “Orden creada, ingrese el código de verificación”
- El POS le envía a VTOL el primer QueryWallet con el campo 279: softToken.
- VTOL se comunica con GoCuotas mediante el enpoint “code_verification” endpoint / code_verification, en donde le envía los campos sale_token, code y Authorization: Bearer.
- GoCuotas le responde a VTOL con el dato de la tarjeta (card) que contiene los últimos 4 dígitos y el status de la compra. GoCuotas responde con toda la información de la venta generada y con los datos del cliente.
- VTOL le responde al POS con el isocode 718 y el responseMessage “Confirma la tarjeta recibida”.
- El POS le envía a VTOL la segunda QueryWallet con los campos, "6 cardNumber" (dieciséis dígitos de la tarjeta), "8 cvc" (tres dígitos), expirationDate (cuatro dígitos en formato AAMM). También se debe informar el campo "269 WalletType" con GoCuotas.
- VTOL le envía a GoCuotas el requerimiento del cambio de tarjeta mediante el endpoint /cardscards (este endpoint se utiliza en el caso de que el cliente no tenga ninguna tarjeta cargada en en el sistema de GoCuotas o si es necesario cambiar de tarjeta para realizar el pago).
- GoCuotas le responde a VTOL con los siguientes datos: sale_token, status, last_four_digits, entre otros
- VTOL le responde al POS con el isocode 718 y el responseMessage “Confirma la tarjeta recibida”.
- El POS le envía a VTOL la tercera QueryWallet con el "campo 6: cardNumber" en donde se deben ingresar los cuatro últimos dígitos de la tarjeta para confirma el pago.
- VTOL se comunica con Gocuotas mediante el endpoint / payments. Se valida que se excede el tiempo determinado de 2 minutos para realizar el pago.
- GoCuotas responde "Response message: (confirmed: false....)"
- Vtol responde al POS "Response message: Error 604, No se puede realizar el pago, reinicie la operación"
- Se reitera nuevamente el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
- VTOL se comunica con GoCuotas mediante el endpoint / send_code, en donde se envían los datos del email, dni, area_code (sin "0"), telephone_number (sin "15"), amount_in_cents, number_of_installments, order_reference_id y Authorization: Bearer.
- GoCuotas responde a VTOL con el Message HTTP 200 (verificar cód de respuesta) y el dato del "sale_token".
- VTOL le responde al POS el isocode 714 y el responseMessage “Orden creada, ingrese el código de verificación”
- El POS le envía a VTOL la cuarta QueryWallet con el campo 279: softToken.
- VTOL se comunica con GoCuotas mediante el enpoint “code_verification”, en donde le envía los campos sale_token, code y Authorization: Bearer.
- El POS le envía a VTOL la quinta QueryWallet enviando el campo 6: cardNumber con los últimos cuatro dígitos de la tarjeta para confirmar el pago.
- VTOL se comunica con Gocuotas mediante al endpoint / payments.
- GoCuotas responde a VTOL con el status aprobado de la transacción y otros datos para finalizar el pago.
- VTOL le responde a POS con el estado de la transacción aprobada (isoCode "00" y responseMessage "Aprobada")
- Por último, el POS envía el tercer mensaje de “Commit”.
...
- El POS le envía a VTOL la operación “RefundWallet” con los campos 271 walletPaymentId, 24 trxId (opcional) y el 12 Ammount. Nota: si la devolución es por el monto total de la compra, se deberá enviar en el campo 12 el importe total. Si el importe que se desea devolver es menor al total de la compra, se deberá enviar el importe en dicho campo, y se refiere a una compra parcial.
- VTOL se comunica con GoCuotas mediante el endpoint / orders para consultar la orden, en donde se envía el saleToken y el Authorization: Bearer.
- GoCuotas responde con el código HTTP 200 y con el status de la solicitud del refundwallet de la transacción de compra y los datos de la operación.
- Vtol VTOL le responde al POS el estado de la transacción de RefundWallet.
- VTOL se comunica con GoCuotas mediante el endpoint / refund para solicitar la devolución total o parcial de una venta. Se envían los parámetros sale_token y el amount_in_cents.
- GoCuotas le responde a VTOL con datos de la transacción del refundWallet. Si la devolución se realiza por el monto total de la compra, entonces en el campo status aparece “denied”. Si el monto es menor que el importe total de la compra , entonces aparece “Approved”.
...
Código | Nombre del campo | Tipo de dato | SaleWallet | QueryWallet (1) | QueryWallet (2) | Descripción |
|---|---|---|---|---|---|---|
1 | store | Alfanumérico | X | X | X | Identificador del sitio originador de la transacción |
2 | node | Numérico | X | X | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
3 | server | Alfanumérico | X | X | X | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
4 | messageType | Alfanumérico | X | X | X | Tipo de Mensaje:
|
6 | cardNumber | Numérico | - | - | X | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pagode efectuar el pago. Nota: se envía como eco del campo 6 de la respuesta de VTOL al POS. |
7 | expiration | Numérico | - | - | - | Indica el año y el mes de vencimiento de la tarjeta (cuatro dígitos en formato AAMM). Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
8 | cvc | Numérico | - | - | - | Indica los tres dígitos de atrás de la tarjeta. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
11 | trxType | Alfanumérico | X | X | X | Tipo de Transacción:
|
12 | ammount | Importe | X | - | O | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
13 | currencyPosCode | Alfanumérico | X | - | - | Tipos de moneda: $ = Pesos U$S = Dólares |
14 | payments | Numérico | X | - | O | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
16 | originalDate | Numérico | - | X | X | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
24 | trxId | Numérico | - | - | - | Identificador de la transacción |
25 | dateTime | Numérico | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
71 | checkPendingString | Alfanumérico | X | O | - | Indica si VTOL debe o no efectuar el chequeo de pendientes:
|
157 | customerDoc | Numérico | X | - | - | Número de documento del cliente que realiza la consulta. |
268 | walletPosTrxId | Alfanumérico | X | X | X | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: |
269 | walletType | Numérico | X | X | X | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago 5: Yacaré 6: Plus Pagos 8: Rappi Payless 10: GoCuotas |
270 | walletPosTicket | Alfanumérico | X | X | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket |
271 | walletPaymentId | Numérico | - | - | - | Identificador del número de pago informado por el Autorizador. |
279 | softToken | Alfanumérico | - | X | - | Token generado por la app mobile. Este token se lo informa el cliente al cajero, para que sea ingresado en el POS. Obligatorio junto con customerDoc, únicamente si el modo de ingreso es softToken. |
401 | paymentMethodsData | Json | - | - | - | Información de los planes de pago, en formato json |
402 | walletBenefits | Json | - | - | - | Información de las tarjetas de beneficio, en formato json |
416 | customerPhoneAreaCode | Numérico | X | - | - | Código de área de teléfono celular del cliente |
417 | customerPhone | Numérico | X | - | - | Teléfono celular del cliente |
418 | customerEmail | Alfanumérico | X | - | - | Mail del cliente |
...
Código | Nombre del campo | Tipo de dato | SaleWallet | QueryWallet (1) | QueryWallet (2) | Descripción |
|---|---|---|---|---|---|---|
1 | store | Alfanumérico | X | X | X | Identificador del sitio originador de la transacción |
2 | node | Numérico | X | X | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
3 | server | Alfanumérico | - | X | - | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
4 | messageType | Alfanumérico | - | - | - | Tipo de Mensaje:
|
6 | cardNumber | Numérico | - | X | - | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR. |
11 | trxType | Alfanumérico | - | - | - | Tipo de Transacción:
|
12 | ammount | Importe | X | X | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
13 | currencyPosCode | Alfanumérico | X | X | X | Tipos de moneda: $ = Pesos U$S = Dólares |
14 | payments | Numérico | X | - | X | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
16 | originalDate | Numérico | - | - | - | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
24 | trxId | Numérico | X | X | X | Identificador de la transacción |
25 | dateTime | Numérico | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
26 | responseCode | Alfanumérico | X | X | X | Puede contener uno de los siguientes valores:
|
27 | isoCode | Numérico | X | X | X | Código de Respuesta emitido por el centro autorizador. 3 dígitos como máximo. |
28 | responseMessage | Alfanumérico | X | X | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
71 | checkPendingString | Alfanumérico | - | - | - | Indica si VTOL debe o no efectuar el chequeo de pendientes:
|
140 | paymentType | Numérico | X | X | X | Tipo de pago. Valores posibles 0: Tarjeta |
157 | customerDoc | Numérico | - | - | - | Número de documento del cliente que realiza la consulta. |
166 | trxReferenceNumber | Numérico | X | - | - | Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato |
268 | walletPosTrxId | Alfanumérico | - | - | - | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: Opcional en QueryWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra |
269 | walletType | Numérico | - | - | - | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 10: GoCuotas |
270 | walletPosTicket | Alfanumérico | - | - | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket |
271 | walletPaymentId | Numérico | X | X | X | Identificador del número de pago informado por el Autorizador. |
273 | paymentStatus | Alfanumérico | X | X | X | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado |
274 | paymentStatusDetail | Alfanumérico | - | X | X | Detalle del estado de la transacción de pago informado por el Autorizador |
275 | cardType | Numérico | X | X | X | Tipo de tarjeta seleccionada al momento de efectuar el pago QR. |
416 | customerPhoneAreaCode | Numérico | - | - | - | Código de área de teléfono celular del cliente |
417 | customerPhone | Numérico | - | - | - | Teléfono celular del cliente |
418 | customerEmail | Alfanumérico | - | - | - | Mail del cliente |
512 | installmentAmount | Numérico | - | O | - | Importe de cuota. |
| 1010 | currentSessionId | Numérico | X | X | X | Identificador de la sesión que se cierra |
| 1027 | libResponseCode | Numérico | X | X | X | Código de respuesta de la librería. |
| 1028 | libResponseMessage | Alfanumérico | X | X | X | Mensaje descriptivo del código de respuesta de la librería |
...
Código | Nombre del campo | Tipo de dato | SaleWallet | QueryWallet (1) | QueryWallet (2) | QueryWallet (3) | Descripción |
|---|---|---|---|---|---|---|---|
1 | store | Alfanumérico | X | X | X | X | Identificador del sitio originador de la transacción |
2 | node | Numérico | X | X | X | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
3 | server | Alfanumérico | X | X | X | X | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
4 | messageType | Alfanumérico | X | X | X | X | Tipo de Mensaje:
|
6 | cardNumber | Numérico | - | - | X | X | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
7 | expiration | Numérico | - | - | X | - | Indica el año y el mes de vencimiento de la tarjeta (cuatro dígitos en formato AAMM). Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
8 | cvc | Numérico | - | - | X | - | Indica los tres dígitos de atrás de la tarjeta. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
11 | trxType | Alfanumérico | X | X | X | X | Tipo de Transacción:
|
12 | ammount | Importe | X | - | X | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
13 | currencyPosCode | Alfanumérico | X | - | - | - | Tipos de moneda: $ = Pesos U$S = Dólares |
14 | payments | Numérico | X | - | X | X | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
16 | originalDate | Numérico | - | X | X | X | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
24 | trxId | Numérico | - | - | - | - | Identificador de la transacción |
25 | dateTime | Numérico | X | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
71 | checkPendingString | Alfanumérico | X | O | - | - | Indica si VTOL debe o no efectuar el chequeo de pendientes:
|
157 | customerDoc | Numérico | X | - | - | - | Número de documento del cliente que realiza la consulta. |
268 | walletPosTrxId | Alfanumérico | X | X | X | X | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: |
269 | walletType | Numérico | X | X | X | X | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 10: GoCuotas |
270 | walletPosTicket | Alfanumérico | X | X | - | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket |
271 | walletPaymentId | Numérico | - | - | - | - | Identificador del número de pago informado por el Autorizador. |
279 | softToken | Alfanumérico | - | X | - | - | Token generado por la app mobile. Este token se lo informa el cliente al cajero, para que sea ingresado en el POS. Obligatorio junto con customerDoc, únicamente si el modo de ingreso es softToken. |
401 | paymentMethodsData | Json | - | - | - | - | Información de los planes de pago, en formato json |
402 | walletBenefits | Json | - | - | - | - | Información de las tarjetas de beneficio, en formato json |
416 | customerPhoneAreaCode | Numérico | X | - | - | - | Código de área de teléfono celular del cliente |
417 | customerPhone | Numérico | X | - | - | - | Teléfono celular del cliente |
418 | customerEmail | Alfanumérico | X | - | - | - | Mail del cliente |
...
Código | Nombre del campo | Tipo de dato | SaleWallet | QueryWallet (1) | QueryWallet (2) | QueryWallet (3) | Descripción |
|---|---|---|---|---|---|---|---|
1 | store | Alfanumérico | X | X | X | X | Identificador del sitio originador de la transacción |
2 | node | Numérico | X | X | X | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
3 | server | Alfanumérico | - | X | - | - | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
4 | messageType | Alfanumérico | - | - | - | - | Tipo de Mensaje:
|
6 | cardNumber | Numérico | - | X | X | - | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago, para darle a éste la posibilidad de confirmar o cambiar el medio de pago QR. |
11 | trxType | Alfanumérico | - | - | - | - | Tipo de Transacción:
|
12 | ammount | Importe | X | X | X | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
13 | currencyPosCode | Alfanumérico | X | X | X | X | Tipos de moneda: $ = Pesos U$S = Dólares |
14 | payments | Numérico | X | - | X | X | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
16 | originalDate | Numérico | - | - | - | - | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
24 | trxId | Numérico | X | X | X | X | Identificador de la transacción |
25 | dateTime | Numérico | X | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
26 | responseCode | Alfanumérico | X | X | X | X | Puede contener uno de los siguientes valores:
|
27 | isoCode | Numérico | X | X | X | X | Código de Respuesta emitido por el centro autorizador. 3 dígitos como máximo. |
28 | responseMessage | Alfanumérico | X | X | X | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
71 | checkPendingString | Alfanumérico | - | - | - | - | Indica si VTOL debe o no efectuar el chequeo de pendientes:
|
140 | paymentType | Numérico | X | X | X | X | Tipo de pago. Valores posibles 0: Tarjeta |
157 | customerDoc | Numérico | - | - | - | - | Número de documento del cliente que realiza la consulta. |
166 | trxReferenceNumber | Numérico | X | - | - | - | Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato |
268 | walletPosTrxId | Alfanumérico | - | - | - | - | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: Opcional en QueryWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra |
269 | walletType | Numérico | - | - | - | - | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 10: GoCuotas |
270 | walletPosTicket | Alfanumérico | - | - | - | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket |
271 | walletPaymentId | Numérico | X | X | X | X | Identificador del número de pago informado por el Autorizador. |
273 | paymentStatus | Alfanumérico | X | X | X | X | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado |
274 | paymentStatusDetail | Alfanumérico | - | X | X | X | Detalle del estado de la transacción de pago informado por el Autorizador |
275 | cardType | Numérico | X | X | X | X | Tipo de tarjeta seleccionada al momento de efectuar el pago QR. |
416 | customerPhoneAreaCode | Numérico | - | - | - | - | Código de área de teléfono celular del cliente |
417 | customerPhone | Numérico | - | - | - | - | Teléfono celular del cliente |
418 | customerEmail | Alfanumérico | - | - | - | - | Mail del cliente |
512 | installmentAmount | Numérico | - | O | - | - | Importe de cuota. |
| 1010 | currentSessionId | Numérico | X | X | X | X | Identificador de la sesión que se cierra |
| 1027 | libResponseCode | Numérico | X | X | X | X | Código de respuesta de la librería. |
| 1028 | libResponseMessage | Alfanumérico | X | X | X | X | Mensaje descriptivo del código de respuesta de la librería |
...
| Código | Nombre del campo | Tipo de dato | QueryWallet (Operación) | Descripción |
|---|---|---|---|---|
| 1 | store | Alfanumérico | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
| 3 | server | Alfanumérico | X | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
| 4 | messageType | Alfanumérico | X | Tipo de Mensaje: Control = Mensaje de Control, para uso interno por parte de un módulo en su comunicación con el server. Data = Mensaje de la Aplicación cliente. |
| 6 | cardNumber | Numérico | - | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
| 7 | expiration | Numérico | - | Indica el año y el mes de vencimiento de la tarjeta (cuatro dígitos en formato AAMM). Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
| 8 | cvc | Numérico | - | Indica los tres dígitos de atrás de la tarjeta. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
| 11 | trxType | Alfanumérico | X | Tipo de Transacción: SaleWallet = permite realizar una compra presencial con billetera. RefundWallet = permite realizar una devolución (parcial o total) de una compra presencial con billetera realizada con anterioridad. QueryWallet= permite realizar una consulta de una operación de compra con billetera |
| 12 | ammount | Importe | - | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
| 13 | currencyPosCode | Alfanumérico | - | Tipos de moneda: $ = Pesos U$S = Dólares |
| 14 | payments | Numérico | - | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
| 16 | originalDate | Numérico | X | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
| 24 | trxId | Numérico | - | Identificador de la transacción |
| 25 | dateTime | Numérico | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
| 71 | checkPendingString | Alfanumérico | X | Indica si VTOL debe o no efectuar el chequeo de pendientes: true = activa chequeo de pendientes. false = desactiva chequeo de pendientes. |
| 157 | customerDoc | Numérico | - | Número de documento del cliente que realiza la consulta. |
| 268 | walletPosTrxId | Alfanumérico | X | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12) Longitud total de 32 |
| 269 | walletType | Numérico | X | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago 5: Yacaré 6: Plus Pagos 8: Rappi Payless 10: GoCuotas |
| 270 | walletPosTicket | Alfanumérico | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket |
| 271 | walletPaymentId | Numérico | - | Identificador del número de pago informado por el Autorizador. |
| 416 | customerPhoneAreaCode | Numérico | - | Código de área de teléfono celular del cliente |
| 417 | customerPhone | Numérico | - | Teléfono celular del cliente |
| 418 | customerEmail | Alfanumérico | - | Mail del cliente |
...
| Código | Nombre del campo | Tipo de dato | QueryWallet (Operación) | Descripción |
|---|---|---|---|---|
| 1 | store | Alfanumérico | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
| 3 | server | Alfanumérico | - | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
| 4 | messageType | Alfanumérico | - | Tipo de Mensaje: Control = Mensaje de Control, para uso interno por parte de un módulo en su comunicación con el server. Data = Mensaje de la Aplicación cliente. |
| 11 | trxType | Alfanumérico | - | Tipo de Transacción: SaleWallet = permite realizar una compra presencial con billetera. RefundWallet = permite realizar una devolución (parcial o total) de una compra presencial con billetera realizada con anterioridad. QueryWallet= permite realizar una consulta de una operación de compra con billetera |
| 12 | ammount | Importe | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
| 13 | currencyPosCode | Alfanumérico | X | Tipos de moneda: $ = Pesos U$S = Dólares |
| 14 | payments | Numérico | X | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
| 16 | originalDate | Numérico | - | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
| 24 | trxId | Numérico | X | Identificador de la transacción |
| 25 | dateTime | Numérico | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
| 26 | responseCode | Alfanumérico | X | Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24 |
| 27 | isoCode | Numérico | X | Código de Respuesta emitido por el centro autorizador. 3 dígitos como máximo. |
| 28 | responseMessage | Alfanumérico | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
| 71 | checkPendingString | Alfanumérico | - | Indica si VTOL debe o no efectuar el chequeo de pendientes: true = activa chequeo de pendientes. false = desactiva chequeo de pendientes. |
| 140 | paymentType | Alfanumérico | X | Tipo de pago. Valore posible 0: Tarjeta |
| 157 | customerDoc | Numérico | - | Número de documento del cliente que realiza la consulta. |
| 166 | trxReferenceNumber | Numérico | - | Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato |
| 268 | walletPosTrxId | Alfanumérico | - | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12) Longitud total de 32 Opcional en QueryWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra |
| 269 | walletType | Numérico | - | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago 5: Yacaré 6: Plus Pagos 8: Rappi Payless 10: GoCuotas |
| 270 | walletPosTicket | Alfanumérico | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket |
| 271 | walletPaymentId | Numérico | X | Identificador del número de pago informado por el Autorizador. |
| 273 | paymentStatus | Alfanumérico | X | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado 1: Devuelto 2: Pendiente 3: Autorizado 4: En Progreso 5: En mediacion 6: Rechazado 7: Cancelado 8: Contracargo 9: Reversado |
| 274 | paymentStatusDetail | X | Detalle del estado de la transacción de pago informado por el Autorizador | |
| 275 | cardType | Numérico | X | Tipo de tarjeta seleccionada al momento de efectuar el pago QR. |
| 416 | customerPhoneAreaCode | Numérico | - | Código de área de teléfono celular del cliente |
| 417 | customerPhone | Numérico | - | Teléfono celular del cliente |
| 418 | customerEmail | Alfanumérico | - | Mail del cliente |
...
| Código | Nombre del campo | Tipo de dato | RefundWallet | Descripción |
|---|---|---|---|---|
| 1 | store | Alfanumérico | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
| 3 | server | Alfanumérico | X | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
| 4 | messageType | Alfanumérico | X | Tipo de Mensaje: Control = Mensaje de Control, para uso interno por parte de un módulo en su comunicación con el server. Data = Mensaje de la Aplicación cliente. |
| 6 | cardNumber | Numérico | - | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
| 7 | expiration | Numérico | - | Indica el año y el mes de vencimiento de la tarjeta (cuatro dígitos en formato AAMM). Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
| 8 | cvc | Numérico | - | Indica los tres dígitos de atrás de la tarjeta. Este campo se envía solo si se realiza el cambio de tarjeta para realizar el pago. |
| 11 | trxType | Alfanumérico | X | Tipo de Transacción: SaleWallet = permite realizar una compra presencial con billetera. RefundWallet = permite realizar una devolución (parcial o total) de una compra presencial con billetera realizada con anterioridad. QueryWallet= permite realizar una consulta de una operación de compra con billetera |
| 12 | ammount | Importe | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
| 13 | currencyPosCode | Alfanumérico | X | Tipos de moneda: $ = Pesos U$S = Dólares |
| 14 | payments | Numérico | X | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
| 16 | originalDate | Numérico | - | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
| 24 | trxId | Numérico | X | Identificador de la transacción |
| 25 | dateTime | Numérico | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
| 71 | checkPendingString | Alfanumérico | X | Indica si VTOL debe o no efectuar el chequeo de pendientes: true = activa chequeo de pendientes. false = desactiva chequeo de pendientes. |
| 157 | customerDoc | Numérico | - | Número de documento del cliente que realiza la consulta. |
| 268 | walletPosTrxId | Alfanumérico | X | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12) Longitud total de 32 Opcional en QueryWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra |
| 269 | walletType | Numérico | X | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago 5: Yacaré 6: Plus Pagos 8: Rappi Payless 10: GoCuotas |
| 270 | walletPosTicket | Alfanumérico | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket. |
| 271 | walletPaymentId | Numérico | X | Identificador del número de pago informado por el Autorizador. |
| 416 | customerPhoneAreaCode | Numérico | - | Código de área de teléfono celular del cliente |
| 417 | customerPhone | Numérico | - | Teléfono celular del cliente |
| 418 | customerEmail | Alfanumérico | - | Mail del cliente |
...
| Código | Nombre del campo | Tipo de dato | SaleWallet | RefundWallet | QueryWallet | Descripción |
|---|---|---|---|---|---|---|
| 1 | store | Alfanumérico | X | X | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | X | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
| 3 | server | Alfanumérico | - | - | - | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
| 4 | messageType | Alfanumérico | - | - | - | Tipo de Mensaje: Control = Mensaje de Control, para uso interno por parte de un módulo en su comunicación con el server. Data = Mensaje de la Aplicación cliente. |
| 11 | trxType | Alfanumérico | - | - | - | Tipo de Transacción: SaleWallet = permite realizar una compra presencial con billetera. RefundWallet = permite realizar una devolución (parcial o total) de una compra presencial con billetera realizada con anterioridad. QueryWallet= permite realizar una consulta de una operación de compra con billetera |
| 12 | ammount | Importe | X | - | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
| 13 | currencyPosCode | Alfanumérico | X | - | X | Tipos de moneda: $ = Pesos $S = Dólares |
| 14 | payments | Numérico | X | - | X | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. Solo se admiten los valores 2, 3 y 4. |
| 16 | originalDate | Numérico | - | - | - | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
| 24 | trxId | Numérico | X | X | X | Identificador de la transacción |
| 25 | dateTime | Numérico | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
| 26 | responseCode | Alfanumérico | X | X | X | Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24 |
| 27 | isoCode | Numérico | X | X | X | Código de Respuesta emitido por el centro autorizador. 3 dígitos como máximo. |
| 28 | responseMessage | Alfanumérico | X | X | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
| 71 | checkPendingString | Alfanumérico | - | - | - | Indica si VTOL debe o no efectuar el chequeo de pendientes: true = activa chequeo de pendientes. false = desactiva chequeo de pendientes. |
| 140 | paymentType | Alfanumérico | X | - | X | Tipo de pago. Valore posible 0: Tarjeta |
| 157 | customerDoc | Numérico | - | - | - | Número de documento del cliente que realiza la consulta. |
| 166 | trxReferenceNumber | Numérico | X | X | - | Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato |
| 268 | walletPosTrxId | Alfanumérico | - | - | - | Identificador único de la transacción de billetera para la compañía. Debe ser único por tipo de transacción. Es originado por el POS para realizar una compra o devolución con billetera. Formato: codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12) Longitud total de 32 Opcional en QueryWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra |
| 269 | walletType | Numérico | - | - | - | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago 5: Yacaré 6: Plus Pagos 8: Rappi Payless 10: GoCuotas |
| 270 | walletPosTicket | Alfanumérico | - | - | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket |
| 271 | walletPaymentId | Numérico | X | - | X | Identificador del número de pago informado por el Autorizador. |
| 273 | paymentStatus | Alfanumérico | X | - | X | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado 1: Devuelto 2: Pendiente 3: Autorizado 4: En Progreso 5: En mediacion 6: Rechazado 7: Cancelado 8: Contracargo 9: Reversado |
| 274 | paymentStatusDetail | - | - | X | Detalle del estado de la transacción de pago informado por el Autorizador | |
| 275 | cardType | Numérico | X | - | X | Tipo de tarjeta seleccionada al momento de efectuar el pago QR. |
| 416 | customerPhoneAreaCode | Numérico | - | - | - | Código de área de teléfono celular del cliente |
| 417 | customerPhone | Numérico | - | - | - | Teléfono celular del cliente |
| 418 | customerEmail | Alfanumérico | - | - | - | Mail del cliente |
...
Response from Full library: {1010:28082015003859;1028:Ok;1027:000} |
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
6.3 Autorización Aprobada
Para determinar que una autorización fue aprobada es necesario:
...
En este caso, si el valor de isoCode es igual a 00, 11 o 85 indica que la autorización ha sido Aprobada por VTOL Server y que debe capturarse el valor del campo 24 (lastTrxId) para ser enviado en el cierre de sesión:
24 | lastTrxId |
| Âncora | ||||
|---|---|---|---|---|
|
...
6.4 Integraciones para operar con tarjetas Contactless
| Aviso | ||
|---|---|---|
| ||
Únicamente se podrá operar con los siguientes Pinpad:
|
...
El sistema POS podrá integrar operaciones con tarjetas Contactless, de dos formas posibles:
...
6.4.1 Interacción única
Sólo existirá una única interacción entre el POS e EMVKit. Será la única manera de operar con tarjetas Contactless. Ver mensajería
...
- En caso de querer operar con Cashback, dicho monto debe enviarse sin conocer si la tarjeta lo tiene habilitado y sin conocer los límites permitidos.
- Si el POS no envía todos los campos de la operación en la primer interacción, EMVKit manejará doble interacción con el POS (flujo tradicional: lectura y procesamiento), pero no se podrá utilizar lectura Contactless.
...
6.4.2 Interacción doble con el POS
En los casos de doble interacción, el POS deberá enviar en la primer interacción el importe de la operación y pudiendo o no enviar el importe de cashback. Luego en la segunda interacción, el importe de la operación podrá ser modificado, debido a la aplicación de descuentos o intereses sobre cuotas.
...
| Nota | ||
|---|---|---|
| ||
En las transacciones con lectura Contactless con pinpad de First Data, EMVKit responderá al POS campos con información sobre la impresión de copia del cliente y la firma del cliente. Dichos campos son: clientCopyVoucher y requiresSignature clientCopyVoucher (Consulta por copia para cliente) Si el valor es "false", imprimir copia al cliente sin consultarlo. Si el valor es "true", consultar al cliente si quiere copia del voucher. requiresSignature (Solicita firma del cliente en el ticket) Si el valor es "false", no se deberá solicitar firma del cliente. Si el valor es "true", se deberá solicitar firma al cliente. El manejo de los resultado de estos campos, para la utilización de impresión de voucher por parte del pinpad de First Data, queda bajo responsabilidad del sistema de POS. |
| Âncora | ||||
|---|---|---|---|---|
|
...
7. Anexos
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
7.1 Códigos de Respuesta de EMVKIT
El código de respuesta de EMVKIT y su detalle se encuentran en los siguientes campos:
...
Código | Descripción | Significado |
UDF | INDEFINIDO | Corresponde al estado inicial de la variable de estado. La librería no debe devolver nunca este valor |
000 | (PINPAD) Aprobado | Operación satisfactoria |
001 | (PINPAD) Cancelado por el usuario | Se usó la tecla CANCEL del PINPAD |
002 | (PINPAD) Error ingreso 4 últimos dígitos | El PINPAD detectó errores en el ingreso de los últimos 4 dígitos |
003 | (PINPAD) Error de lectura Track2 | El PINPAD no pudo leer el Track II |
004 | (PINPAD) Error Pinpad-ingreso PIN | No se ingresó correctamente el PIN en el PINPAD |
005 | (PINPAD) Error Chip | El PINPAD no pudo leer o grabar en el CHIP |
006 | (PINPAD) Error Fecha inválida | Se ingresó un fecha inválida en el PINPAD |
007 | (PINPAD) Error TimeOut | El PINPAD suspendió la operación por TIMEOUT |
008 | (PINPAD) Error en secuencia de comando recibido | El PINPAD rechazó un comando por estar fuera de secuencia |
009 | (PINPAD) Error en formato de comando recibido | El PINPAD rechazó un comando por formato erróneo |
011 | (PINPAD) Error de LRC de comando recibido | El PINPAD rechazó un comando por LRC erróneo |
| 013 | (PINPAD) Error de lectura. Intente nuevamente | El PINPAD genera un error en la lectura de una tarjeta Chip. |
| 019 | (PINPAD) Error falta Master Key | El PINPAD informa que falta la master key. |
| 025 | (PINPAD) Error CTLS - Intente por chip | El PINPAD informa que no pudo leer por contactless. |
101 | A SESSION is already created. | No se puede crear una nueva sesión con EMVKIT, debido a que ya existe una sesión activa. Además en la respuesta se incluye el campo 1010 (currentSessionId) que es el identificador de la sesión actual. |
102 | Lib is processing requests. | EMVKIT se encuentra procesando un requerimiento. |
103 | Lib is processing response. | EMVKIT se encuentra procesando una respuesta a un requerimiento. |
104 | Lib is processing a reverse. | La librería se encuentra procesando un reverso. |
198 | Acción invalida | La librería suspendió la operación por que la acción que se requiere es no válida. |
199 | TimeOut | EMVKIT suspendió la operación por Timeout |
| 700 | No opera Offline | |
701 | (API) Archivo de Sesión no existe | No existe el archivo que contiene la información de sesión |
702 | (API) Existen Trxs Pendientes con VTOL Server | Existen Transacciones pendientes con VTOL que no se pueden cerrar |
703 | (API) Estado de Sesión no es válido | El estado de la sesión es inválido. |
704 | (API) Tipo de Transacción es invalido | El tipo de transacción enviado en la llamada no es válido |
705 | (API) Error enviando mensaje a VTOL Server | Error enviando autorización a VTOL Server |
706 | (API) Lista de VTOL TrxIds no recibida (Cierre de Sesión) | Lista de VTOL TrxIds no recibida en el Cierre de Sesión con acción CLOSE |
| 707 | Monto inválido | Cuando el monto off-line excede el límite configurado en el servidor. |
| 708 | Monto Cash Back inválido | Cuando el monto cashback excede el límite configurado en el servidor. |
| 711 | Error cancelando las transacciones. Existe una inconsistencia | Cuando no logra realizar un rollback sobre una transacción existente en la sesión. |
| 713 | Transaccion invalida | Cuando el dispositivo no soporta el tipo de transacción ingresado. |
| 718 | Modo de ingreso invalido | Cuando la lectura realizada por el PINPAD no es soportada por la versión de EMVKIT. |
| 719 | Error en impresion de voucher | Existió un error y el comprobante no se puede imprimir |
| 720 | No permite operar con la tarjeta ingresada | Cuando el tipo de transacción que se intenta realizar no soporta la tarjeta ingresada. |
| 721 | Transaccion no soporta cashback | Cuando el tipo de transacción que se intenta realizar no soporta cashback. |
| 722 | Falta de papel en dispositivo | El pinpad se queda sin papel y no se puede imprimir el voucher. |
| 723 | Excede el máximo de líneas permitido | El pinpad no puede imprimir el voucher genérico debido a que excede la cantidad de líneas permitidas. |
| 724 | Modo Ingreso Error | El PINPAD no permite el tipo de ingreso recibido. |
| 725 | Error en la configuracion del sistema | Cuando se requiere un cambio en la configuración del servidor. |
| 726 | No se encontro un dispositivo conectado | Cuando el dispositivo no se encuentra debidamente configurado. |
| 727 | Compañía inválida | Cuando la compañía informada no es válida, según lo configurado en el servidor. |
| 728 | No existe configuracion para la version requerida | Cuando la librería intenta obtener una versión de configuración que no existe en VTOL Server. Problemas de compatibilidad. |
| 729 | Reintente otro modo de ingreso | Cuando VTOL no tiene habilitado la encripción de datos sensibles, o cuando el prefijo no tiene habilitada la opción para que utilice mensaje encriptado. |
| 730 | Reintente operación sin modificar monto original | Cuando se modifica el monto o monto cashback en la operación de "Procesar operación con tarjeta". |
| 731 | Error en provider | Cuando el POS envía el ProviderPosCode, y EMVKIT detecta que no coincide con el valor de la configuración de los prefijos. |
801 | (API-PINPAD) PAN: Proveedor desconocido | La librería no pudo determinar el proveedor de una tarjeta |
802 | (API-PINPAD) PAN: Dígito verificador inválido | La librería encontró inválido el DV de una tarjeta |
803 | (AP-PINPADI) Error en protocolo con el PINPAD | La librería detectó un mensaje del PINPAD fuera de contexto |
804 | (API-PINPAD) Error de formato de mensaje del PINPAD | La librería detectó errores de formato en un mensaje del PINPAD |
805 | (API-PINPAD) Error en configuración de tarjetas | No se pudo identificar la tarjeta o la configuración es nula |
806 | (API-PINPAD) Error llave RSA invalida o nula | La librería no tiene llave RSA para trabajar. Se debe descargar de VTOL |
807 | (API-PINPAD) Error WK nula o formato invalido | La llave WorkingKey enviada por el POS tiene un formato inválido o es nula |
| 808 | Error cancelando operacion Tarjeta Chip. Intente anularla | Cuando una operación con tarjeta Chip no puede realizar un rollback de la operación. |
| 809 | Error en la sincronización del PinPad. | El PINPAD no puede completar el proceso de sincronización. |
| 810 | Error en sincronización del PinPad. Intente anular la operación. | El PINPAD no puede completar el proceso de sincronización porque tiene transacciones pendientes. Se recomienda un cierre forzoso. |
| 811 | Comando no soportado por el Pinpad | Cuando el dispositivo o la versión del mismo, no soporta el tipo de transacción ingresado. |
| 812 | Reintente operación | Cuando se realiza un cambio en la configuración del servidor sobre la llave RSA, y se aplican los cambios en EMVKIT. |
| 813 | No se permite la impresion de la corriente transaccion | El PINPAD o dispositivo no puede imprimir la transacción enviada por el POS. |
901 | (API) Error del sistema (general) | Error interno de la librería |
902 | (API) Error del sistema (I/O) | Error de entrada/salida o comunicación de la librería |
911 | (API) Error del sistema (carga) | Error al cargar la librería |
912 | (API) Error del sistema (contexto inexistente) | El POS envió un CARD_CONTEXT_ID inexistente |
913 | (API) Error del sistema (contexto inválido) | El POS envió un CARD_CONTEXT_ID inválido |
914 | (API) Error del sistema (carga working key) | Error leyendo o registrando las Claves de Trabajo<br>Interno de la librería |
999 | Error no manejado | Error no manejado |
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
7.2 Códigos de Respuesta de VTOL Server
La respuesta que el POS recibe de VTOL se encuentra en los siguientes campos:
...
Código | Descripción |
|---|---|
'00' | Aprobada |
'01' | Pedir autorización telefónica |
'02' | Pedir autorización |
'03' | Comercio inválido |
'04' | Capturar tarjeta |
'05' | Denegada |
'07' | Retenga y llame |
'11' | Aprobada |
'12' | Transacción inválida |
'13' | Monto inválido |
'14' | Tarjeta inválida |
'25' | No existe original |
'30' | Error en formato |
'38' | Excede ingreso de PIN |
'43' | Retener tarjeta |
'45' | No opera en cuotas |
'46' | Tarjeta no vigente |
'47' | PIN requerido |
'48' | Excede máximo de cuotas |
'49' | Error fecha de vencimiento |
'50' | Entrega supera límite |
'51' | Fondos insuficientes |
'53' | Cuenta inexistente |
'54' | Tarjeta vencida |
'55' | PIN incorrecto |
'56' | Tarjeta no habilitada |
'57' | Transacción no permitida |
'58' | Servicio inválido |
'61' | Excede límite |
'65' | Excede límite de tarjeta |
'76' | Llamar al emisor |
'77' | Error plan/cuotas |
'85' | Aprobada |
'86' | No envía fecha original |
'89' | Terminal inválida |
'91' | Emisor fuera de línea |
'94' | Número de secuencia duplicado |
'95' | Re-transmitiendo |
'96' | Error en sistema |
'98' | No aprobada |
'99' | Error no clasificado |
Modo de ingreso inválido | |
Proveedor inválido | |
Error CVC | |
Error creando mensaje | |
Tipo de mensaje inválido | |
No envía código de autorización | |
Error en fecha efectiva | |
Error en fecha vencimiento | |
Tarjeta no efectiva | |
No opera off-line | |
Devolución monto mayor | |
Original ya anulada | |
Original ya devuelta | |
Original reversada | |
Moneda inválida | |
No envía fecha | |
Campo 71 inválido | |
Campo 71 nulo | |
CVC inválido | |
Tarjeta inválida | |
Track2 inválido | |
No envía moneda | |
No envía CVC | |
Timeout | |
Fecha original inválida | |
No envía ticket original | |
Ticket original inválido | |
No envía código de autorización de venta referida | |
Reintente | |
Chiptokens Invalido | |
Pinpad R. Cod. Error | |
Pinpad A. Cod. Error |
| Âncora | ||||
|---|---|---|---|---|
|
...
7.2.1 Códigos de Respuesta de VTOL Server para PEI
A continuación se detallan las respuestas posibles de VTOL Server, cuando se opera con PEI, con una breve descripción de cada una:
Código | Descripción |
|---|---|
| 00 | APROBADA |
| 300 | Se agoto el tiempo de espera |
| 301 | La sucursal ingresada es incorrecta |
| 302 | El concepto ingresado es incorrecto |
| 303 | El concepto ingresado no esta disponible |
| 304 | El concepto ingresado no esta habilitado |
| 305 | La cuenta destino del pago es incorrecta |
| 306 | La cuenta destino no esta habilitada |
| 307 | La cuenta origen del pago es incorrecta |
| 308 | La cuenta origen no esta habilitada |
| 309 | La Red destino del pago es incorrecta |
| 310 | La cuenta del comercio es incorrecta |
| 311 | La cuenta de la sucursal es incorrecta |
| 312 | El comercio supero el importe máximo |
| 313 | La sucursal supero el importe máximo |
| 314 | La tarjeta ha superado el importe diario |
| 315 | Comercio ha superado el importe diario |
| 316 | Comercio ha superado el importe mensual |
| 317 | Comercio supero las trxs diarias |
| 318 | Comercio supero las trxs mensuales |
| 319 | La sucursal supero el importe diario |
| 320 | La sucursal supero el importe mensual |
| 321 | La sucursal supero las trxs diarias |
| 322 | La sucursal supero las trxs mensuales |
| 323 | Encriptacion incorrecta |
| 324 | El DNI no coincide con el de la tarjeta |
| 325 | Los datos de tarjeta no se condicen |
| 326 | El comercio es invalido |
| 327 | Cuenta destino del comercio es invalida |
| 328 | La tarjeta es invalida |
| 329 | La referencia de trx ya fue utilizada |
| 330 | El importe no es un numero mayor a cero |
| 331 | Ultimos 4 dig. no coinciden con la tarj. |
| 332 | Tarjeta inhabilitada para operar |
| 333 | Tarjeta vencida |
| 334 | Fondos insuficientes |
| 335 | El CBU Banelco ingresado es incorrecto |
| 336 | El ALIAS CBU Banelco es incorrecto |
| 337 | El id de pago es invalido |
| 338 | El id del canal es invalido |
| 339 | Importe excede saldo remanente del pago |
| 340 | El ID de requerimiento es invalido |
| 341 | IP de cliente invalida |
| 342 | Existe una devolucion aprobada del pago |
| 343 | El pago tiene devoluciones parciales |
| 344 | Pago no admite el tipo de devolucion |
| 345 | Pago no admite el tipo de devolucion |
| 346 | Terminal en uso |
| 347 | Terminal PEI Invalida |
| 348 | Comercio PEI Invalido |
| 349 | Sucursal PEI Invalida |
| 350 | Id operacion Requerido |
| 351 | Id operacion Rango invalido |
| 352 | Ultimos cuatro digitos invalidos |
| 353 | Numero de documento requerido |
| 354 | Trx original no se puede devolver |
| 355 | La cuenta es incorrecta |
| 356 | La cuenta no está habilitada |
| 357 | La cuenta del comercio es incorrecta |
| 358 | La cuenta de la sucursal es incorrecta |
| 359 | Comercio supero monto para concepto |
| 360 | Sucursal supero monto para concepto |
| 361 | Tarjeta supero monto tipo de operacion |
| 362 | Comercio supero monto tipo operacion |
| 363 | Comercio supero monto tipo operacion |
| 364 | Comercio supero cantidad transacciones |
| 365 | Comercio supero cantidad transacciones |
| 366 | Sucursal supero monto diario permitido |
| 367 | Sucursal supero monto mensual permitido |
| 368 | Sucursal supero cantidad trxs diarias |
| 369 | Sucursal supero cantidad trx mensuales |
| 370 | Error al desencriptar campos encriptados |
| 371 | La cuenta destino del comercio invalida |
| 372 | Ref de trx del comercio ya fue utilizada |
| 373 | Ultimos 4 digitos incorrectos |
| 374 | El ID de requerimiento enviado invalido |
| 375 | Error General |
| 376 | Concepto ingresado no habilitado |
| 377 | Concepto ingresado no habilitado |
| 378 | Cuenta es incorrecta |
| 379 | Cuenta no está habilitada |
| 380 | ALIAS CBU red Banelco es incorrecto |
| 381 | El pago tiene devoluciones parciales |
| 382 | Esta operacion no acepta devol. total |
| 383 | Esta operacion no acepta devol. parcial |
| 384 | La fecha es invalida |
| 385 | El estado del pago es invalido |
| 386 | El Concepto Operacion es invalido |
| 387 | Estado trx original no acepta devolucion |
| 388 | Importe devolucion supero monto limite |
| 389 | No se encontró la trx original |
| 390 | No es posible devolver una devolución |
| 391 | Error en comunicación |
| 392 | Campo DateTimeOriginalTrx invalido |
| 393 | Autorizacion Original en Proceso |
| 600 | El codigo de barras es requerido |
| 601 | El softToken es requerido |
| 602 | El importe de promoción es invalido |
| 603 | Original transaction type es requerido |
| 604 | El numero de referencia bancaria es requerido |
| 605 | El importe original informado es invalido |
| 606 | La venta original no tiene promoción aplicada |
| 607 | El numero de referencia bancaria es incorrecto |
| 608 | La venta original no permite promoción |
| 609 | Clave DNI inválido |
| 610 | Se agoto el tiempo de espera |
| 611 | Código de barras invalido |
| 612 | La referencia ingresada es inválida |
| 613 | El timestamp ingresado no respeta el formato |
| 614 | La cuenta origen no tiene tarjeta asociada |
| 615 | La cuenta origen de los fondos es inexistente |
| 616 | Cuenta origen sin fondos suficientes |
| 617 | La terminal ingresada es incorrecta |
| 618 | <Código para posibles nuevos errores de PEI - Link no manejados por VTOL> |
| Âncora | ||||
|---|---|---|---|---|
|
...
7.2.2 Códigos de Respuesta de VTOL Server para Billeteras Electrónicas
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:
| Código | Descripción |
|---|---|
| 00 | APROBADA |
| 500 | No se encuentra la transaccion original |
| 501 | El campo WalletPosTrxId es requerido |
| 502 | El campo WalletType es requerido |
| 503 | No esta configurado una Compañia MP |
| 504 | No esta configurado una Caja MP |
| 505 | El tipo de billetera es invalido |
| 506 | El campo WalletPaymentId es requerido |
| 507 | El campo OriginalDate es requerido |
| 508 | No es posible devolver una devolucion |
| 509 | Estado trx original no acepta devolucion |
| 510 | Importe devolucion supero monto limite |
| 511 | No se pudo realizar la orden de pago |
| 512 | La transaccion no posee estado |
| 513 | El campo posTicket es requerido |
| 514 | Tiempo expirado. Elija Consultar o Cancelar pago |
| 515 | Tiempo expirado confirmacion devolucion |
| 516 | Pago aun no realizado, desea seguir esperando? |
| 517 | Estado trx original no acepta devolucion |
| 518 | No se encuentra la devolucion |
| 519 | Acceso a MP no esta autorizado |
| 520 | Accion a MP no esta autorizada |
| 521 | El campo WalletPosTrxId es invalido |
| 522 | Cancelado |
| 523 | Estado trx original no acepta devolucion |
| 524 | Importe invalido para devolucion |
| 525 | Estado trx original no acepta devolucion |
| 526 | Compañia MP no permite operar |
| 527 | Numero devoluciones parciales superados |
| 528 | El pago es antiguo para ser devuelto |
| 529 | No es posible devolver una devolucion |
| 530 | Compañia MP sin dinero para devolver |
| 531 | Compañia MP sin dinero disponible |
| 532 | Estado trx original no acepta devolucion |
| 533 | Devolucion parcial no soportada |
| 534 | Url de notificacion invalido |
| 535 | El monto de la transaccion es invalido |
| 536 | Error general por parte de MP |
| 537 | No se encuentra la transaccion original |
| 538 | El campo WalletPosTrxId es requerido |
| 539 | Transaccion devuelta |
| 540 | Pendiente |
| 541 | Autorizado |
| 542 | En Progreso |
| 543 | En mediacion |
| 544 | Transaccion ya devuelta |
| 545 | Cancelado |
| 546 | Contracargo |
| 547 | No se encontró la trx original |
| 548 | Error en comunicación |
| 549 | No existe comunicación con Mercado Pago |
| 550 | Error al consultar venta original online |
| 552 | Orden no generada por Prisma |
| 553 | Pago Rechazado por parte de Prisma |
| 554 | Esta operación requiere autorización |
| 555 | Esta operación requiere autorización |
| 556 | Pago rechazado, reintente con otro medio de pago |
| 557 | Pago rechazado, reintente con otro medio de pago |
| 558 | Pago rechazado, reintente con otro medio de pago |
| 559 | Pago rechazado, reintente con otro medio de pago |
| 560 | Pago rechazado, reintente con otro medio de pago |
| 561 | No fue posible procesar su pago, intente más tarde |
| 562 | No fue posible procesar su pago, intente más tarde |
| 563 | No fue posible procesar su pago, intente más tarde |
| 564 | No fue posible procesar su pago, intente más tarde |
| 565 | No fue posible procesar su pago, intente más tarde |
| 566 | La cantidad de cuotas seleccionada es inválida |
| 567 | La cantidad de cuotas seleccionada es inválida |
| 568 | Tarjeta de crédito vencida |
| 569 | Tarjeta de crédito no habilitada |
| 570 | Fondos insuficientes, reintente otro medio de pago |
| 571 | Fondos insuficientes, reintente otro medio de pago |
| 572 | Datos incorrectos, revíselos y reintente |
| 573 | Datos incorrectos, revíselos y reintente |
| 574 | No fue posible procesar su pago, intente más tarde |
| 575 | No fue posible procesar su pago, intente más tarde |
| 576 | Tarjeta no vigente, reintente otro medio de pago |
| 577 | Esta operación requiere autorización |
| 578 | No fue posible procesar su pago, intente más tarde |
| 579 | No fue posible procesar su pago, intente más tarde |
| 580 | La cantidad de cuotas seleccionada es inválida |
| 581 | Datos incorrectos, revíselos y reintente |
| 582 | Datos incorrectos, revíselos y reintente |
| 583 | Las cuotas informadas son incorrectas |
| 584 | Devolucion parcial no soportada |
| 585 | Transacción con CashBack no permitido |
| 586 | El comercio informado es inválido |
| 587 | El establecimiento informado es inválido |
| 588 | El establecimiento no pertenece al comercio |
| 589 | El punto de venta informado es inválido |
| 590 | El punto de venta no pertenece al establecimiento |
| 591 | El tipo de documento es inválido |
| 592 | Se debe informar el ID de la operación |
| 593 | Se debe informar un timeStamp |
| 594 | Se debe informar el traceNumber |
| 595 | Intención de pago vencida |
| 596 | Entrega Excede Supera Limite |
| 598 | Las cuotas del pago ya fueron informadas |
| 602 | Devolución rechazada |
| 603 | Devolución no aprobada |
| 604 | Devolución pendiente de aprobación |
| 650 | Importe de devolución de cashout invalido |
| 651 | Importe de cashout invalido |
| 652 | Medio de pago inválido |
| 654 | Devolución registrada confirme administrativamente |
| 733 | La transacción no corresponde a una operación de Billeteras Electrónicas |
| 734 | No es posible cancelar la transacción informada |
...
7.2.2.1 Códigos de respuesta de VTOL Server para Billetera Rappi Payless
Código | Descripción |
|---|---|
Código | Descripción |
| 00 | APROBADA |
| 57 | TRANSACCION NO PERMITIDA |
| 500 | Sucursal no configurada Billetera RappiPayless |
| 503 | Compañia no configurada Billetera RappiPayless |
| 509 | Estado trx original no acepta devolucion |
| 510 | Importe devolucion supero monto limite |
| 533 | Devolucion parcial no soportada |
| 537 | Se excedio el tiempo limite para devolver |
| 539 | Devuelto |
| 544 | Transaccion ya devuelta |
| 545 | Cancelado |
| 549 | No existe comunicación con RappiPayless |
| 553 | Pago rechazado por diferencias en la orden |
| 585 | Transacción con CashBack no permitido |
| 586 | Imposible identificar el comercio. Verifique datos |
| 595 | Intención de pago vencida en Billetera |
| 599 | Error de validacion |
| 601 | No se pudo realizar la operación, reintente |
| 602 | Devolucion rechazada |
| 605 | La transaccion no se puede anular |
| 606 | Identificador de transaccion incorrecto |
| 607 | No se pudo realizar la devolucion |
| 611 | Código de barras invalido |
| 619 | No se pudo realizar la cancelación |
| 620 | Reintente pago por modo offline con código PIN |
...
7.2.2.2 Códigos de Respuesta de VTOL Server para QR Adquiriente Fiserv
Estos códigos de respuesta son exclusivos para QR Fiserv. El resto de los códigos coincide con las demás billeteras.
Código | Descripción |
|---|---|
| 654 | Valide monto y cuotas según tarjeta elegida |
| 655 | Cancelado, timeout QR |
| 656 | El provider informado no coincide con el pago |
...
7.2.3 Códigos de Respuesta de VTOL Server para Antifraude
A continuación se detallan las respuestas posibles de VTOL Server, cuando se opera con Antifraude:
Código | Descripción de respuesta al POS | Descripción del módulo antifraude |
|---|---|---|
| 801 | Tarjeta no autorizada | Fraude por validación de BlackList |
| 802 | Tarjeta no autorizada | Posible Fraude por BlackList |
| 803 | Operación no autorizada | Fraude por Velocity Check |
| 804 | Operación no autorizada | Posible fraude por Velocity Check |
| 805 | Operación no autorizada | Error en validación concurrente, posible fraude por Velocity Check |
| 806 | Operación no autorizada | Error en validación Velocity Check |
| 807 | Operación no autorizada | Error general en validación de Antifraude |
| 810 | Operación no autorizada | Faltan campos requeridos en el requerimiento |
| Âncora | ||||
|---|---|---|---|---|
|
...
7.2.4 Códigos de Respuesta de VTOL para Consulta de tarjetas de Fidelidad
A continuación se detallan las respuestas posibles de VTOL Server, cuando se realizan consultas de tarjetas de fidelidad:
Código | Descripción | Observaciones |
|---|---|---|
| 770 | Cliente no encontrado en servicio de fidelidad | El servicio de fidelidad respondió que el cliente no fue encontrado en su base de datos. |
| 771 | El cliente no está activo en servicio de fidelidad | El servicio de fidelidad respondió que el cliente no tiene ninguna tarjeta activa. |
| 772 | Error en el servicio de fidelidad | Cuando el servicio de fidelidad no está disponible o se vence el timeout. |
| 773 | Error de configuración en VTOL. | VTOL valida que se encuentre configurada la API Key del Comercio para consultar con Bimo, en las propiedades de configuración. Si no están configurados en VTOL Server, o si Bimo responde un error 400, VTOL retorna este mensaje al POS. |
| 774 | Es requerido el documento del cliente | El POS no envió el número de DNI del cliente. |
| 775 | Es requerido el tipo de tarjeta de fidelidad | El POS no envió el tipo de tarjeta de fidelidad del cliente. |
| 776 | El documento no es valido | El número de DNI enviado no tiene el formato correcto. |
| 777 | Tipo de tarjeta de fidelidad no válido. | El tipo de tarjeta de fidelidad enviado no está soportado. |
| 778 | Consulta no disponible para esta billetera | El tipo de consulta no es soportado por el tipo de billetera enviado por el POS en el campo WalletType. |
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
7.3 Códigos de Error del CORE de VTOL Server
Es posible que VTOL responda "Error" en el campo 26 del mensaje de respuesta. Este valor indica que se ha producido un error dentro del flujo inicial y principal del CORE de VTOL, previo al procesamiento de las reglas de negocio asociadas al tipo de transacción.
...
- Los campos 32 y 31 se responden por compatibilidad hacia atrás con otras implementaciones
- El campo 28 siempre posee la descripción del error
- El campo 27 siempre es "99"
- El campo 26 siempre dice "Error"
- El campo 25 es la hora del requerimiento
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
7.4 Formato Configuración POS
A continuación se detalla la información que viaja en el campo confData de un mensaje de solicitud de configuración, que se corresponde con la interface de configuración generada para el POS en VTOL Server.
...
Ejemplo:
BE:6006;6006;17;ASOCIADO;Pepe-123
BE:601056;601056;16;GIFT CARD;Extra
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
7.5 Circuito Operativo de EMVKIT
...
7.5.1 Flujo a Implementar
En este anexo se mencionará el flujo a implementar los tipos de operaciones soportadas por la Librería dependiendo el dispositivo de captura que posea la terminal:
...
| Nota |
|---|
Nota: La operación "Obtener Configuración de POS" se recomienda ejecutar por lo menos una vez a día: al inicio del día, tras efectuar un cierre de caja, etc. |
...
7.5.2 Procesamiento de Tarjetas de Empleados
A continuación se detalla la forma de procesarse una tarjeta de empleados con EMVKIT:
...
Response message: {1010:1527012912324;1027:000;1028:Ok}
...
7.5.3 Pagos Parciales
A continuación se muestra un diagrama de secuencia donde se explica la operatoria entre el POS, EMVKIT y el Pinpad.
...
Diagrama de secuencia de Pagos Parciales
| Âncora | ||||
|---|---|---|---|---|
|
...
7.6 Mecanismo de Autorización Telefónica
Cuando el centro autorizador responde a una operatoria de autorización con el mensaje "Autorización telefónica", EMVKIT de igual forma le envía un comando de requerimiento al pinpad.
...
| Aviso |
|---|
Importante: El punto de venta es el responsable de validar que tanto la primera transacción de venta como la segunda, en la que se informa el código de autorización, se trate de la misma operación de venta. Para EMVKIT, estas transacciones, se consideran como dos ventas individuales. |
| Âncora | ||||
|---|---|---|---|---|
|
...
7.7 Timeout de EMVKIT
Se recomienda que el punto de venta implemente un timeout con EMVKIT de 240 segundos (4 minutos) antes de cerrar la comunicación. Este estimativo se obtiene en base a un análisis de los valores de setup de fábrica del pinpad y considerando los peores escenarios de interacción entre el servidor, el usuario y el pinpad.
...
El valor de este parámetro indica cuánto tiempo espera EMVKIT para responder con un error de Timeout y no dejar al punto de venta esperando respuesta.
Por cada solicitud, se activa ese tiempo; y si no tiene una respuesta para enviar al punto de venta, cumplido ese tiempo, se enviará un mensaje de timeout.
Este valor en principio no debería subirse pues está calculado en base a los escenarios de sincronización y autorización.
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
7.8 Control Transaccional
El control transaccional permite que EMVKIT pueda decidir qué acción tomar transacción a transacción. Es decir, si debe confirmar o reversar cada transacción.
...
- La transacción se cae por tiempo expirado, el POS ejecuta un QueryWallet para consultar el estado.
- Apertura de sesión.
- SaleWallet
- Rta: Consulte pago por tiempo expirado - 24:trxid 7
- QueryWallet - 24:trxid 7 (transacción de la venta original)
- Rta: 27:516 28:Pago aún no realizado, desea seguir esperando? - 24:trxid 7
- QueryWallet - 24:trxid 7 (transacción de la venta original)
- Rta: Pago Aprobado - 24:trxid 7
- SaleWallet
- Cierre de sesión: Se cierra sesión en estado Close. En el campo 1009 (closeTrxIdList) se envían las operaciones aprobadas (iii). 1009:7
- Apertura de sesión.
El cliente confirma el pago desde la app de su celular, pero después le indica al cajero que quiere cancelar la operación.
create session
SaleWallet
Rta: Pago Aprobado - 24:trxid 8
QueryWallet - 24:trxid 8 (transacción de la venta original)
Rta: 27:00 28:Aprobada - 24:trxid 8
SI EL CLIENTE DECIDE CANCELAR LA COMPRA, EL POS DEBERÁ GENERAR UN refundWallet
CloseSession en estado CLOSE (1009:8). En el campo 1009 (closeTrxIdList) se envían las operaciones aprobadas (i).
...
7.9 Ejemplo de integración
A continuación se da un ejemplo de integración con EMVKit para poder realizar una venta con tarjeta presencial.
...
| Bloco de código |
|---|
using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Linq; using System.Text; using System.Windows.Forms; using VtolClientLib; namespace VtolTestPinPad { public partial class Form1 : Form { //Cliente Vtol StaticVtolClient StaticVtolClient = new StaticVtolClient(); //Lista de transacciones a confirmar System.Collections.ArrayList trxToConfirm = new System.Collections.ArrayList(); public EjemploIntegracion() { InitializeComponent(); } private VtolNode IniciarSesion() { //Inciar Sesion contra la libreria VTOL Full //Seleccionar el Local StaticVtolClient.SetParameter(VtolClientLib.VtolParam.StoreId, "6"); //Setear Parámateros StaticVtolClient.SetParameter(VtolClientLib.VtolParam.HostIp, "127.0.0.1"); StaticVtolClient.SetParameter(VtolClientLib.VtolParam.HostPort, 3500); StaticVtolClient.SetParameter(VtolParam.TimeOutConnectionHost, 30000); StaticVtolClient.SetParameter(VtolParam.ResponseTimeout, 10000); StaticVtolClient.SetParameter(VtolParam.TimeOutExpirationNode, 10000); StaticVtolClient.SetParameter(VtolParam.TimeOutObtainNode, 10000); StaticVtolClient.SetParameter(VtolParam.UseVtolClientFinder, false); StaticVtolClient.SetParameter(VtolParam.VtolClientFinder, new DefaultVtolClientFinder()); StaticVtolClient.SetParameter(VtolParam.UseEncryptedData, false); StaticVtolClient.SetParameter(VtolParam.Encrypter, "DESede"); StaticVtolClient.SetParameter(VtolParam.EncrypterKey, "SynthesisSynthesisSynthe"); //Iniciar libreria StaticVtolClient.Init(); //Crear un nuevo Nodo (Caja Existente en VTOL) VtolNode vtolNode = StaticVtolClient.CreateNode("1"); //Limpiar lista de transacciones a Confirmar trxToConfirm.Clear(); textBox1.Clear(); textBox1.AppendText("Iniciando Sesion \r\n"); vtolNode.Status = NodeStatus.INUSE; vtolNode.CreateTransaction(); vtolNode.AddField(11, "createSession"); vtolNode.SendTransaction(); //Obtener Respuesta String responseCodeString = vtolNode.GetField(1027).ToString(); if ("000".Equals(responseCodeString)) { textBox1.AppendText("Sesion creada \r\n"); } else { textBox1.AppendText("Error: " + vtolNode.GetField(1028).ToString() + " \r\n"); } //Retornar el nodo creado return vtolNode; } private void CerrarSesion(VtolNode vtolNode, String SessionAction, System.Collections.ArrayList trxList) { //Cerrar sesion vtolNode.CreateTransaction(); vtolNode.AddField(11, "closeSession"); textBox1.AppendText("Cerrando Sesion \r\n"); switch (SessionAction) { case "Close": //Cerrar y confirmar las transacciones pendientes //{Debug textBox1.AppendText("Enviando Commit"); //Recorrer el array para indicar las trx a informar foreach (String element in trxToConfirm) { textBox1.AppendText("trxID : " + element + "\r\n"); } //}Debug vtolNode.AddField(1008, "CLOSE"); vtolNode.AddField(1009, trxList); break; default: //Cerrar y enviar RollBack de todas las transacciones vtolNode.AddField(1008, "CANCEL"); break; } vtolNode.SendTransaction(); String responseCodeString = vtolNode.GetField(1027); if ("000".Equals(responseCodeString)) { textBox1.AppendText("Sesion Cerrada \r\n"); } else { textBox1.AppendText("Error al cerrar session [" + responseCodeString + "] "+ vtolNode.GetField(1028) +"\r\n"); } vtolNode.Status = NodeStatus.AVAILABLE; } private void btnSend_Click(object sender, EventArgs e) { textBox1.Clear(); //============================================================================================== //Iniciar sesion VtolNode vtolNode = IniciarSesion(); //============================================================================================== textBox1.AppendText("Enviando Compra \r\n"); vtolNode.CreateTransaction(); vtolNode.AddField(6, "5432219380000102"); //Tarjeta vtolNode.AddField(7, "1612"); //Vto vtolNode.AddField(8, "123"); //CVC vtolNode.AddField(10, "Manual"); //Mod. Ingreso vtolNode.AddField(11, "Sale"); //Operacion vtolNode.AddField(12, "100"); //Monto vtolNode.AddField(13, "$"); //Moneda vtolNode.AddField(14, "2"); //Cuotas vtolNode.AddField(15, "0"); //Plan //envia la trnsaccion. Es bloqueante hasta recibir la repsuesta o darse un timeout con el server vtolNode.SendTransaction(); string responseCodeString = vtolNode.GetField(FieldId.ResponseCodeFieldId); if (String.Compare(responseCodeString, "ISO8583", true) == 0) { String isoResponseCodeString = vtolNode.GetField(FieldId.ISOResponseCodeFieldId); if ("00".Equals(isoResponseCodeString)) { String transactionIdString = vtolNode.GetField(FieldId.TrxIdFieldId); trxToConfirm.Add(vtolNode.GetField(FieldId.TrxIdFieldId)); textBox1.AppendText("Aprobada trxID: "+ transactionIdString +"\r\n"); } else { textBox1.AppendText("Rechazada \r\n"); } } else { textBox1.AppendText("Error :"+ responseCodeString +" \r\n"); } //============================================================================================== textBox1.AppendText("Enviando Compra 2 \r\n"); vtolNode.CreateTransaction(); vtolNode.AddField(6, "5432219380000102"); //Tarjeta vtolNode.AddField(7, "1612"); //Vto vtolNode.AddField(8, "123"); //CVC vtolNode.AddField(10, "Manual"); //Mod. Ingreso vtolNode.AddField(11, "Sale"); //Operacion vtolNode.AddField(12, "200"); //Monto vtolNode.AddField(13, "$"); //Moneda vtolNode.AddField(14, "2"); //Cuotas vtolNode.AddField(15, "0"); //Plan //envia la trnsaccion. Es bloqueante hasta recibir la repsuesta o darse un timeout con el server vtolNode.SendTransaction(); responseCodeString = vtolNode.GetField(FieldId.ResponseCodeFieldId); if (String.Compare(responseCodeString, "ISO8583", true) == 0) { String isoResponseCodeString = vtolNode.GetField(FieldId.ISOResponseCodeFieldId); if ("00".Equals(isoResponseCodeString)) { String transactionIdString2 = vtolNode.GetField(FieldId.TrxIdFieldId); trxToConfirm.Add(vtolNode.GetField(FieldId.TrxIdFieldId)); textBox1.AppendText("Aprobada trxID: "+ transactionIdString2 +"\r\n"); } else { textBox1.AppendText("Rechazada \r\n"); } } else { textBox1.AppendText("Error :" + responseCodeString + " \r\n"); } //============================================================================================== //Cerrarr sesion CerrarSesion(vtolNode, "Close", trxToConfirm); } private void button1_Click(object sender, EventArgs e) { // ************** Prueba utilizando el pinpad ************************************** //****** Iniciar sesion ************ VtolNode vtolNode = IniciarSesion(); //****************************************************************************************************** //****************************************************************************************************** //Solicitar Lectura de Tarjeta textBox1.AppendText("Pase la Tarjeta por el PinPad \r\n"); vtolNode.CreateTransaction(); vtolNode.AddField(11, "Sale"); vtolNode.SendTransaction(); String responseCodeString = vtolNode.GetField(1027); //****************************************************************************************************** if ("000".Equals(responseCodeString)) { //Mostrar detalle de tarjeta Leida textBox1.AppendText("Lectura de Tarjeta "+ vtolNode.GetField(1028)+ " [" + vtolNode.GetField(1107) +"]\r\n"); //obtener datos necesarios String cardContextId = vtolNode.GetField(1103); vtolNode.CreateTransaction(); vtolNode.AddField(11, "Sale"); vtolNode.AddField(12, "100"); vtolNode.AddField(13, "$"); vtolNode.AddField(14, "2"); vtolNode.AddField(15, "0"); vtolNode.AddField(1103, cardContextId); vtolNode.SendTransaction(); responseCodeString = vtolNode.GetField(1027); if ("000".Equals(responseCodeString)) { //Obtener Respuesta responseCodeString = vtolNode.GetField(27); textBox1.AppendText("Respuesta: " + responseCodeString + "\r\n"); if (responseCodeString.Equals("ISO8583")) { //Obtener codigo ISO String ISOresponseCodeString = vtolNode.GetField(27); if ("00".Equals(ISOresponseCodeString)) { //Aprobada, guardar trxID trxToConfirm.Add(vtolNode.GetField(FieldId.TrxIdFieldId)); textBox1.AppendText("Aprobada trxID: " + vtolNode.GetField(FieldId.TrxIdFieldId) + "\r\n"); } } else { textBox1.AppendText("Error " + vtolNode.GetField(28) + "\r\n"); } } else { textBox1.AppendText("Error " + vtolNode.GetField(1028) + "\r\n"); } } //****** Cerrar sesion ************* CerrarSesion(vtolNode, "CLOSE", trxToConfirm); //********************************** } } } |
...
7.10 Vouchers
En este anexo se mencionan los datos de los vouchers o comprobantes a tener en cuenta en base al canal por el cual se autorizó la tarjeta (34 - hostName), la tarjeta y el tipo de transacción. También se especifica el campo de EMV Kit correspondiente para lograr obtener dicha información.
...
| Nota |
|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
7.11 Códigos de Bancos
A continuación se detallan los ID de los bancos dispuestos por el BCRA.
| ID de Banco | Descripción |
|---|---|
| 7 | BANCO DE GALICIA Y BUENOS AIRES S.A.U. |
| 11 | BANCO DE LA NACION ARGENTINA |
| 14 | BANCO DE LA PROVINCIA DE BUENOS AIRES |
| 15 | INDUSTRIAL AND COMMERCIAL BANK OF CHINA |
| 16 | CITIBANK N.A. |
| 17 | BANCO BBVA ARGENTINA S.A. |
| 20 | BANCO DE LA PROVINCIA DE CORDOBA S.A. |
| 27 | BANCO SUPERVIELLE S.A. |
| 29 | BANCO DE LA CIUDAD DE BUENOS AIRES |
| 34 | BANCO PATAGONIA S.A. |
| 44 | BANCO HIPOTECARIO S.A. |
| 45 | BANCO DE SAN JUAN S.A. |
| 65 | BANCO MUNICIPAL DE ROSARIO |
| 72 | BANCO SANTANDER RIO S.A. |
| 83 | BANCO DEL CHUBUT S.A. |
| 86 | BANCO DE SANTA CRUZ S.A. |
| 93 | BANCO DE LA PAMPA SOCIEDAD DE ECONOMÍA M |
| 94 | BANCO DE CORRIENTES S.A. |
| 97 | BANCO PROVINCIA DEL NEUQUÉN SOCIEDAD ANÓ |
| 143 | BRUBANK S.A.U. |
| 147 | BANCO INTERFINANZAS S.A. |
| 150 | HSBC BANK ARGENTINA S.A. |
| 165 | JPMORGAN CHASE BANK, NATIONAL ASSOCIATIO |
| 191 | BANCO CREDICOOP COOPERATIVO LIMITADO |
| 198 | BANCO DE VALORES S.A. |
| 247 | BANCO ROELA S.A. |
| 254 | BANCO MARIVA S.A. |
| 259 | BANCO ITAU ARGENTINA S.A. |
| 262 | BANK OF AMERICA, NATIONAL ASSOCIATION |
| 266 | BNP PARIBAS |
| 268 | BANCO PROVINCIA DE TIERRA DEL FUEGO |
| 269 | BANCO DE LA REPUBLICA ORIENTAL DEL URUGU |
| 277 | BANCO SAENZ S.A. |
| 281 | BANCO MERIDIAN S.A. |
| 285 | BANCO MACRO S.A. |
| 299 | BANCO COMAFI SOCIEDAD ANONIMA |
| 300 | BANCO DE INVERSION Y COMERCIO EXTERIOR S |
| 301 | BANCO PIANO S.A. |
| 305 | BANCO JULIO SOCIEDAD ANONIMA |
| 309 | BANCO RIOJA SOCIEDAD ANONIMA UNIPERSONAL |
| 310 | BANCO DEL SOL S.A. |
| 311 | NUEVO BANCO DEL CHACO S. A. |
| 312 | BANCO VOII S.A. |
| 315 | BANCO DE FORMOSA S.A. |
| 319 | BANCO CMF S.A. |
| 321 | BANCO DE SANTIAGO DEL ESTERO S.A. |
| 322 | BANCO INDUSTRIAL S.A. |
| 330 | NUEVO BANCO DE SANTA FE SOCIEDAD ANONIMA |
| 331 | BANCO CETELEM ARGENTINA S.A. |
| 332 | BANCO DE SERVICIOS FINANCIEROS S.A. |
| 336 | BANCO BRADESCO ARGENTINA S.A.U. |
| 338 | BANCO DE SERVICIOS Y TRANSACCIONES S.A. |
| 339 | RCI BANQUE S.A. |
| 340 | BACS BANCO DE CREDITO Y SECURITIZACION S |
| 341 | BANCO MASVENTAS S.A. |
| 384 | WILOBANK S.A. |
| 386 | NUEVO BANCO DE ENTRE RÍOS S.A. |
| 389 | BANCO COLUMBIA S.A. |
| 426 | BANCO BICA S.A. |
| 431 | BANCO COINAG S.A. |
| 432 | BANCO DE COMERCIO S.A. |
| 435 | BANCO SUCREDITO REGIONAL S.A.U. |
...
7.
...
12 Respuesta de EMVKIT en Rechazo Z3
Cambios incorporados en EMVKIT en situaciones de rechazo en tercera instancia:
...
VTOL=00 / CRE=(vacio) >> 99 - PINPAD RECHAZADA - Mensaje de EMVKIT al POS "PINPAD RECHAZADA" (código 99)
...
8. Compatibilidad con VTOL Server
La versión 1.5.X de EMVKit y superior tendrá compatibilidad con VTOL Server para rutear las transacciones, según las siguientes variantes:
- EMVKit 1.5 con VTOL Server 3.8.0.5
- Compatibilidad: Se puede realizar el ruteo de transacciones por local, según la configuración que se establezca en VTOL Server.
- Compatibilidad: Se puede realizar el ruteo de transacciones por local, según la configuración que se establezca en VTOL Server.
- EMVKit 1.5 con VTOL Server 3.8.0.4
- Compatibilidad: Estas versiones no son compatibles, por lo cual no se podrá transaccionar. VTOL Server no va a tener los datos de configuración que permitan que EMVKIT haga el ruteo de transacciones. En este escenario, se deberá actualizar VTOL Server a una versión superior, por ejemplo la 3.8.0.5.
- Compatibilidad: Estas versiones no son compatibles, por lo cual no se podrá transaccionar. VTOL Server no va a tener los datos de configuración que permitan que EMVKIT haga el ruteo de transacciones. En este escenario, se deberá actualizar VTOL Server a una versión superior, por ejemplo la 3.8.0.5.
- EMVKit 1.4 con VTOL Server 3.8.0.5
- Compatibilidad: no va a ser posible rutear las transacciones por local. La posición de la llave maestra mantendrá la configuración definida en los prefijos del server anterior a la actualización, por ejemplo de la 3.8.0.4 a la 3.8.0.5.
...
9. Compatibilidad con Firmware
En el siguiente apartado se detallan las funcionalidades disponibles según cada versión de firmware disponible.
...