Versões comparadas

Chave

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


Image Added

VTOL EMVKIT AR 1.11.X - Prisma QR Grandes Cuentas



Contenido

Índice


Revisiones

...

Número

Nombre del campo

Tipo de dato

SaleWallet

Descripción

0companyNuméricoM

Identificador de la compañía donde se generó la transacción. Exclusivo para mensajería POS-VTOL.

1storeAlfanuméricoM

Identificador del local donde se generó la transacción. Exclusivo para mensajería POS-VTOL.

2nodeNuméricoM

Identificador de la caja donde se generó la transacción. Exclusivo para mensajería POS-VTOL.

3serverAlfanuméricoM

Identificador del Server que procesará la transacción, en el caso de VTOL será "VTOL". Exclusivo para mensajería POS-VTOL.

4messageTypeAlfanuméricoM

Indica el 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.

Exclusivo para mensajería POS-VTOL.

11trxTypeAlfanuméricoM

Indica el tipo de transacción:

  • SaleWallet = Compra con billetera electrónica.
12amountNuméricoMMonto de la transacción. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales. Ejemplo: "1000" equivale a "10.00".
13currencyPosCodeAlfanuméricoM

Tipos de moneda: $ = Pesos

24

lastTrxId

NuméricoOEn este campo el POS debe enviar la última transacción procesada correctamente. Se utiliza si está activo el control transaccional.
25dateTimeNuméricoMFecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
268walletPosTrxIdAlfanuméricoM

Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra con billetera.

Formato:
codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12)
Longitud total de 32.

Opcional en QuerySaleWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra.

269walletTypeNuméricoM

Tipo de billetera por la cual se realizará la transacción en el POS. La opción corresponde a 3: MODO. 

270walletPosTicketAlfanuméricoM

Información del ticket en formato xml y posteriormente transformado en Base 64.

401

walletPaymentMethod

Formato JsonO

Información de los planes de pago en formato Json codificado en Base 64. La estructura de este campo está definida en la siguiente sección del documento.

Importante: en este MENSAJE sólo se envía el valor "TR" que corresponde a pago con transferencia 3.0. Se envía solo si el comercio opera con Transferencia 3.0 sino no se envía.

...

Request SaleWallet (log emvkit):

Request:

{270:PG1lc3NhZ2UgY29tcGFueUlkPSJzdHMiIHN0b3JlPSIwMDAwMSIgdGVybWluYWw9IjAxMCIgZGF0
ZS10aW1lPSIyMDE3LTEyLTA0IDEyOjMwOjAwOiIgbWVzc2FnZUlkPSIwMDEwIiB2b2lkLXRyeD0i
ZmFsc2UiIHJlc3BvbnNlPSJ0cnVlIiBpbml0LXRjaz0idHJ1ZSIgZXZhbHVhdGU9InRydWUiIHN0
YXR1cz0icGF5bWVudCIgbXNnLXZlcnNpb249IjIuMCIgbWFwLXZlcnNpb249IjE1Ij4KCTxpdGVt
LWFkZCBzZXE9IjEiIGNvZGU9IjAwMDEiIGRpc2NvdW50YWJsZT0idHJ1ZSIgdW5pdHByaWNlPSIyLWFkZCBzZXE9IjEiIGNvZGU9IjAwMDEiIGRpc2NvdW50YWJsZT0idHJ1ZSIgdW5pdHByaWNlPSIx
Mi4wIiBxdHk9IjEuMCIgbGV2ZWwxPSJNRU4iIGxldmVsMj0iQ0FTVUFMIiBzdXBwbGllcj0iIiBiNDAwLjAiIHF0eT0iMS4wIiBsZXZlbDE9Ik1FTiIgbGV2ZWwyPSJDQVNVQUwiIHN1cHBsaWVyPSIi
cmFuZD0iTEVWSVMiIHhwcmljZT0iNDAuMCIgbWFnbml0dWRlPSIxLjAiIGRlc2NyaXB0aW9uPSJKIGJyYW5kPSJMRVZJUyIgeHByaWNlPSIxNDAwLjAiIG1hZ25pdHVkZT0iMS4wIiBkZXNjcmlwdGlv
ZWFuIGNhc3VhbCIgY3VycmVuY3k9IiQiIC8+Cgk8aXRlbS1hZGQgc2VxPSIyIiBjb2RlPSIwMDAy
IiBkaXNjb3VudGFibGU9InRydWUiIHVuaXRwcmljZT0iMTUuNSIgcXR5PSIyLjAiIGxldmVsMT0i
TUVOIiBsZXZlbDI9IkNBU1VBTCIgc3VwcGxpZXI9IiIgYnJhbmQ9IkxFVklTIiB4cHJpY2U9IjIw
LjUiIG1hZ25pdHVkZT0iMS4wIiBkZXNjcmlwdGlvbj0iSmVhbiBjYXN1YWwiIGN1cnJlbmN5PSIk
IiAvPgo8L21lc3NhZ2U+bj0iSmVhbiBjYXN1YWwiIGN1cnJlbmN5PSIkIiAvPgo8L21lc3NhZ2U+Cg==;269:3;268:00000000010000000001202444110144420000000015000007048620251415041408;14:0;13:$;12:5300140000;11:SaleWallet;1410:true;2:1;25:20240611134442;1:1}

    • Response VTOL - POS

