Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Painel
borderColor#E4E3E3
bgColor#ffffff
titleColor#ffffff
borderWidth1px
titleBGColor#704581
titleREVISIONES


Expandir
titleExpandir revisiones


Fecha

Revisión

Cambios – Motivo

06/01/2014

1.0

Creación del documento

17/08/2015

1.1

Definición de librería como servicio. Explicación de integración

23/10/2015

1.2

Agregado de Operación Procesar Mensaje Crédito Débito. Incorporación de identificador único de transacción en VTOL Server, campo: 166-trxReferenceNumber

09/11/2015

1.3

Agregado de campo 1102–Proveedor seleccionado en mensaje Procesar Operación con Tarjeta

13/05/2016

1.4

Agregado de campo 137–ConfVersion en GetConfiguration, 10–inputMode en Sale/VoidSale/Etc y 1010–currentSessionId en el mensaje Crear sesión

16/05/2016

1.5

Revisión del documento

06/06/2016

1.6

Agregado del valor FORCED_CLOSE en el campo 1008–closeSessionAction del mensaje Cerrar Sesión

14/07/2016

1.7

Agregados los tipos de transacciones ServicePayment y VoidServicePayment

18/08/2016

1.8

Agregado del anexo "Mecanismo de Autorización Telefónica"

15/09/2016

1.9

Agregado de campo 57 - Tipo de Cuenta en la respuesta al POS para el procesamiento de operación con tarjeta.

19/09/2016

1.10

Se modifica la condición del campo 1113 – cardIsDebit.

21/09/2016

1.11

Posibilidad de recibir desde el POS, el valor que indica la capacidad de captura de la terminal.

23/09/2016

1.12

Agregado del tipo de operación "Cancelar Lectura de Tarjeta"

06/10/2016

1.13

Se incorpora definición de timeout de EMVKIT.
Se eliminan los campos: Store y Node de los mensajes: Leer Datos de la Tarjeta - Cancelar Lectura de Tarjeta - Procesar Operación con Tarjeta - Procesar Mensaje Crédito Debito - Obtener Configuración de POS - Cerrar Sesión

05/04/2017

1.14

Agregado de propiedad approveInSecondInstance en sección de Configuración de PINPAD

16/05/2017

1.15

Modificación del apartado Mecanismo de Autorización Telefónica

17/05/2017

1.16

Agregado del valor MSR Chip en campo inputMode

30/05/2017

1.17

Agregado del apartado "Circuito Operativo de la EMVKIT"

06/06/2017

1.18

Actualización de la tabla Prefijo en el apartado Formato Interface POS. Mayor detalle del campo MasterKey Position, incluyendo el valor 99

07/07/2017

1.19

Agregado del campo promocional en Configuración de POS para indicar que se aplica una promoción sobre un plan de pago

20/07/2017

1.20

Incorporación del campo opcional 1025 – transactionalControl en la operación "Crear Sesión"
Incorporación de campo 24 - lastTrxId en operación "Leer Datos de la Tarjeta"
Agregado del anexo "Control Transaccional"

27/07/2017

1.21

Modificación del apartado "Pre requisitos"
Incorporación del apartado "Configuración de enlace con VTOL"

02/08/2017

1.22

Agregación de campo 22 – authorizationCode en el requerimiento de la operación "Leer Datos de la Tarjeta"
Eliminación de campo 22 – authorizationCode en el requerimiento de la operación "Procesar Operación con Tarjeta"

06/10/2017

1.23

Actualización de la estructura y numeración del documento
Agregación del campo dateTime como valor requerido en los requerimientos de "Procesar Operación con Tarjeta" y "Procesar Mensaje Crédito Débito"
Actualización del anexo "Timeout de la EMVKIT"

14/11/2017

1.24

Incorporación del apartado "Instalación"
Actualización del apartado "Configuración"

01/02/2018

1.25

Aclaración sobre requerimiento de software

23/04/20181.26

Revisión general del documento.

Agregado de apartado Pagos Parciales.

13/06/20181.27Agregado de procesamiento de tarjetas de empleados
12/07/20181.28Agregado de campos 6 - cardNumber, 9 - track2, 66 - track1 y 145 - exceptionBinName en la respuesta de la operación "Procesar Operación con Tarjeta"
06/08/20181.29Incorporación de la funcionalidad PEI en la mensajería
17/08/20181.30Agregado de campo 1104 - prefixesList en la respuesta de la operación "Leer Datos de la Tarjeta"
14/01/20191.31Incorporación de las funcionalidades de impresión de vouchers en la mensajería
25/01/20191.32

Incorporación de la mensajería PEI en las operatorias de "Leer datos de Tarjeta" y "Procesar Operación con Tarjeta"

Incorporación de la mensajería QueryPEI con PinPad

