...
Fecha | Revisión | Cambios |
|---|---|---|
02/11/2009 | 1.0 | Generación del documento |
04/11/2009 | 1.1 | Indicación de campos obligatorios |
26/04/2010 | 1.2 | Actualización de gráfico manejo de PINPAD |
22/03/2011 | 1.3 | Incorporación mensajes MembershipQuery y VoidMembershipQuery para consulta membresía Club Personal y Club La Nación |
03/06/2011 | 1.4 | Agregado de definición de mensaje de cierre de lote |
30/05/2012 | 1.5 | Agrego Tabla de Respuestas al POS y mejoro explicación de Tercer Mensaje y Chequeo de Pendientes. |
08/03/2013 | 1.6 | Agrego nuevos campos relacionados con operador y vendedor en operaciones de pre-autorización, venta, devolución y anulación. |
21/08/2013 | 1.7 | Agregado de apartado de error del core. |
09/09/2013 | 1.8 | Agrego campos EMV en operaciones de Venta, Devolución y anulación. Incorporo mensaje RejectedEMVAdvice y flujo de datos EMV. |
15/11/2013 | 1.9 | Agregado de 'Formato Interface POS' |
23/12/2013 | 2.0 | Agregado de detalle de los mensajes ServicePayment y VoidServicePayment |
13/02/2014 | 2.1 | Agregado del campo bandera '164 – posEncryptedFields', que indica cuando los datos sensibles viajan encriptados. |
29/05/2014 | 2.2 | Aclaración sobre el uso de pre-autorizaciones. |
22/08/2014 | 2.3 | Agregado de campo pinpadAutoCode en Tercer Mensaje y RejectedEMVAdvice. |
29/08/2014 | 2.4 | Actualización del Formato Interface POS, agregando el campo 'Tarjeta que Encripta' a los prefijos. |
11/09/2014 | 2.5 | Incorporación de Bines de Excepción y nuevo mensaje CardInfoService. |
09/12/2014 | 2.6 | Agregado de mensaje de Anulación de Pre Autorización. |
26/02/2015 | 2.7 | Agregado de nuevos campos ServiceCode y ProviderPosCode. |
27/02/2015 | 2.8 | Agregado de nuevos mensajes propios a la funcionalidad Cash Back. |
07/08/2015 | 2.9 | Agregado de aclaraciones en el uso de la mensajería |
09/09/2015 | 3.0 | Incorporación de campo PinpadApplicationVersion en los mensajes Sale, VoidSale, Refund y VoidRefund |
30/10/2015 | 3.1 | El campo ProviderPosCode para a ser el número 147. Incorporación de campo trxReferenceNumber en las respuestas de VTOL. Corrección de formato esperado en campo 7 - Expiration. El formato correcto es: YYMM. |
11/02/2016 | 3.2 | Incorporación del campo 201 additionalMessageData en el requerimiento y respuesta y la posibilidad de incluir el número de Ticket original en una anulación (Campo 17 originalTrxTicketNr) |
29/07/2016 | 3.3 | Incorporación del apartado 1.9. Mecanismo en Tiendas Virtuales y del 1.3.13. Chequeo de Listado de Pendientes |
19/04/2017 | 3.4 | Actualización de la tabla Prefijo en el apartado Formato Interface POS |
03/05/2017 | 3.5 | Incorporación del apartado 1.3.10 Echo |
05/05/2017 | 3.6 | Incorporación del apartado 1.3.9 SynQuery y de la sección 1.7 Formato Datos Sincronización |
06/06/2017 | 3.7 | 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 | 3.8 | Agregado del campo promocional en Formato Interface POS para indicar que se aplica una promoción sobre un plan de pago |
| 04/09/2018 | 3.9 | Incorporación de la funcionalidad PEI en la mensajería |
14/12/2018 | 4.0 | Incorporación del apartado Antifraude e incorporación de la funcionalidad Antifraude en la mensajería |
| 08/02/2019 | 4.1 | Incorporación del apartado Tokenización e incorporación de la funcionalidad Tokenización en la mensajería |
| 03/04/2019 | 4.2 | Agregado del campo 0 (Compañía) en la mensajería de todos los tipos de transacciones. |
| 28/08/2019 | 4.3 | Incorporación de la funcionalidad Billeteras electrónicas en la mensajería. |
| 01/04/2020 | 4.4 | Incorporación de mensajería para operaciones eCommerce. |
| 22/06/2020 | 4.5 | Incorporación de mensajería para operaciones de Cuenta DNI. |
| 30/07/2020 | 4.6 | Incorporación de funcionalidad de Billeteras Mercado Pago con retiro de efectivo. |
| 28/08/2020 | 4.7 | Incorporación de consideraciones en el Formato de Interface POS en la tabla Plan de Pagos, para tiendas presenciales. |
| 22/09/2020 | 4.8 | Se actualiza el campo 54 (additionalAmount) como tipo de dato Importe, en la mensajería de Billeteras electrónicas. |
| 21/10/2020 | 4.9 | Incorporación de funcionalidad PEI No Presencial |
| 26/11/2020 | 4.10 | Agregado del campo Descripción en Formato de Interface POS para indicar la descripción sobre un plan de pago. |
| 11/12/2020 | 4.11 | Incorporación de funcionalidad de QR Adquiriente. |
| 16/12/2020 | 4.12 | Incorporación del campo afApplicationCondition para validar la aplicación de reglas antifraudes por el módulo AF de VTOL. |
| 05/03/2021 | 4.13 | Se actualiza el nombre y la descripción del campo 406 en la respuesta de la mensajería de QR Adquiriente. |
| 05/05/2021 | 4.14 | Incorporación de mensajería para Consultar tarjetas de Fidelidad |
| 11/05/2021 | 4.15 | Se quitan las referencias de la billetera Todo Pago, ya que dicha Billetera está incluida dentro de QR Adquiriente Prisma. |
| 19/05/2021 | 4.16 | Incorporación de mensajería para Billetera Yacaré. Se incluye dentro del apartado "1.4.18 Billeteras electrónicas" |
Índice
Índice
Âncora _Toc485222713 _Toc485222713
1. Campos de los mensajes
| _Toc485222713 | |
| _Toc485222713 |
...
VTOL se integra con las siguientes billeteras electrónicas para permitir efectuar pagos en los puntos de venta:
- Mercado Pago: La plataforma de pagos online más importante de América Latina
- Yacaré
Las operaciones soportadas en VTOL Server para Billeteras electrónicas son:
- SaleWallet = Permite realizar una compra presencial con billetera
- SaleWallet con cashback = Permite realizar una compra presencial y realizar retiro de efectivo. Sólo para billetera Mercado Pago.
- RefundWallet = Permite realizar una devolución (parcial o total) de una compra presencial con billetera realizada con anterioridad
- QuerySaleWallet QueryWallet = Permite realizar una consulta de una operación de compra venta o devolución con billetera, para conocer si la misma fue autorizada y así obtener los datos de la misma por parte del Autorizador.
...
Procedimiento para Mercado Pago y Yacaré
El proceso de pagos con billetera virtual se realizará de la siguiente manera:
- Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
- Recién en ese momento el comprador podrá efectuar la lectura del código QR impreso en la caja mediante su smartphone.
- Mercado PagoLa billetera, con la información de la orden de venta recibida por VTOL, le comunicará a la app de la billetera virtual el importe total y el detalle de los artículos adquiridos.
- El comprador visualizará en su app mobile el detalle de la compra, y efectuará el pago seleccionado el medio de pago (tarjeta, o saldo de Mercado Pago), la tarjeta enrolada (o incorporando una nueva), las cuotas y confirmando el pago.
- El POS recibirá la respuesta de la transacción SaleWallet a través de VTOL, quien informará si la operación resultó autorizada resultó aprobada por Mercado Pagoel Autorizador.
- Puede darse el caso que VTOL responda "Consulte el pago por tiempo expiradoTiempo expirado. Elija Consultar o Cancelar pago". Este escenario puede surgir cuando el cliente demora en confirmar el pago desde su app mobile, y expira el tiempo designado por defecto en VTOL, entonces al POS se le da una respuesta automática por timeout. Para conocer el resultado de la operación, el POS deberá realizar una consulta (transacción QuerySaleWallet QueryWallet). Las respuestas del QuerySaleWallet QueryWallet pueden ser las siguientes:
- VTOL responde "Aprobado". Indica que el pago fue autorizado por Mercado Pago. El paso siguiente del POS es confirmar o cancelar la transacción, con un tercer mensajeTercer Mensaje.
- VTOL responde "Pago Rechazado, desea seguir esperando?". Indica que el cliente intentó pagar pero Mercado Pago rechazó y el pago se rechazó, pero a su vez el cliente puede volver a intentar realizar el pago con otra tarjeta u otro medio de pago, por lo cual el POS puede "seguir esperando" para permitirle al cliente intentar pagar nuevamente, y luego el POS deberá enviar un nuevo QuerySaleWalletQueryWallet, o directamente cancelar la operación.
- Puede darse el caso que VTOL responda "Consulte el pago por tiempo expiradoTiempo expirado. Elija Consultar o Cancelar pago". Este escenario puede surgir cuando el cliente demora en confirmar el pago desde su app mobile, y expira el tiempo designado por defecto en VTOL, entonces al POS se le da una respuesta automática por timeout. Para conocer el resultado de la operación, el POS deberá realizar una consulta (transacción QuerySaleWallet QueryWallet). Las respuestas del QuerySaleWallet QueryWallet pueden ser las siguientes:
- Por último, el POS deberá confirmar la operación, mediante el tercer mensaje (transacción UnsyncCompletion).
Para obtener de forma completa todo el detalle de la transacción, posterior venta, el POS deberá enviar de forma automática la transacción QuerySaleWalletQueryWallet.
La anulación, no precisa de interacción por parte del comprador en la caja. Simplemente el POS envía el identificador del número de pago del Autorizador en el mensaje RefundWallet.
...
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
Número | Nombre del campo | Tipo de dato | SaleWallet | RefundWallet |
|---|
| QueryWallet | Descripción | |||||
|---|---|---|---|---|---|---|
| 0 | company | Numérico | X | X | X | Identificador de la compañía donde se generó la transacció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:
|
11 | trxType | Alfanumérico | X | X | X | Tipo de Transacción:
|
| ||||||
12 | amount | Importe | X | X | - | Monto de la transacción. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales. Ej: 1000 equivale a 10.00 Nota: El importe debe ser el número correspondiente a la moneda informada |
13 | currencyPosCode | Alfanumérico | X | X | - | Tipos de moneda:
Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-) Importante: Tener en cuenta que operando con Mercado Pago siempre debe coincidir el país de la cuenta vendedor con el país de la cuenta comprador |
| 14 | payments | Numérico | - | - | O | Cantidad de cuotas por las cuales se realizará el pago. 2 dígitos como máximo Si es sin cuotas, el valor por defecto es 1 |
| 15 | plan | Alfanumérico | - | - | O | Plan. 1 caracter de longitud |
| 16 | originalDate | Numérico | - | X | X | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
| 22 | authorizationCode | Alfanumérico | - | C | - | Código de autorización. Exclusivo para billetera Yacaré. Campo Condicional. Si la Compañía tiene configurado "Requiere código de autorización" entonces es obligatorio. |
| 24 | lastTrxId | Numérico | O | O | O | Utilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente. |
25 | dateTime | Numérico | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
| 53 | paymentCondition | Alfanumérico | - | - | O | Condición de pago. Sólo se encuentra presente si existe una condición de pago vinculada con la transacción |
| 54 | additionalAmount | Importe | O | O | - | Contiene el Importe del "Cashout". 12 dígitos como máximo. Valor entero. Los últimos 2 dígitos corresponden a los decimales. Para devoluciones, se debe enviar el monto total del cashout. Para devolver sólo el cashout, se debe enviar el campo 12 (amount) con valor 0. Sólo disponible para billetera de Mercado Pago. |
| 71 | checkPendingString | Alfanumérico | O Default = true | O Default = true | O Default = true | Indica si VTOL debe o no efectuar el chequeo de pendientes (se emplea para pagos parciales de tarjetas):
|
| 268 | walletPosTrxId | Alfanumérico | X |
| X | O | 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 | X | X | X | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago 3: Yacaré |
| 270 | posTicket | Base 64 | X | - | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura del campo posTicket |
| 271 | walletPaymentId | Alfanumérico | - | X | O | Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet Opcional en |
QueryWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra | ||||||
| 311 | purchaseTitle | Alfanumérico | O | - | - | Título de la venta. Longitud máxima 100. Si el POS no lo envía, VTOL tomará un valor por defecto. El siguiente label: "Pago con |
Billetera virtual en" + "CompanyName". | ||||||
| 312 | purchaseDesc | Alfanumérico | O | - | - | Descripción de la venta. Longitud máxima 100. Si el POS no lo envía, VTOL tomará un valor por defecto. El siguiente label: "Pago realizado con QR. Por un monto de $amount. Y retiro de efectivo de $additionalAmount.". |
Ejemplo
Request to VTOL (SaleWallet): Request: {270:PG1lc3NhZ2U+CiAgICAgICA8aXRlbS1hZGQgc2VxPSIxIiBjb2RlPSIwMDAxIiBkaXNjb3VudGFibGU9InRydWUiIHVuaXRwcmljZT0iMjUuMCIgcXR5PSIxLjAiIGxldmVsMT0iTUVOIiBsZXZlbDI9IkNBU1VBTCIgc3VwcGxpZXI9IiIgYnJhbmQ9IkxFVklTIiB4cHJpY2U9IjI1LjAiIG1hZ25pdHVkZT0iMS4wIiBkZXNjcmlwdGlvbj0iSmVhbiBjYXN1YWwiIGN1cnJlbmN5PSIkIiAvPgogICAgICAgPGl0ZW0tYWRkIHNlcT0iMiIgY29kZT0iMDAwMiIgZGlzY291bnRhYmxlPSJ0cnVlIiB1bml0cHJpY2U9IjI4LjAiIHF0eT0iMi4wIiBsZXZlbDE9Ik1FTiIgbGV2ZWwyPSJDQVNVQUwiIHN1cHBsaWVyPSIiIGJyYW5kPSJMRVZJUyIgeHByaWNlPSI0OC4wIiBtYWduaXR1ZGU9IjEuMCIgZGVzY3JpcHRpb249IkplYW4gY2FzdWFsIiBjdXJyZW5jeT0iJCIgLz4KPC9tZXNzYWdlPg==;269:1;268:1120181116055713;13:$;12:1200;11:SaleWallet;4:DATA;3:VTOL;2:1;25:20181116055713;71:True;1:1;54:50000} Request to VTOL (RefundWallet): Request: {271:4379999999999999437;269:1;16:20181116;13:$;12:1200;11:RefundWallet;4:DATA;3:VTOL;2:1;25:20181116105619;71:True;1:1;268:00000000110000000001210519154938} Request to VTOL (QuerySaleWalletQueryWallet): Request: {271:2289999999999999228;269:1;16:20190214;268:11020190514050534;25:20190214050534;11:QuerySaleWalletQueryWallet} |
Estructura del campo posTicketÂncora _campoPosTicket _campoPosTicket
...
| Aviso | ||
|---|---|---|
| ||
Esta estructura generada debe transformarse al formato Base 64 para informárselo a VTOL en el campo 270 posTicket. |
1.4.18.2 Respuesta
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
Número | Nombre del campo | Tipo de dato | SaleWallet | RefundWallet | QuerySaleWalletQueryWallet | Descripción |
|---|---|---|---|---|---|---|
| 0 | company | Numérico | X | X | X | Identificador de la compañía donde se generó la transacció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 |
| 6 | cardNumber | Alfanumérico | O | - | O | Tarjeta enmascarada 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 |
| 12 | amount | Importe | X | - | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
| 13 | currencyPosCode | Alfanumérico- | O | - | X | Tipos de moneda:
|
| 14 | payments | Numérico | - | - | O | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago |
| 22 | authorizationCode | AlfanuméricoX | O | - | XO | Código de autorización informado por el Autorizador. Para Mercado Pago sólo retorna cuando el cliente paga con tarjeta de crédito o débito. Para Yacaré, este campo no retorna. |
| 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. 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 | 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. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas |
| 28 | responseMessage | Alfanumérico | X | X | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
| 54 | additionalAmount | Importe | O | O | O | Contiene el Importe del "Cashout". Para aquellas operaciones realizadas con retiro de efectivo. Valor entero. Los últimos 2 dígitos corresponden a los decimales. Sólo disponible para billetera de Mercado Pago. |
| 140 | paymentType | Numérico | - | - | X | Tipo de pago. Valores posibles: 0: Tarjeta |
| 142 | providerName | Alfanumérico | - | - | O | Proveedor de la 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 |
| 147 | providerPosCode | Lista | O | - | - | Lista de proveedores/tarjetas que coinciden con la tarjeta ingresada en la app de la billetera electrónica. Ejemplo: {VI, EL}. Esta lista deberá ser utilizada para seleccionar la tarjeta manualmente por el POS. |
| 157 | customerDoc | Numérico | O | O | O | Numero de documento del titular de la tarjeta. |
| 303 | customerName | Alfanumérico | O | O | O | Nombre del titular de la tarjeta. |
| 166 | trxReferenceNumber | Numérico | X | 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 |
| 271 | walletPaymentId | Alfanumérico | X | - | X | Identificador del número de pago informado por el Autorizador |
| 272 | amountRefunded | Importe | - | - | X | Monto devuelto en la transacción |
| 273 | paymentStatus | Alfanumérico | -O | - | XO | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado |
| 274 | paymentStatusDetail | Alfanumérico | -O | - | XO | Detalle del estado de la transacción de pago informado por el Autorizador |
| 275 | cardType | Numérico | - | - | O | 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 |
...
Response from VTOL (SaleWallet): Response message: {1:1;2:1;166:14021905052200000204;271:2289999999999999228;22:1234567;24:121;25:20190214050518;26:ISO8583;27:00;28:APROBADA} Response from VTOL (RefundWallet): Response message: {1:1;2:1;25:20190214050543;26:ISO8583;27:509;28:Estado trx original no acepta devolucion} Response from VTOL (QuerySaleWalletQueryWallet): Response message: {1:1;2:1;6:450995xxxxxx3704;140:0;12:53.0;13:$;14:1;142:visa;271:2289999999999999228;272:0.0;273:0;274:accredited;275:1;22:1234567;24:121;25:20190214050534;26:ISO8583;27:00;28:APROBADA} |
...
Número | Nombre del campo | Tipo de dato | SaleWallet | RefundWallet | QueryWallet | Descripción |
|---|---|---|---|---|---|---|
| 0 | company | Numérico | X | X | X | Identificador de la compañía donde se generó la transacción. |
| 1 | store | Alfanumérico | X | X | X | Identificador del local donde se generó la transacción. |
| 2 | node | Numérico | X | X | X | Identificador de la caja 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:
|
| 11 | trxType | Alfanumérico | X | X | X | Tipo de Transacción:
|
| 12 | amount | Numérico | X | X | - | Monto de la transacción. 12 dígitos como máximo. Valor entero. Los dos últimos dígitos representan los decimales. Ej: "1000" equivale a "10.00". Para devoluciones, se debe enviar el monto total de la venta original, ya que no están permitidas las devoluciones totalesparciales. |
| 13 | currencyPosCode | Alfanumérico | X | X | - | Tipos de moneda:
|
| 16 | originalDate | Numérico | - | X | X | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
| 24 | lastTrxId | Numérico | O | O | O | Utilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente. |
| 25 | dateTime | Numérico | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
| 268 | walletPosTrxId | Alfanumérico | X | X | O | Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra 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 | X | X | X | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 2: QR Adquiriente |
| 270 | posTicket | Alfanumérico | X | - | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura del campo posTicket |
| 271 | walletPaymentId | Alfanumérico | - | X | O | Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet. Opcional en QueryWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra. |
| 401 | paymentMethodsData | Json | X | - | - | Información de los planes de pago, en formato json |
| 402 | walletBenefits | Json | X | - | - | Información de las tarjetas de beneficio, en formato json |
...
Número | Nombre del campo | Tipo de dato | SaleWallet | RefundWallet | QueryWallet | Descripción |
|---|---|---|---|---|---|---|
| 0 | company | Numérico | X | X | X | Identificador de la compañía donde se generó la transacció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. |
| 6 | cardNumber | Alfanumérico | X | - | O | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR. |
| 12 | amount | Importe | X | - | X | 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. |
| 13 | currencyPosCode | Alfanumérico | X | - | X | Tipos de moneda:
|
| 14 | payments | Numérico | X | - | O | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. |
| 22 | authorizationCode | Alfanumérico | X | - | X | Código de autorización informado por el Autorizador |
| 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. 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 | 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. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas |
| 28 | responseMessage | Alfanumérico | X | X | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
29 | serialNumber | Numérico | O | O | O | Número identificatorio de la terminal en la que se procesó la transacción. Retorna en operaciones aprobadas. |
30 | businessNumber | Numérico | O | O | O | Número de comercio en el que se procesó la transacción. Retorna en operaciones aprobadas. |
| 81 | responseAuth | Alfanumérico | O | O | O | Mensaje de repuesta para imprimir en el ticket del POS. Retorna en operaciones aprobadas. Contiene información generada por el Autorizador. |
| 140 | paymentType | Numérico | - | - | X | Tipo de pago. Valores posibles: 0: Tarjeta |
| 142 | providerName | Alfanumérico | - | - | O | Proveedor de la tarjeta seleccionada al momento de efectuar el pago QR. |
| 147 | providerPosCode | Alfanumérico | O | - | O | Código del Provider. Retornará cuando la transacción fue aprobada por el Autorizador. |
| 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 |
| 271 | walletPaymentId | Alfanumérico | X | - | X | Identificador del número de pago informado por el Autorizador |
| 272 | amountRefunded | Importe | - | - | X | Monto devuelto en la transacción |
| 273 | paymentStatus | Alfanumérico | - | - | XO | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado |
| 306 | cardIssuingBank | Alfanumérico | O | - | O | Banco emisor de la tarjeta. Retornará cuando la transacción fue aprobada por el Autorizador. |
| 404 | paymentOptionId | Alfanumérico | X | - | O | 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 vinculará con el paymentOptionId enviado por la caja en el requerimiento. |
| 405 | benefitCardId | Alfanumérico | X | - | O | Identificador de la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente. |
| 406 | originalAmount | Importe | X | - | O | Monto original de la transacción: de venta o de devolución. |
| 407 | amountDiscounted | Importe | X | - | O | 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. |
...
| 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 |
| 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 | Devuelto |
| 540 | Pendiente |
| 541 | Autorizado |
| 542 | En Progreso |
| 543 | En mediacion |
| 544Rechazado | 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 |
| 584No existe la compra que se desea anular | Devolucion parcial no soportada |
| 585El | originante no es válido 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 |
| 650 | Importe de devolución de cashout invalido |
| 651 | Importe de cashout invalido |
| 652 | Medio de pago inválido |
| 733 | La transacción no corresponde a una operación de Billeteras Electrónicas |
| 734 | No es posible cancelar la transacción informada |
...