Número

Nombre del

401:[{"providerPosCode"\:"TR"\,"installments"\:[{"quantity"\:"1"\,"amountPerInstallment"\:140000\,"totalAmount"\:140000\,"surcharge"\:0\,"nominalAnnualRate"\:"0"}]}];1410:true;2:70486;25:20250415161408;1:15}



    • Response VTOL - POS

Número

Nombre del campo

Tipo de dato

SaleWallet

Descripción

0companyNuméricoMIdentificador de la compañía donde se generó la transacción
1storeAlfanuméricoMIdentificador del sitio originador de la transacción
2nodeNuméricoMIdentificación del nodo, en el sitio originador, donde se generó la transacción.
12amountImporteM

Contiene el Importe que pagó el cliente, el cual puede variar si pagó con intereses o se aplicó algún descuento. Valor entero. Los últimos 2 dígitos corresponden a los decimales.

13currencyPosCodeAlfanuméricoM

Tipos de moneda: $ = Pesos

14paymentsNuméricoM

Cantidad de cuotas seleccionada al momento de realizar el pago QR.

Nota: este campo deberá tener el valor 1 si el pago se realiza con transferencia 3.0 (pago con saldo en cuota). Si el pago se realiza con tarjeta puede tomar otro valor.

22authorizationCodeAlfanuméricoO

Código de autorización informado por el Autorizador

24trxIdNuméricoMIdentificador de la transacción.

25

dateTime

Numérico

M

Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción

26

responseCode

Alfanumérico

M

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

M

Código de Respuesta emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

Nota: Se envía en este campo el código 542.

28

responseMessage

Alfanumérico

M

Mensaje de la respuesta relacionado con el código del campo 27.

Nota: Se envía en este campo el mensaje "Esperando medios de pago del autorizador" que corresponde al código 542 enviado en el campo 27 de la mensajería de VTOL al POS

29

serialNumber

Numérico

O

Número identificatorio de la terminal en la que se procesó la transacción. Retorna en operaciones aprobadas.

31

lotNumber

Numérico

O

Número de lote en el que se registró la transacción

32

ticket

Numérico

O

Número de Ticket correspondiente a la transacción. 4 dígitos como máximo.

54additionalAmount

Importe

OContiene el Importe del "Cashout". Aplica para las operaciones realizadas con retiro de efectivo. Valor entero. Los últimos 2 dígitos corresponden a los decimales.

140

paymentTypeNuméricoM

Tipo de pago. Valores posibles:

0: Tarjeta
1: Efectivo

157customerDocNuméricoONumero de documento del titular de la tarjeta.
166trxReferenceNumberNuméricoMIdentificador ú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

271

walletPaymentId

Alfanumérico

MIdentificador del número de pago informado por el Autorizador
272amountRefundedImporte-Monto devuelto en la transacción
273paymentStatusAlfanuméricoO

Estado de la transacción de pago informado por el Autorizador. Estados posibles:

0: Aprobado
1: Devuelto
2: Pendiente
3: Autorizado
4: En Progreso
6: Rechazado
7: Cancelado
8: Contracargo

274paymentStatusDetailAlfanuméricoODetalle del estado de la transacción de pago informado por el Autorizador
275cardTypeNuméricoO

Tipo de tarjeta seleccionada al momento de efectuar el pago QR. Valores posibles:

0: Débito
1: Crédito

404

paymentOptionId

AlfanuméricoO

Identificador de la opción de pago seleccionada por el cliente en su billetera virtual. Según la tarjeta, el banco, y las cuotas elegidas por el cliente, se identificará con el paymentOptionId enviado por la caja.

405

benefitCardId

AlfanuméricoOIdentificador de la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente
406originalAmountImporteOMonto original de la transacción: de venta o de devolución.
407

amountDiscounted

ImporteO

Contiene el importe que se descontó sobre el importe original. Debido a la aplicación de una tarjeta de beneficio vinculada en la billetera virtual del cliente. Sólo retorna cuando se aplicó un descuento.

1010currentSessionIdNuméricoMIdentificador de la sesión
1027libResponseCodeNuméricoM

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

1028libResponseMessageAlfanuméricoMMensaje descriptivo del código de respuesta de la librería


Ejemplo:

Response

...

message:

...

{32:0;1:

...

15;2:

...

70486;1027:000;1028:Ok;

...

421:

...

17447444605040;

...

166:

...

15042516142000127841;140:0;12:00;13:$;14:0;272:00;273:4;1010:

...

1744744445373;275:0;24:

...

10;25:

...

20250415161408;26:ISO8583;27:542;28:Esperando medios de pagos del autorizador;31:1}


  • Mensajería POS - VTOL (Flujo recibir bines de Prisma)

A continuación, se define la mensajería de VTOL al POS luego de que VTOL recibe los bines de PRISMA (tarjetas que tiene el cliente en su billetera).

El POS envía a VTOL una QueryWallet genérica para consultar por los medios de pago.


    • Request POS - VTOL:


Informações
titleReferencias

X = Obligatorio
O = Opcional
- = No requerido
C = Condicional

...

Request QueryWallet (log emvkit):

Request:

{269:3;16:

20240613

20250415;268:

0000000001000000000120241113041147

0000000015000007048620251415041408;14:0;12:

5300

140000;11:QueryWallet;6:4905;2:

1

70486;25:

20240613161301

20250415161432;24:

2

10;1:

1;0:1

15}



    • Response VTOL - POS

VTOL responde (isoCode 543 y responseMessage "Enviar medios de pago") con la información de los Providers en el campo 401 "walletPaymentMethod". 

Número

Nombre del campo

Tipo de dato

QueryWallet

Descripción

0companyNuméricoMIdentificador de la compañía donde se generó la transacción
1storeAlfanuméricoMIdentificador del sitio originador de la transacción
2nodeNuméricoMIdentificación del nodo, en el sitio originador, donde se generó la transacción.
12amountImporteM

Contiene el Importe que pagó el cliente, el cual puede variar si pagó con intereses o se aplicó algún descuento. Valor entero. Los últimos 2 dígitos corresponden a los decimales.

13currencyPosCodeAlfanuméricoM

Tipos de moneda: $ = Pesos

14paymentsNuméricoM

Cantidad de cuotas seleccionada al momento de realizar el pago QR.

Nota: este campo deberá tener el valor 1 si el pago se realiza con transferencia 3.0 (pago con saldo en cuota). Si el pago se realiza con tarjeta puede tomar otro valor.

24trxIdNuméricoMIdentificador de la transacción.

25

dateTime

Numérico

M

Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción

26

responseCode

Alfanumérico

M

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

M

Código de Respuesta emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

28

responseMessage

Alfanumérico

M

Mensaje de la respuesta relacionado con el código del campo 27

32

ticket

Numérico

O

Número de Ticket correspondiente a la transacción. 4 dígitos como máximo.

140paymentTypeNuméricoM

Tipo de pago. Valores posibles:

0: Tarjeta
1: Efectivo

166trxReferenceNumberNuméricoMIdentificador ú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

271

walletPaymentId

Alfanumérico

MIdentificador del número de pago informado por el Autorizador
272amountRefundedImporteMMonto devuelto en la transacción
273paymentStatusAlfanuméricoO

Estado de la transacción de pago informado por el Autorizador. Estados posibles:

0: Aprobado
1: Devuelto
2: Pendiente
3: Autorizado
4: En Progreso
6: Rechazado
7: Cancelado
8: Contracargo

274paymentStatusDetailAlfanuméricoODetalle del estado de la transacción de pago informado por el Autorizador
275cardTypeNuméricoO