15/02/20191.33Incorporación de la funcionalidad Billeteras Electrónicas QR (Mercado Pago y Todo Pago)
03/04/20191.34Agregado del campo 0 (compañía) en todos los tipos de transacciones.
17/05/20191.35Incorporación de la funcionalidad Cuenta DNI y Promociones PEI.
20/05/20191.36Incorporación de apartado de compatibilidad con VTOL Server.
02/08/20191.37Incorporación de funcionalidad de Billeteras electrónicas con manejo de cuotas.
08/08/20191.38Incorporación de funcionalidad Contactless con pinpad de First Data.
09/08/20191.39Incorporación de apartado para integrar operaciones con tarjetas Contactless.
24/10/20191.40Agregado del campo 1138 (emvData) en la operatoria "Procesar Operación con Tarjeta". Los datos de este campo retornan al POS para ser impresos en el ticket.
25/11/20191.41Agregado de anexo 6.10 Vouchers con la especificación de los campos de los comprobantes según los Autorizadores
27/12/20191.42Actualización del apartado Procedimiento de Instalación
06/01/20201.43Incorporación de funcionalidad Contactless con pinpad de Prisma.
10/03/20201.44Incorporación de mensaje de Sincronización de transacciones entre EMVKit y el POS.
29/04/20201.45Incorporación de la carpeta doc a la instalación
30/07/20201.46Incorporación de funcionalidad de Billeteras Mercado Pago con retiro de efectivo.
22/09/20201.47Se actualiza el campo 54 (additionalAmount) como tipo de dato Importe, en la mensajería de Billeteras electrónicas.
26/11/20201.48Agregado del campo Descripción en Configuración de POS para indicar la descripción sobre un plan de pago.
11/12/20201.49Incorporación de funcionalidad QR Adquiriente.
16/12/20201.50Incorporación del campo afApplicationCondition para validar la aplicación de reglas antifraudes por el módulo AF de VTOL.
05/03/20211.51Se actualiza el nombre y la descripción del campo 406 en la respuesta de la mensajería de QR Adquiriente.
13/04/20211.52Incorporación de mensaje para Consultar Bines de Excepción
05/05/20211.53Incorporación de mensaje para Consultar tarjetas de Fidelidad
11/05/20211.54Se quitan las referencias de la billetera Todo Pago, ya que dicha Billetera está incluida dentro de la funcionalidad "QR Adquiriente Prisma".
19/05/20211.55Incorporación de mensajería para Billetera Yacaré. Se incluye dentro del apartado "J. Procesar mensaje Billeteras Electrónicas"
24/06/20211.56Incorporación de Operaciones Contactless con doble interacción.
23/08/20211.57En Billetera QR Adquiriente, en el campo WalletType se diferencian por id las billeteras Bimo, Modo y Todo Pago. Incorporación disponible a partir de la versión 3.8.0.12b de VTOL Server.
01/10/20211.58Incorporación de mensajería para Billetera Plus Pagos. Se incluye dentro del apartado "J. Procesar mensaje Billeteras Electrónicas"
25/01/20221.59Incorporación de mensajería para QR Adquiriente Fiserv. Se incluye dentro del apartado "P. Procesar mensaje QR Adquiriente Fiserv".
03/03/20221.60Incorporación de mensajería para Operaciones con PayStore. Se incluye dentro del apartado "T. Procesar mensaje PayStore".
16/03/20221.61Agregado del campo Marca de tarjeta en el "Formato Configuración POS", dentro de la tabla "Provider".
06/05/20221.62

Incorporación de mensajería para Billetera Rappi Payless. Se incluye dentro del apartado "J. Procesar mensaje Billeteras Electrónicas"

11/11/20221.63

Incorporación de mensajería para Operaciones con Ationet. Se incluye el apartado "U. Procesar mensaje Ationet"

3/11/20231.64

Agregado de los campos PaymentToDisplay y PaymentDescripción en Configuración de POS para indicar las opciones de pago que posee una descripción diferente a la cuota real.

04/12/20231.65

Cambios incorporados en EMVKIT en situaciones de rechazo en tercera instancia.

03/01/2024 

1.7

Incorporación de mensajería para operaciones con la Billetera GoCuotas. Se incluye el apartado "V". Procesar mensaje con GOCuotas"



...

Código

Nombre del campo

Tipo de dato

SaleWallet

QueryWallet (1)

QueryWallet (2)

Descripción

1

store

Alfanumérico

XXX

Identificador del sitio originador de la transacción

2

node

Numérico

XXX

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:

  • 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

-X-

Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR.

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

XXX

Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales.

13

currencyPosCode 

Alfanumérico

XXX

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

16

originalDate

 Numérico

---

Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD

24

trxId