Tipo de tarjeta seleccionada al momento de efectuar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago. Valores posibles:

0: Débito
1: Crédito

401

walletPaymentMethod

Formato Json codificado en Base 64O

Información de los bines de la tarjeta que tiene el cliente en su app bancaria, en formato Json codificado en Base 64. Ver ejemplo de la respuesta más abajo.

El valor del campo se encuentra codificado en Base 64.

402

walletBenefit

Formato JsonO

Información de las tarjetas de beneficio aceptadas.

404

paymentOptionId

AlfanuméricoO

Identificador de la opción de pago seleccionada por el cliente en su billetera virtual. Según la tarjeta, el banco, y las cuotas elegidas por el cliente, se identificará con el paymentOptionId enviado por la caja.

405

benefitCardId

AlfanuméricoOIdentificador de la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente
406originalAmountImporteMMonto original de la transacción: de venta o de devolución.
407

amountDiscounted

ImporteO

Contiene el importe que se descontó sobre el importe original. Debido a la aplicación de una tarjeta de beneficio vinculada en la billetera virtual del cliente. Sólo retorna cuando se aplicó un descuento.

1010currentSessionIdNuméricoMIdentificador de la sesión
1027libResponseCodeNuméricoM

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

1028libResponseMessageAlfanuméricoMMensaje descriptivo del código de respuesta de la librería

...

Ejemplo Response QueryWallet (log emvkit):

Response message:

{32:0;

0:

1

;1

:

1

15;2:

1

70486;1027:000;1028:Ok;421:17447444605040;140:0;12:

5300

140000;13:$;14:0;272:00;273:4;401:W3sicG9zQ29kZSI6IkFNUyIsImJhbmtfaWQiOjcyLCJiaW4iOjM3MTU5NX1d;402:

W3sicG9zQ29kZSI6IlZJIiwiYmFua19pZCI6NywiYmluIjo0NTkzNTR9XQ==

W10=;1010:1744744445373;275:0;406:

5300

140000;24:

2

10;25:

20240613161301

20250415161432;26:ISO8583;27:543;28:Enviar medios de pagos;31:1}




  • Mensajería POS - VTOL para la transacción "QueryWallet" Intención de compra completa

...

Número

Nombre del campo

Tipo de dato

QueryWallet

Descripción

0companyNuméricoM

Identificador de la compañía donde se generó la transacción. Exclusivo para mensajería POS-VTOL.

1storeAlfanuméricoM

Identificador del local donde se generó la transacción. Exclusivo para mensajería POS-VTOL.

2nodeNuméricoM

Identificador de la caja donde se generó la transacción. Exclusivo para mensajería POS-VTOL.

3serverAlfanuméricoM

Identificador del Server que procesará la transacción, en el caso de VTOL será "VTOL". Exclusivo para mensajería POS-VTOL.

4messageTypeAlfanuméricoM

Indica el 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.

Exclusivo para mensajería POS-VTOL.

11trxTypeAlfanuméricoM

Indica el tipo de transacción:

  • QueryWallet.
12amountNuméricoOMonto de la transacción. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales. Ejemplo: "1000" equivale a "10.00".
13currencyPosCodeAlfanuméricoO

Tipos de moneda: $ = Pesos

16originalDateNuméricoMFecha de realización de la compra con billetera electrónica en formato YYYYMMDD
24

lastTrxId

NuméricoOEn este campo el POS debe enviar la última transacción procesada correctamente. Se utiliza si está activo el control transaccional.
25dateTimeNuméricoMFecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
71checkPendingStringAlfanuméricoO

Indica si VTOL debe o no efectuar el chequeo de pendientes (se emplea para pagos parciales de tarjetas):

  • True: activa chequeo de pendientes.
  • False: desactiva chequeo de pendientes.
268walletPosTrxIdAlfanuméricoM

Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra con billetera.

Formato:
codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12)
Longitud total de 32.

Opcional en QuerySaleWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra.

269walletTypeNuméricoM

Tipo de billetera por la cual se realizará la transacción en el POS. La opción corresponde a 3: MODO. 

271walletPaymentIdAlfanuméricoO

Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet.

Opcional en QuerySaleWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra.

401

walletPaymentMethod

Formato JsonM

Información de los planes de pago en formato Json codificado en Base 64. La estructura de este campo está definida en la siguiente sección del documento.

Importante: en este campo VTOL envía el valor de los providers que tiene el cliente en su billetera.

402

walletBenefit

Formato JsonOInformación de las tarjetas de beneficio aceptadas.

...

Ejemplo Request QueryWallet (log emvkit):

Request: 


{269:3;16:

20240611

20250415;268:

0000000001000000000120244511014545

0000000015000007048620251415041408;12:

5300

140000;11:QueryWallet;

402

401:[
    {
        "

benefitCardId"\: "01"\, "providerPosCode"\: "CLN"\, "discountPercentage"\: "2500"\, "maximumDiscountAmount"\: "000"}\,
{"benefitCardId"\: "02"\, "providerPosCode"\: "CC"\, "discountPercentage"\: "1000"\, "maximumDiscountAmount"\: "000"}]
;401:[
    {
        "benefitsCardsAccepted"\: [
            "CC"\,
            "CP"
        ]\,
        "installments"\: [
            {
                "amountPerInstallment"\: 15000\,
                "nominalAnnualRate"\: "090"\,
                "paymentOptionId"\: "1"\,
                "quantity"\: "1"\,
                "surcharge"\: 110\,
                "totalAmount"\: 15000
            }\,
            {
                "amountPerInstallment"\: 20000\,
                "nominalAnnualRate"\: "095"\,
                "paymentOptionId"\: "2"\,
                "quantity"\: "2"\,
                "surcharge"\: 115\,
                "totalAmount"\: 20000
            }\,
            {
                "amountPerInstallment"\: 25000\,
                "nominalAnnualRate"\: "099"\,
                "paymentOptionId"\: "3"\,
                "quantity"\: "3"\,
                "surcharge"\: 120\,
                "totalAmount"\: 25000
            }
        ]\,
        "providerPosCode"\: "VI"
    }\,
    {
        "installments"\: [
            {
                "amountPerInstallment"\: 15000\,
                "nominalAnnualRate"\: "090"\,
                "paymentOptionId"\: "1"\,
                "quantity"\: "1"\,
                "surcharge"\: 110\,
                "totalAmount"\: 15000
            }\,
            {
                "amountPerInstallment"\: 20000\,
                "nominalAnnualRate"\: "090"\,
                "paymentOptionId"\: "3"\,
                "quantity"\: "3"\,
                "surcharge"\: 110\,
                "totalAmount"\: 20000
            }\,
            {
                "amountPerInstallment"\: 25000\,
                "nominalAnnualRate"\: "099"\,
                "paymentOptionId"\: "6"\,
                "quantity"\: "6"\,
                "surcharge"\: 210\,
                "totalAmount"\: 250000
            }
        ]\,
        "providerPosCode"\: "VIG"
    }\,

installments"\: [
            {
       

"installments"\: [

       

    {
               

"amountPerInstallment"\:

1500

140000\,
                "nominalAnnualRate"\: 0\,
                "quantity"\: "1"\,
                "surcharge"\: 0\,
                "totalAmount"\:

1500

140000
            }
        ]\,
        "providerPosCode"\: "

TR

AM"
    }
]
;6:4905;2:

1

70486;25:

20240611134653

20250415161446;24:

13

10;1:

1

15}



    • Response VTOL - POS:

Número

Nombre del campo

Tipo de dato

QueryWallet

Descripción

0companyNuméricoMIdentificador de la compañía donde se generó la transacción
1storeAlfanuméricoMIdentificador del sitio originador de la transacción
2nodeNuméricoMIdentificación del nodo, en el sitio originador, donde se generó la transacción.
6cardNumber AlfanuméricoO

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

Importante: este campo no se envía si el pago se realiza con Transferencias 3.0, pero en caso de pagos con tarjetas si es obligatorio.

12amountImporteM

Contiene el Importe que pagó el cliente, el cual puede variar si pagó con intereses o se aplicó algún descuento. Valor entero. Los últimos 2 dígitos corresponden a los decimales.

13currencyPosCodeAlfanuméricoM

Tipos de moneda: $ = Pesos

14paymentsNuméricoM

Cantidad de cuotas seleccionada al momento de realizar el pago QR.

Importante: este campo deberá tener el valor 1 si el pago se realiza con transferencia 3.0 (pago con saldo en cuota). Si el pago se realiza con tarjeta puede tomar otro valor.

15

plan NuméricoM

Plan de pago. Campo de 1 carácter de longitud.

Nota: si el pago se realiza por Transferencias, el campo toma el valor de 0.

22authorizationCodeAlfanuméricoM

Código de autorización informado por el Autorizador

24trxIdNuméricoMIdentificador de la transacción.
25

dateTime

Numérico

M

Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción

26

responseCode

Alfanumérico

M

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

M

Código de Respuesta emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

28

responseMessage

Alfanumérico

M

Mensaje de la respuesta relacionado con el código del campo 27

29

serialNumber

Numérico

O

Número identificatorio de la terminal en la que se procesó la transacción. Retorna en operaciones aprobadas.

30

bussinesNumber

Numérico

M

Número de comercio en el que se procesó la transacción.

31

lotNumber

Numérico

O

Número de lote en el que se registró la transacción

32

ticket

Numérico

O

Número de Ticket correspondiente a la transacción. 4 dígitos como máximo.

81responseAuthAlfanuméricoOMensaje de repuesta para imprimir en el ticket del POS. Retorna en operaciones aprobadas. Contiene información generada por el Autorizador.
140paymentTypeNumérico-

Tipo de pago. Valores posibles:

0: Tarjeta
1: Efectivo

142providerNameAlfanumérico-

Proveedor de la tarjeta seleccionada al momento de efectuar el pago QR.

147providerPosCodeAlfanuméricoO

Código del Provider. Retornará cuando la transacción fue aprobada por el Autorizador. 

Nota: si el pago se realiza con Transferencias 3.0 el código es "TR"

157customerDocNuméricoONumero de documento del titular de la tarjeta.
303customerNameAlfanuméricoONombre del titular de la tarjeta.

271

walletPaymentId

Alfanumérico

MIdentificador del número de pago informado por el Autorizador
272amountRefundedImporte-Monto devuelto en la transacción
273paymentStatusAlfanumérico-

Estado de la transacción de pago informado por el Autorizador. Estados posibles:

0: Aprobado
1: Devuelto
2: Pendiente
3: Autorizado
4: En Progreso
6: Rechazado
7: Cancelado
8: Contracargo

274paymentStatusDetailAlfanumérico-Detalle del estado de la transacción de pago informado por el Autorizador
275cardTypeNumérico-

Tipo de tarjeta seleccionada al momento de efectuar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago. Valores posibles:

0: Débito
1: Crédito

306cardIssuingBankAlfanuméricoOBanco emisor de la tarjeta. Retornará cuando la transacción fue aprobada por el Autorizador.
404

paymentOptionId

AlfanuméricoM

Identificador de la opción de pago seleccionada por el cliente en su billetera virtual. Según la tarjeta, el banco, y las cuotas elegidas por el cliente, se identificará con el paymentOptionId enviado por la caja.

405

benefitCardId

AlfanuméricoOIdentificador de la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente
406originalAmountImporteMMonto original de la transacción: de venta o de devolución.
407

amountDiscounted

ImporteO

Contiene el importe que se descontó sobre el importe original. Debido a la aplicación de una tarjeta de beneficio vinculada en la billetera virtual del cliente. Sólo retorna cuando se aplicó un descuento.

421

walletOrderId

AlfanuméricoO

Campo que retorna desde Payway asociado al intention_id.

422

walletTransactionId

AlfanuméricoO

Campo que retorna desde Payway asociado al transaction_id.

1010currentSessionIdNuméricoMIdentificador de la sesión
1027libResponseCodeNuméricoM

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

1028libResponseMessageAlfanuméricoMMensaje descriptivo del código de respuesta de la librería

...

Ejemplo Response QueryWallet (log emvkit):

Response message:

{1:

1

15;2:

1

70486;1027:000;1028:Ok;6:450799...4851;140:

1

0;12:

5300

140000;13:$;14:1;142:

Transferencias 3.0

Visa;271:

13470283

16151206;

15:0;

272:00;273:0;81:COMPRA QR;274:approved;275:

0

1;

147:TR;

406:

5300

140000;22:184603;407:1000;24:

13

10;25:

20240611134653

20250415161508;26:ISO8583;27:00;28:APROBADA

;30:333

;31:1;32:

4

2;421:17447444605040;306:1;1010:

1718124338807

1744744445373}



Flujo de la Devolución forzada (RefundWallet)

...