Numérico

XXX

Identificador de la transacción

25

dateTime

Numérico

XXX

Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS

26

responseCode

Alfanumérico

XXX

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

XXX

Código de Respuesta emitido por el centro autorizador. 3 dígitos como máximo.

28

responseMessage

Alfanumérico

XXX

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

Numérico

XXX

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

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

XX

Identificador del número de pago informado por el Autorizador.

273

paymentStatus

Alfanumérico

X

XX

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

Alfanumérico

-

XX

Detalle del estado de la transacción de pago informado por el Autorizador

275

cardType

Numérico

X

XX

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

XXX

Identificador de la sesión que se cierra

1027

libResponseCode

Numérico

XXX

Código de respuesta de la librería.
Indica cómo fue procesada la operación en EMVKIT:
Éxito = 000
Error <> 000
Ver sección Códigos de Respuesta de Librería

1028

libResponseMessage

Alfanumérico

XXX

Mensaje descriptivo del código de respuesta de la librería

...

CódigoNombre del campoTipo de datoRefundWalletDescripción
1storeAlfanuméricoXIdentificador del sitio originador de la transacción
2nodeNuméricoXIdentificación del nodo, en el sitio originador, donde se generó la transacción
3serverAlfanuméricoXIdentificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL')
4messageTypeAlfanuméricoX

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.

6cardNumberNumé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.
7expirationNumé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.
8cvcNumé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.
11trxTypeAlfanuméricoX

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

12ammountImporteXMonto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales.
13currencyPosCode AlfanuméricoX

Tipos de moneda:

$ = Pesos

U$S = Dólares

14paymentsNuméricoXCantidad de cuotas seleccionadas al momento de realizar el pago QR
16originalDate Numérico-Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD
24trxIdNuméricoXIdentificador de la transacción
25dateTimeNuméricoXFecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
71checkPendingStringAlfanuméricoX

Indica si VTOL debe o no efectuar el chequeo de pendientes:

true = activa chequeo de pendientes.

false = desactiva chequeo de pendientes.

157customerDocNumérico-Número de documento del cliente que realiza la consulta.
268walletPosTrxIdAlfanuméricoX

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

269walletTypeNuméricoX

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

270walletPosTicketAlfanuméricoInformación del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket.
271walletPaymentId NuméricoXIdentificador del número de pago informado por el Autorizador.
416customerPhoneAreaCodeNumérico-Código de área de teléfono celular del cliente
417customerPhoneNumérico-Teléfono celular del cliente 
418customerEmail Alfanumérico-Mail del cliente



    • Response VTOL - POS

...

CódigoNombre del campoTipo de datoSaleWalletRefundWalletQueryWalletDescripción
1storeAlfanuméricoXXXIdentificador del sitio originador de la transacción
2nodeNuméricoXXXIdentificación del nodo, en el sitio originador, donde se generó la transacción
3serverAlfanumérico---Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL')
4messageTypeAlfanumé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.

11trxTypeAlfanumé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

12ammountImporteX-XMonto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales.
13currencyPosCode AlfanuméricoX-X

Tipos de moneda:

$ = Pesos

$S = Dólares

14paymentsNuméricoX-XCantidad de cuotas seleccionadas al momento de realizar el pago QR
16originalDate Numérico---Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD
24trxIdNuméricoXXXIdentificador de la transacción
25dateTimeNuméricoXXXFecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
26responseCodeAlfanuméricoXXX

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

27isoCode NuméricoXXXCódigo de Respuesta emitido por el centro autorizador. 3 dígitos como máximo.
28responseMessageAlfanuméricoXXXMensaje de la Respuesta relacionado con el código del campo 27
71checkPendingStringAlfanumérico---

Indica si VTOL debe o no efectuar el chequeo de pendientes:

true = activa chequeo de pendientes.

false = desactiva chequeo de pendientes.

140paymentTypeAlfanuméricoX-XTipo de pago. Valore posible 0: Tarjeta
157customerDocNumérico---Número de documento del cliente que realiza la consulta.
166trxReferenceNumberNuméricoXX-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
268walletPosTrxIdAlfanumé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

269walletTypeNumé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

270walletPosTicketAlfanumérico---Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura posTicket
271walletPaymentId NuméricoX-XIdentificador del número de pago informado por el Autorizador.
273paymentStatusAlfanuméricoX-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

274paymentStatusDetail
--XDetalle del estado de la transacción de pago informado por el Autorizador
275cardTypeNuméricoX-XTipo de tarjeta seleccionada al momento de efectuar el pago QR.
416customerPhoneAreaCodeNumérico---Código de área de teléfono celular del cliente
417customerPhoneNumérico---Teléfono celular del cliente 
418customerEmail Alfanumérico---Mail del cliente

...